diff -r f8272c70eb7f -r f57f891eb88e mercurial/commands.py
--- a/mercurial/commands.py	Fri Jan 20 13:19:39 2012 -0200
+++ b/mercurial/commands.py	Thu Jan 19 16:05:01 2012 -0600
@@ -745,6 +745,11 @@
     push` and :hg:`help pull`). This requires both the local and remote
     repositories to support bookmarks. For versions prior to 1.8, this means
     the bookmarks extension must be enabled.
+
+    With -i/--inactive, the new bookmark will not be made the active
+    bookmark. If -r/--rev is given, the new bookmark will not be made
+    active even if -i/--inactive is not given. If no NAME is given, the
+    current active bookmark will be marked inactive.
     '''
     hexfn = ui.debugflag and hex or short
     marks = repo._bookmarks