changeset 7942:553cef16031f

mention default branch in branch and clone help
author Matt Mackall <mpm@selenic.com>
date Fri, 03 Apr 2009 12:37:06 -0500
parents f5d4f59a9996
children c289c3fc5985
files mercurial/commands.py
diffstat 1 files changed, 18 insertions(+), 14 deletions(-) [+]
line wrap: on
line diff
--- a/mercurial/commands.py	Tue Mar 10 19:16:16 2009 +0100
+++ b/mercurial/commands.py	Fri Apr 03 12:37:06 2009 -0500
@@ -393,8 +393,9 @@
     """set or show the current branch name
 
     With no argument, show the current branch name. With one argument,
-    set the working directory branch name (the branch does not exist in
-    the repository until the next commit).
+    set the working directory branch name (the branch does not exist
+    in the repository until the next commit). It is recommended to use
+    the 'default' branch as your primary development branch.
 
     Unless --force is specified, branch will not let you set a
     branch name that shadows an existing branch.
@@ -563,6 +564,21 @@
     The location of the source is added to the new repository's
     .hg/hgrc file, as the default to be used for future pulls.
 
+    If you use the -r option to clone up to a specific revision, no
+    subsequent revisions (including subsequent tags) will be present
+    in the cloned repository. This option implies --pull, even on
+    local repositories.
+
+    By default, clone will check out the head of the 'default' branch.
+    If the -U option is used, the new clone will contain only a repository
+    (.hg) and no working copy (the working copy parent is the null revision).
+
+    See 'hg help urls' for valid source format details.
+
+    It is possible to specify an ssh:// URL as the destination, but no
+    .hg/hgrc and working directory will be created on the remote side.
+    Look at the help text for urls for important details about ssh:// URLs.
+
     For efficiency, hardlinks are used for cloning whenever the source
     and destination are on the same filesystem (note this applies only
     to the repository data, not to the checked out files). Some
@@ -582,18 +598,6 @@
     this is not compatible with certain extensions that place their
     metadata under the .hg directory, such as mq.
 
-    If you use the -r option to clone up to a specific revision, no
-    subsequent revisions will be present in the cloned repository.
-    This option implies --pull, even on local repositories.
-
-    If the -U option is used, the new clone will contain only a repository
-    (.hg) and no working copy (the working copy parent is the null revision).
-
-    See 'hg help urls' for valid source format details.
-
-    It is possible to specify an ssh:// URL as the destination, but no
-    .hg/hgrc and working directory will be created on the remote side.
-    Look at the help text for urls for important details about ssh:// URLs.
     """
     cmdutil.setremoteconfig(ui, opts)
     hg.clone(ui, source, dest,