[PATCH in crew] help: document '@' bookmark in 'help bookmarks' and 'help clone'

Kevin Bullock kbullock+mercurial at ringworld.org
Fri Jan 25 11:08:56 CST 2013


# HG changeset patch
# User Kevin Bullock <kbullock at ringworld.org>
# Date 1359133590 21600
# Branch stable
# Node ID e031e10cdc06a9708cd77f7518b6a6d817eeec10
# Parent  692cbda1eb50fe30c70792cb1e9380b28769467c
help: document '@' bookmark in 'help bookmarks' and 'help clone'

diff --git a/mercurial/commands.py b/mercurial/commands.py
--- a/mercurial/commands.py
+++ b/mercurial/commands.py
@@ -785,6 +785,10 @@ def bookmark(ui, repo, mark=None, rev=No
     repositories to support bookmarks. For versions prior to 1.8, this means
     the bookmarks extension must be enabled.
 
+    If you set a bookmark called '@', new clones of the repository will
+    have that revision checked out (and the bookmark made active) by
+    default.
+
     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
@@ -1146,6 +1150,9 @@ def clone(ui, source, dest=None, **opts)
     tag will include the tagged changeset but not the changeset
     containing the tag.
 
+    If the source repository has a bookmark called '@' set, that
+    revision will be checked out in the new repository by default.
+
     To check out a particular version, use -u/--update, or
     -U/--noupdate to create a clone with no working directory.
 


More information about the Mercurial-devel mailing list