# HG changeset patch
# User Vadim Gelfer <vadim.gelfer@gmail.com>
# Date 1136241085 28800
# Node ID 722fd16f6f8cd86436e2ece26ee1feea1d91895a
# Parent  d72d27ee72b9032694e2abf3bfa60c8010d82375
document revert command more accurately.
this fixes issue 87.


diff --git a/doc/hg.1.txt b/doc/hg.1.txt
--- a/doc/hg.1.txt
+++ b/doc/hg.1.txt
@@ -497,9 +497,18 @@ rename <source ...> <dest>::
     aliases: mv
 
 revert [names ...]::
-    Revert any uncommitted modifications made to the named files or
-    directories.  This restores the contents of the affected files to
-    an unmodified state.
+    The revert command has two modes of operation.
+
+    In its default mode, it reverts any uncommitted modifications made
+    to the named files or directories.  This restores the contents of
+    the affected files to an unmodified state.
+
+    Using the -r option, it reverts the given files or directories to
+    their state as of an earlier revision.  This can be helpful to "roll
+    back" some or all of a change that should not have been committed.
+
+    Revert modifies the working directory.  It does not commit any
+    changes, or change the parent of the current working directory.
 
     If a file has been deleted, it is recreated.  If the executable
     mode of a file was changed, it is reset.