diff --git a/mercurial/commands.py b/mercurial/commands.py
index f8272c70eb7fd3d3c417422f3c2433c447997a18_bWVyY3VyaWFsL2NvbW1hbmRzLnB5..f57f891eb88e0988e90a3824cfab2116b55e9248_bWVyY3VyaWFsL2NvbW1hbmRzLnB5 100644
--- a/mercurial/commands.py
+++ b/mercurial/commands.py
@@ -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