--- a/README
+++ b/README
@@ -1,4 +1,4 @@
-Piston is a utility that enables merge tracking of remote repositories.
+Piston is a utility that eases vendor branch management.
 This is similar to <tt>svn:externals</tt>, except you have a local copy of
 the files, which you can modify at will.  As long as the changes are
 mergeable, you should have no problems.
@@ -7,8 +7,8 @@ This tool has a similar purpose than svnmerge.py which you can find in the
 contrib/client-side folder of the main Subversion repository at
 http://svn.collab.net/repos/svn/trunk/contrib/client-side/svnmerge.py.
 The main difference is that Piston is designed to work with remote
-repositories.  Another tool you might want to look at, SVK, situated at
-http://svk.elixus.org.
+repositories.  Another tool you might want to look at, SVK, which you can find
+at http://svk.elixus.org/.
 
 From Wikipedia's Piston page (http://en.wikipedia.org/wiki/Piston):
   In general, a piston is a sliding plug that fits closely inside the bore
@@ -21,6 +21,7 @@ For this utility, I retain the second meaning, "to exert a force on a fluid
 inside the cylinder."  Piston forces the content of a remote repository
 location back into our own.
 
+
 = Installation
 
 Nothing could be simpler:
@@ -55,6 +56,14 @@ When you want to update again, you unlock:
  $ piston unlock vendor/rails
  'vendor/rails' unlocked.
 
+If the branch you are following moves, you should use the switch subcommand:
+
+ $ piston import http://dev.rubyonrails.org/svn/rails/branches/1-2-pre-release vendor/rails
+ $ svn commit vendor/rails
+
+ # Vendor branch is renamed, let's follow it
+ $ piston switch http://dev.rubyonrails.org/svn/rails/branches/1-2-stable vendor/rails
+
 
 = Contributions
 
@@ -121,8 +130,5 @@ repository than the one we checked out from originally.
 Piston depends on the following libraries:
 
 * yaml
-* getoptlong
 * uri
 * fileutils
-
-These dependencies are all included in a stock 1.8.4 Ruby distribution.