legacy-svn-scala

Go to file

mcdirmid 9607f607e0 Getting rid of some unused Java files in scala/tools/util because they now have scala equivalents in scala/tools/nsc/util. git-svn-id: http://lampsvn.epfl.ch/svn-repos/scala/scala/trunk@5497 5e8d7ff9-d8ef-0310-90f0-a4852d11357a		2006-01-11 11:02:36 +00:00
docs	Removed old Scalac code in sources and various other obsolete elements.	2005-12-18 18:33:03 +00:00
src	Getting rid of some unused Java files in scala/tools/util because they now have scala equivalents in scala/tools/nsc/util.	2006-01-11 11:02:36 +00:00
test	Scalanstest updated to use new scala2 names for executables	2006-01-09 17:42:34 +00:00
README	Switching to the new build system and to the new build system. This is a MAJOR commit, so be careful when updating.	2005-12-19 13:49:03 +00:00
build.xml	The Scalac Ant task now supports a 'addparams' parameter for passing custom parameters to the compiler. Build script updated to use it too: set nsc.params to add custom parameters.	2006-01-09 18:28:11 +00:00

README

================================================================================
                              THE SCALA REPOSITRY
                           Structure and build system
================================================================================

Part I. The repository layout
--------------------------------------------------------------------------------                            

Follows the file layout of the Scala repository. Files marked with a † are not
part of the Subversion repository but are either automatically generated by the
build script or user-created if needed.

scala/
      build/ †                Temporary staging area for build products.
      build.excludes †        An optional build configuration file.
      build.properties †      An optional build configuration file.
      build.xml               The main Ant build script.
      dist/ †                 The destination folder of Scala distributions.
      docs/                   Documentation of Scala. More in its own module.
           development/       Developer documentation.
           examples/          Scala example files.
           man/               UNIX manual files.
      lib/                    Pre-compiled libraries for the build.
          fjbg.jar            The Java byte-code generation library.
          jaco.jar            The JaCo Java compiler.
          msil.jar            The CLR byte-code generation library.
          scala-compiler.jar  The last stable version of the Scala compiler.
          scala-library.jar   The last stable version of the Scala library.
          scala.dll           The Scala library for Windows.
      README                  The file you are currently reading.
      sandbox/ †              A folder to test code etc.
      src/                    All the source files of Scala.
          compiler/           The sources of the Scala compiler.
          exec/               The sources of the executable wrapper-scripts.
          library/            The sources of the Scala library.
      test/                   The Scala test suite.

Any change to this structure requires a modification of the 'build.xml' file.



Part II. Building Scala
--------------------------------------------------------------------------------

The Scala build system is based on Apache Ant. Most required pre-compiled libraries are part of the repository (in 'lib/'). The following however is assumed to be installed on the build machine:
  - A Java SDK 1.4 or above (1.5 not supported).
  - Apache Ant version 1.6.2 or above.

More to come ...

Part III. Creating distributions
--------------------------------------------------------------------------------

More to come ...

Part IV. Contributing to Scala
--------------------------------------------------------------------------------                            

More to come ...