updated contents of file docs/README in module 'scala'

git-svn-id: http://lampsvn.epfl.ch/svn-repos/scala/scala/trunk@6844 5e8d7ff9-d8ef-0310-90f0-a4852d11357a

docs/README

@@ -2,8 +2,9 @@
 Scala Software Distributions
 ----------------------------
 
-- scala-YYYYMMDD-hhmmss.tar.gz            Unix distribution
-- scala-YYYYMMDD-hhmmss.zip               Windows distribution
+- scala-<major>.<minor>.<patch>.tar.bz2     Unis distribution
+- scala-<major>.<minor>.<patch>.tar.gz      Unix distribution
+- scala-<major>.<minor>.<patch>.zip         Windows distribution
 
 The standard distributions require Java 1.4.x or above. If you don't
 know which version of Java you have, run the command "java -version".
@@ -15,48 +16,47 @@ Scala Tools
 - scalac      Scala compiler
 - scaladoc    Scala API documentation generator
 - scalaint    Scala interactive interpreter
-- scalarun    Scala interpreter
-- scalap      Scala profiler
+- scalap      Scala classfile decoder 
 
 Run the command "scalac -help" to display the list of available
 compiler options.
 
-NB. socos, siris and surus are deprecated commands starting from
-version 20030811-115735 of the Scala distribution, please use
-respectively scalac, scalaint and scalarun instead.
-
 
 Install on Unix
 ---------------
 
 Untar the archive. All Scala tools are located in the directory "bin".
+Adding that directory to the PATH variable will make the Scala commands
+directly accessible.
 
-You may test the distribution by running the script "scala-test"
-located in the subdirectory "share/scala/test/bin".
+You may test the distribution by running the following commands:
+
+$ ./bin/scalac share/doc/scala/examples/sort.scala
+$ ./bin/scala examples.sort
+[6,2,8,5,1]
+[1,2,5,6,8]
+$ ./bin/scalaint
+scala> examples.sort.main(null)
+[6,2,8,5,1]
+[1,2,5,6,8]
+scala>:quit
+$
 
 
 Install on Windows
 ------------------
 
-Unzip the archive. All Scala tools are located in the "bin"
-directory. Before running any of these tools, you must define the
-environment variable SCALA_HOME to point to the home directory of the
-scala distribution.
+Unzip the archive. All Scala tools are located in the "bin" directory.
+Adding that directory to the PATH variable will make the Scala commands
+directly accessible.
 
-On Windows 95/98/Me, this can be done by adding the following command
-to your AUTOEXEC.BAT file and then rebooting your machine.
+On Windows 95/98/Me, you must define the environment variable SCALA_HOME
+to point to the home directory of the Scala distribution to run any of
+these tools. This can be done by adding the following command to your
+AUTOEXEC.BAT file and then rebooting your machine.
 
 set SCALA_HOME=<install-directory>\scala-YYYYMMDD-hhmmss
 
-On Windows NT/2000/XP, open the "Control Panel", open the "System"
-applet, select the "Advanced" tab, click on "Environment Variables",
-click on "New..." in the user variable section and enter the following
-informations:
-
-Variable Name : SCALA_HOME
-Variable Value: <install-directory>\scala-YYYYMMDD-hhmmss
-
-If you have Administrator privileges, you may install the tools for
-all users of your machine by creating a new system variable instead of
-a new user variable.
+On Windows NT/2000/XP, you do not need to define any variable in order
+for the Scala commands to run correctly.