--- a/README
+++ b/README
@@ -5,21 +5,30 @@
 Install CL-PPCRE. (It's in clbuild.)
 
 Make sure your environment is set up to use an 8-bit locale (UTF-8 or
-ISO-8859-1 should work).  On Solaris, this can be done with
+ISO-8859-1 should work).  On Solaris and BSD-derived systems, this can
+be done with:
 
 	   LC_CTYPE=en_US.UTF-8
 
-while on many linux variants, you'll want
+while on many Linux variants, you'll want:
 
 	   LC_CTYPE=en_US.utf-8
 
 Edit platform-support-platforms.lisp to update available versions.
 
-Then run "env CURRENT_RELEASE=<x.y.z> make".
+If you have just bumped the SBCL version then you may need to update
+the sbcl submodule with something like this:
+
+	   (cd sbcl && git fetch && git checkout sbcl-x.y.z) && git commit -m "Update sbcl submodule to x.y.z" sbcl
+
+Note that if you update the submodule but do not commit here then it
+will be reset to the last committed version!
+
+Then run "make". Note that GNU make is required.
 
 Test locally.
 
-Then run "make commit".
+Commit your changes to platform-support-platforms.lisp
 
 Copy *.html and sbcl.css to the SBCL web page root.  As of October
 2008, this can only be done using SFTP, SCP, or rsync over SSH.  The
@@ -28,7 +37,7 @@
 
 rsync -avP -e ssh -b *.html <user>,sbcl@web.sourceforge.net:/home/groups/s/sb/sbcl/htdocs/
 
-Brian Mastenbrook
-2004/09/01
+Assuming ./extract-sfnet-user is smart enough to figure out your
+username, this may be done via "make upload-pages".
 
-Updated 2008/10/06, Richard Kreuter
+Don't forget to push when you're done!