--- a/hgext/bookmarks.py	Wed Oct 20 16:54:34 2010 +0200
+++ b/hgext/bookmarks.py	Tue Oct 19 12:40:09 2010 -0500
@@ -103,6 +103,10 @@
     directory's parent revision with the given name. If you specify
     a revision using -r REV (where REV may be an existing bookmark),
     the bookmark is assigned to that revision.
+
+    Bookmarks can be pushed and pulled between repositories (see :hg:`help
+    push` and :hg:`help pull`). This requires the bookmark extension to be
+    enabled for both the local and remote repositories.
     '''
     hexfn = ui.debugflag and hex or short
     marks = repo._bookmarks