Update gclient sync docs to reflect reality + add an example for the most com...

gclient.py

 #!/usr/bin/python
 #
 # Copyright 2008 Google Inc.  All Rights Reserved.
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
 # You may obtain a copy of the License at
 #
 #      http://www.apache.org/licenses/LICENSE-2.0
 #
@@ skipping 108 matching lines @@
 of the latest, either for a single solution or for all solutions.
 Unless the --force option is provided, solutions and modules whose
 local revision matches the one to update (i.e., they have not changed
 in the repository) are *not* modified. Unless --nohooks is provided,
 the hooks are run.
 This a synonym for 'gclient %(alias)s'
 
 usage: gclient %(cmd)s [options] [--] [svn update options/args]
 
 Valid options:
-  --force             : force update even for unchanged modules
-  --nohooks           : don't run the hooks after the update is complete
-  --revision REV      : update/checkout all solutions with specified revision
+  --force                 : force update even for unchanged modules
+  --nohooks               : don't run the hooks after the update is complete
   --revision SOLUTION@REV : update given solution to specified revision
-  --deps PLATFORM(S)  : sync deps for the given platform(s), or 'all'
-  --verbose           : output additional diagnostics
-  --head              : update to latest revision, instead of last good revision
+  --deps PLATFORM(S)      : sync deps for the given platform(s), or 'all'
+  --verbose               : output additional diagnostics
+  --head                  : update to latest revision, instead of last good revision
 
 Examples:
   gclient %(cmd)s
       update files from SVN according to current configuration,
       *for modules which have changed since last update or sync*
   gclient %(cmd)s --force
       update files from SVN according to current configuration, for
       all modules (useful for recovering files deleted from local copy)
+  gclient %(cmd)s --revision src@31000
+      update src directory to r31000
 """)
 
 COMMAND_USAGE_TEXT = {
     "cleanup":
     """Clean up all working copies, using 'svn cleanup' for each module.
 Additional options and args may be passed to 'svn cleanup'.
 
 usage: cleanup [options] [--] [svn cleanup args/options]
 
 Valid options:
@@ skipping 1026 matching lines @@
 
 if "__main__" == __name__:
   try:
     result = Main(sys.argv)
   except gclient_utils.Error, e:
     print >> sys.stderr, "Error: %s" % str(e)
     result = 1
   sys.exit(result)
 
 # vim: ts=2:sw=2:tw=80:et: