Commits

Pierre-Yves David committed 4387e62

Doc: several update

  • Participants
  • Parent commits a9c27df

Comments (0)

Files changed (2)

docs/evolve-faq.rst

 `public` changesets.
 
 To understand what the result of amend will be I use the two following
-aliases  [#]_::
+aliases   [#]_::
 
     # diff what amend will look likes
     pdiff=diff --rev .^
           XXX add idank example
 
 
-.. [#] (added by enable.sh)
+.. [#] (defined by the evolve extension for you)
 
 
 
 .. note:: those command only exist for the convenience of getting qpush and qpop
           feeling back.
 
-Collapse changesets: ``amend``
+Collapse changesets: ``fold``
 ------------------------------------------------------------
 
-you can use amend -c to collapse multiple changeset in a single one.
+you can use ``hg fold`` to collapse multiple changeset in a single one.
 
 Getting changes out of a commit
 ------------------------------------------------------------
 .. warning:: Beware that rebasing obsolete changesets will result in
              conflicting versions of the changesets.
 
-Stabilize history: ``evolve``
+Resolve history troubles: ``evolve``
 ------------------------------------------------------------
 
 When you rewrite (amend) a changeset with children without rewriting
 View obsolete markers
 ------------------------------------------------------------
 
-hgview is the only viewer that support this feature. You need an experimental
-version available here:
+hgview_ is the only viewer that currently support this feature. You need version 1.6.2
 
-    $ hg clone http://hg-dev.octopoid.net/hgwebdir.cgi/hgview/
+.. _hgview: http://www.logilab.org/project/hgview/
+
+.. image:: figures/hgview-example.png
+    :scale: 50%
+
 
 You can also use a debug command
 
 This command takes the same options as commit, plus the switch '-e' (--edit)
 to edit the commit message in an editor.
 
-The amend command also has a -c switch which allow you to make an
-explicit amending commit before rewriting a changeset.::
 
-  $ hg record -m 'feature A'
-  # oups, I forget some stuff
-  $ hg record babar.py
-  $ hg amend -c .^ # .^ refer to "working directoy parent, here 'feature A'
+.. -c is very confusig
+..
+.. The amend command also has a -c switch which allow you to make an
+.. explicit amending commit before rewriting a changeset.::
+..
+..   $ hg record -m 'feature A'
+..   # oups, I forget some stuff
+..   $ hg record babar.py
+..   $ hg amend -c .^ # .^ refer to "working directoy parent, here 'feature A'
 
 note: refresh is an alias for amend
 
 
 ::
 
-  $ hg up <top changeset>
-  $ amend --edit -c <bottom changeset>
-
-
-or later::
-
-  $ hg collapse # XXX not implemented
-  $ hg rebase --collapse # XXX not tested
-
+  $ hg fold first::last
 
 hg qdiff
 `````````
 
-``odiff`` is an alias for `hg diff -r .^` it works as qdiff, but outside mq.
+``pdiff`` is an alias for `hg diff -r .^` it works as qdiff, but outside mq.