hgbook

changeset 273:00f69e8825c5

Bring book up to date with recent changes.
author Bryan O'Sullivan <bos@serpentine.com>
date Mon Nov 26 12:24:53 2007 -0800 (2007-11-26)
parents 74c079e0051f
children 96ea24a916f9
files en/daily.tex en/examples/branch-named.create.out en/examples/branch-named.parents.out en/examples/branch-named.rebranch.out en/examples/daily.revert.rename-orig.out en/examples/daily.revert.rename.out en/examples/extdiff.extdiff-ctx.out en/examples/extdiff.extdiff.out en/examples/hook.msglen.go.out en/examples/hook.simple.pretxncommit.out en/examples/hook.ws.better.out en/examples/hook.ws.simple.out en/examples/mq.id.output.out en/examples/mq.qinit-help.help.out en/examples/mq.tutorial.qnew.out en/examples/mq.tutorial.qnew2.out en/examples/mq.tutorial.qrefresh.out en/examples/mq.tutorial.qrefresh2.out en/examples/rename.divergent.merge.out en/examples/tour.version.out
line diff
     1.1 --- a/en/daily.tex	Mon Nov 26 11:18:46 2007 -0800
     1.2 +++ b/en/daily.tex	Mon Nov 26 12:24:53 2007 -0800
     1.3 @@ -337,22 +337,8 @@
     1.4  names when it merges changesets that contain divergent renames.
     1.5  \interaction{rename.divergent.merge}
     1.6  
     1.7 -I personally find this behaviour quite surprising, which is why I
     1.8 -wanted to explicitly mention it here.  I would have expected Mercurial
     1.9 -to prompt me with a three-way choice instead: do I want to keep only
    1.10 -\filename{bar}, only \filename{quux}, or both?
    1.11 -
    1.12 -In practice, when you rename a source file, it is likely that you will
    1.13 -also modify another file (such as a makefile) that knows how to build
    1.14 -the source file.  So what will happen if Anne renames a file and edits
    1.15 -\filename{Makefile} to build it under its new name, while Bob does the
    1.16 -same, but chooses a different name for the file, is that after the
    1.17 -merge, there will be two copies of the source file in the working
    1.18 -directory under different names, \emph{and} a conflict in the section
    1.19 -of the \filename{Makefile} that both Bob and Anne edited.
    1.20 -
    1.21 -This behaviour is considered surprising by other people, too:
    1.22 -see~\bug{455} for details.
    1.23 +Notice that Mercurial does warn about the divergent renames, but it
    1.24 +leaves it up to you to do something about the divergence after the merge.
    1.25  
    1.26  \subsection{Convergent renames and merging}
    1.27  
     2.1 --- a/en/examples/branch-named.create.out	Mon Nov 26 11:18:46 2007 -0800
     2.2 +++ b/en/examples/branch-named.create.out	Mon Nov 26 12:24:53 2007 -0800
     2.3 @@ -1,3 +1,4 @@
     2.4  $ \textbf{hg branch foo}
     2.5 +marked working directory as branch foo
     2.6  $ \textbf{hg branch}
     2.7  foo
     3.1 --- a/en/examples/branch-named.parents.out	Mon Nov 26 11:18:46 2007 -0800
     3.2 +++ b/en/examples/branch-named.parents.out	Mon Nov 26 12:24:53 2007 -0800
     3.3 @@ -8,5 +8,5 @@
     3.4  
     3.5  $ \textbf{hg branches}
     3.6  bar                            
     3.7 -foo                            
     3.8 -default                        
     3.9 +foo                             (inactive)
    3.10 +default                         (inactive)
     4.1 --- a/en/examples/branch-named.rebranch.out	Mon Nov 26 11:18:46 2007 -0800
     4.2 +++ b/en/examples/branch-named.rebranch.out	Mon Nov 26 12:24:53 2007 -0800
     4.3 @@ -1,6 +1,7 @@
     4.4  $ \textbf{hg branch}
     4.5  foo
     4.6  $ \textbf{hg branch bar}
     4.7 +marked working directory as branch bar
     4.8  $ \textbf{echo new file > newfile}
     4.9  $ \textbf{hg commit -A -m 'Third commit'}
    4.10  adding newfile
     5.1 --- a/en/examples/daily.revert.rename-orig.out	Mon Nov 26 11:18:46 2007 -0800
     5.2 +++ b/en/examples/daily.revert.rename-orig.out	Mon Nov 26 12:24:53 2007 -0800
     5.3 @@ -1,3 +1,4 @@
     5.4  $ \textbf{hg revert file}
     5.5 +no changes needed to file
     5.6  $ \textbf{hg status}
     5.7  ? new-file
     6.1 --- a/en/examples/daily.revert.rename.out	Mon Nov 26 11:18:46 2007 -0800
     6.2 +++ b/en/examples/daily.revert.rename.out	Mon Nov 26 12:24:53 2007 -0800
     6.3 @@ -1,5 +1,4 @@
     6.4  $ \textbf{hg rename file new-file}
     6.5  $ \textbf{hg revert new-file}
     6.6  $ \textbf{hg status}
     6.7 -R file
     6.8  ? new-file
     7.1 --- a/en/examples/extdiff.extdiff-ctx.out	Mon Nov 26 11:18:46 2007 -0800
     7.2 +++ b/en/examples/extdiff.extdiff-ctx.out	Mon Nov 26 12:24:53 2007 -0800
     7.3 @@ -1,8 +1,5 @@
     7.4  $ \textbf{hg extdiff -o -NprcC5}
     7.5 -making snapshot of 1 files from rev 
     7.6 -making snapshot of 1 files from working dir
     7.7 -diff -NprcC5 a./myfile a/myfile
     7.8 -*** a./myfile	Sat May 26 18:14:31 2007
     7.9 +
    7.10  
    7.11  ***************
    7.12  *** 1 ****
     8.1 --- a/en/examples/extdiff.extdiff.out	Mon Nov 26 11:18:46 2007 -0800
     8.2 +++ b/en/examples/extdiff.extdiff.out	Mon Nov 26 12:24:53 2007 -0800
     8.3 @@ -1,7 +1,4 @@
     8.4  $ \textbf{hg extdiff}
     8.5 -making snapshot of 1 files from rev 
     8.6 -making snapshot of 1 files from working dir
     8.7 -diff -Npru a./myfile a/myfile
     8.8  
     8.9  
    8.10  @@ -1 +1,2 @@
     9.1 --- a/en/examples/hook.msglen.go.out	Mon Nov 26 11:18:46 2007 -0800
     9.2 +++ b/en/examples/hook.msglen.go.out	Mon Nov 26 12:24:53 2007 -0800
     9.3 @@ -4,7 +4,7 @@
     9.4  $ \textbf{echo a > a}
     9.5  $ \textbf{hg add a}
     9.6  $ \textbf{hg commit -A -m 'too short'}
     9.7 -abort: pretxncommit.msglen hook exited with status 1
     9.8  transaction abort!
     9.9  rollback completed
    9.10 +abort: pretxncommit.msglen hook exited with status 1
    9.11  $ \textbf{hg commit -A -m 'long enough'}
    10.1 --- a/en/examples/hook.simple.pretxncommit.out	Mon Nov 26 11:18:46 2007 -0800
    10.2 +++ b/en/examples/hook.simple.pretxncommit.out	Mon Nov 26 12:24:53 2007 -0800
    10.3 @@ -5,9 +5,9 @@
    10.4  $ \textbf{echo 'pretxncommit.bug_id_required = ./check_bug_id $HG_NODE' >> .hg/hgrc}
    10.5  $ \textbf{echo a >> a}
    10.6  $ \textbf{hg commit -m 'i am not mentioning a bug id'}
    10.7 -abort: pretxncommit.bug_id_required hook exited with status 1
    10.8  transaction abort!
    10.9  rollback completed
   10.10 +abort: pretxncommit.bug_id_required hook exited with status 1
   10.11  $ \textbf{hg commit -m 'i refer you to bug 666'}
   10.12  committed 
   10.13  
    11.1 --- a/en/examples/hook.ws.better.out	Mon Nov 26 11:18:46 2007 -0800
    11.2 +++ b/en/examples/hook.ws.better.out	Mon Nov 26 12:24:53 2007 -0800
    11.3 @@ -5,13 +5,13 @@
    11.4  $ \textbf{hg commit -A -m 'add new line with trailing whitespace'}
    11.5  a, line 2: trailing whitespace added
    11.6  commit message saved to .hg/commit.save
    11.7 -abort: pretxncommit.whitespace hook exited with status 1
    11.8  transaction abort!
    11.9  rollback completed
   11.10 +abort: pretxncommit.whitespace hook exited with status 1
   11.11  $ \textbf{sed -i 's, *$,,' a}
   11.12  $ \textbf{hg commit -A -m 'trimmed trailing whitespace'}
   11.13  a, line 2: trailing whitespace added
   11.14  commit message saved to .hg/commit.save
   11.15 -abort: pretxncommit.whitespace hook exited with status 1
   11.16  transaction abort!
   11.17  rollback completed
   11.18 +abort: pretxncommit.whitespace hook exited with status 1
    12.1 --- a/en/examples/hook.ws.simple.out	Mon Nov 26 11:18:46 2007 -0800
    12.2 +++ b/en/examples/hook.ws.simple.out	Mon Nov 26 12:24:53 2007 -0800
    12.3 @@ -4,8 +4,8 @@
    12.4  $ \textbf{echo 'a ' > a}
    12.5  $ \textbf{hg commit -A -m 'test with trailing whitespace'}
    12.6  adding a
    12.7 -abort: pretxncommit.whitespace hook exited with status 1
    12.8  transaction abort!
    12.9  rollback completed
   12.10 +abort: pretxncommit.whitespace hook exited with status 1
   12.11  $ \textbf{echo 'a' > a}
   12.12  $ \textbf{hg commit -A -m 'drop trailing whitespace and try again'}
    13.1 --- a/en/examples/mq.id.output.out	Mon Nov 26 11:18:46 2007 -0800
    13.2 +++ b/en/examples/mq.id.output.out	Mon Nov 26 12:24:53 2007 -0800
    13.3 @@ -7,7 +7,7 @@
    13.4  tag:         qbase
    13.5  user:        Bryan O'Sullivan <bos@serpentine.com>
    13.6  
    13.7 -summary:     patch queue: first.patch
    13.8 +summary:     [mq]: first.patch
    13.9  
   13.10  changeset:   
   13.11  tag:         qtip
   13.12 @@ -15,7 +15,7 @@
   13.13  tag:         tip
   13.14  user:        Bryan O'Sullivan <bos@serpentine.com>
   13.15  
   13.16 -summary:     patch queue: second.patch
   13.17 +summary:     [mq]: second.patch
   13.18  
   13.19  $ \textbf{hg export second.patch}
   13.20  # HG changeset patch
   13.21 @@ -23,7 +23,7 @@
   13.22  
   13.23  # Node ID 
   13.24  # Parent  
   13.25 -patch queue: second.patch
   13.26 +[mq]: second.patch
   13.27  
   13.28  diff -r  -r  other.c
   13.29  
    14.1 --- a/en/examples/mq.qinit-help.help.out	Mon Nov 26 11:18:46 2007 -0800
    14.2 +++ b/en/examples/mq.qinit-help.help.out	Mon Nov 26 12:24:53 2007 -0800
    14.3 @@ -5,8 +5,9 @@
    14.4  
    14.5      The queue repository is unversioned by default. If -c is
    14.6      specified, qinit will create a separate nested repository
    14.7 -    for patches. Use qcommit to commit changes to this queue
    14.8 -    repository.
    14.9 +    for patches (qinit -c may also be run later to convert
   14.10 +    an unversioned patch repository into a versioned one).
   14.11 +    You can use qcommit to commit changes to this queue repository.
   14.12  
   14.13  options:
   14.14  
    15.1 --- a/en/examples/mq.tutorial.qnew.out	Mon Nov 26 11:18:46 2007 -0800
    15.2 +++ b/en/examples/mq.tutorial.qnew.out	Mon Nov 26 12:24:53 2007 -0800
    15.3 @@ -14,7 +14,7 @@
    15.4  tag:         qbase
    15.5  user:        Bryan O'Sullivan <bos@serpentine.com>
    15.6  
    15.7 -summary:     New patch: first.patch
    15.8 +summary:     [mq]: first.patch
    15.9  
   15.10  $ \textbf{ls .hg/patches}
   15.11  first.patch  series  status
    16.1 --- a/en/examples/mq.tutorial.qnew2.out	Mon Nov 26 11:18:46 2007 -0800
    16.2 +++ b/en/examples/mq.tutorial.qnew2.out	Mon Nov 26 12:24:53 2007 -0800
    16.3 @@ -1,16 +1,16 @@
    16.4  $ \textbf{hg qnew second.patch}
    16.5  $ \textbf{hg log --style=compact --limit=2}
    16.6  2[qtip,second.patch,tip]   
    16.7 -  New patch: second.patch
    16.8 +  [mq]: second.patch
    16.9  
   16.10  1[first.patch,qbase]   
   16.11 -  patch queue: first.patch
   16.12 +  [mq]: first.patch
   16.13  
   16.14  $ \textbf{echo 'line 4' >> file1}
   16.15  $ \textbf{hg qrefresh}
   16.16  $ \textbf{hg tip --style=compact --patch}
   16.17  2[qtip,second.patch,tip]   
   16.18 -  patch queue: second.patch
   16.19 +  [mq]: second.patch
   16.20  
   16.21  diff -r  -r  file1
   16.22  
    17.1 --- a/en/examples/mq.tutorial.qrefresh.out	Mon Nov 26 11:18:46 2007 -0800
    17.2 +++ b/en/examples/mq.tutorial.qrefresh.out	Mon Nov 26 12:24:53 2007 -0800
    17.3 @@ -10,7 +10,7 @@
    17.4  $ \textbf{hg diff}
    17.5  $ \textbf{hg tip --style=compact --patch}
    17.6  1[qtip,first.patch,tip,qbase]   
    17.7 -  patch queue: first.patch
    17.8 +  [mq]: first.patch
    17.9  
   17.10  diff -r  -r  file1
   17.11  
    18.1 --- a/en/examples/mq.tutorial.qrefresh2.out	Mon Nov 26 11:18:46 2007 -0800
    18.2 +++ b/en/examples/mq.tutorial.qrefresh2.out	Mon Nov 26 12:24:53 2007 -0800
    18.3 @@ -4,7 +4,7 @@
    18.4  $ \textbf{hg qrefresh}
    18.5  $ \textbf{hg tip --style=compact --patch}
    18.6  1[qtip,first.patch,tip,qbase]   
    18.7 -  patch queue: first.patch
    18.8 +  [mq]: first.patch
    18.9  
   18.10  diff -r  -r  file1
   18.11  
    19.1 --- a/en/examples/rename.divergent.merge.out	Mon Nov 26 11:18:46 2007 -0800
    19.2 +++ b/en/examples/rename.divergent.merge.out	Mon Nov 26 12:24:53 2007 -0800
    19.3 @@ -17,6 +17,9 @@
    19.4  added 1 changesets with 1 changes to 1 files (+1 heads)
    19.5  (run 'hg heads' to see heads, 'hg merge' to merge)
    19.6  $ \textbf{hg merge}
    19.7 +warning: detected divergent renames of foo to:
    19.8 + bar
    19.9 + quux
   19.10  1 files updated, 0 files merged, 0 files removed, 0 files unresolved
   19.11  (branch merge, don't forget to commit)
   19.12  $ \textbf{ls}
    20.1 --- a/en/examples/tour.version.out	Mon Nov 26 11:18:46 2007 -0800
    20.2 +++ b/en/examples/tour.version.out	Mon Nov 26 12:24:53 2007 -0800
    20.3 @@ -1,6 +1,6 @@
    20.4  $ \textbf{hg version}
    20.5 -Mercurial Distributed SCM (version )
    20.6 +Mercurial Distributed SCM (version +20071107)
    20.7  
    20.8 -Copyright (C) 2005, 2006 Matt Mackall <mpm@selenic.com>
    20.9 +Copyright (C) 2005-2007 Matt Mackall <mpm@selenic.com> and others
   20.10  This is free software; see the source for copying conditions. There is NO
   20.11  warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.