More README improvements.

rakudo · Feb 26, 2009 · f4d2486 · f4d2486
1 parent 5e410bb
commit f4d2486
Showing 1 changed file with 17 additions and 6 deletions.
diff --git a/README b/README
@@ -8,21 +8,32 @@ For more details, see the full text of the license in the file LICENSE.
 
 =head2 Building and invoking Rakudo
 
-To obtain Rakudo, we recommend directly downloading from github
-and building from there:
+Because Rakudo is under rapid development, we generally recommend
+downloading Rakudo directly from github and building from there:
 
     $ git clone git://github.com/rakudo/rakudo.git
+
+If you don't have git installed, you can get a tarball or zip of Rakudo 
+from github by visiting http://github.com/rakudo/rakudo/tree/master 
+and clicking "Download".  Then unpack the tarball or zip.
+
+Once you have a copy of Rakudo, build it as follows:
+
+    $ cd rakudo
     $ perl Configure.pl --gen-parrot
     $ make
 
 This will create a "perl6" or "perl6.exe" executable in the
 current directory.  Rakudo doesn't currently have a "make install"
 target.
 
-If you don't have git installed, you can visit the Rakudo github page
-at http://github.com/rakudo/rakudo/tree/master and clicking "Download".
-Github will build a tarball or zip file for you.  From there, unpack
-the tarball or zip, and run the C<perl> and C<make> steps above.
+The "--gen-parrot" option tells Configure.pl to automatically 
+download (via 'svn') and build the version of Parrot most 
+appropriate for the copy of Rakudo you currently have.  It's
+okay to use the --gen-parrot option on later invocations of
+Configure.pl; the configure system will re-build Parrot only
+if a newer version is needed for whatever version of Rakudo 
+you're working with.
 
 To run a Perl 6 program with Rakudo, issue a command like: