changeset 205:c76a3e2a600c

Brief update.
author Bryan O'Sullivan <bos@serpentine.com>
date Mon, 23 Apr 2007 13:52:15 -0700
parents 927e74f0e838
children 6519f3b983b4
files en/branch.tex
diffstat 1 files changed, 20 insertions(+), 2 deletions(-) [+]
line wrap: on
line diff
--- a/en/branch.tex	Mon Apr 23 10:24:07 2007 -0700
+++ b/en/branch.tex	Mon Apr 23 13:52:15 2007 -0700
@@ -286,8 +286,26 @@
 that display the same kind of output.
 \interaction{branch-named.commit}
 The \hgcmd{log}-like commands will print the branch name of every
-changeset that's not on the \texttt{default} branch, so if you never
-use named branches, you'll never see this information.
+changeset that's not on the \texttt{default} branch.  As a result, if
+you never use named branches, you'll never see this information.
+
+Once you've named a branch and committed a change with that name,
+every subsequent commit that descends from that change will inherit
+the same branch name.
+
+\section{Branch names and merging}
+
+As you've probably noticed, merges in Mercurial are not symmetrical.
+Let's say our repository has two heads, 17 and 23.  If I
+\hgcmd{update} to 17 and then \hgcmd{merge} with 23, Mercurial records
+17 as the first parent of the merge, and 23 as the second.  Whereas if
+I \hgcmd{update} to 23 and then \hgcmd{merge} with 17, it records 23
+as the first parent, and 17 as the second.
+
+This behaviour affects Mercurial's choice of branch name when you
+merge.  During a merge, Mercurial will by default use the name of the
+first parent.
+
 
 %%% Local Variables: 
 %%% mode: latex