-------------------------------------------

From MQ To Evolve, The Refugee Book

-------------------------------------------

Cheat sheet

-------------

==============================  ============================================

mq command                       new equivalent

==============================  ============================================

qseries                         ``log``

qnew                            ``commit``

qrefresh                        ``amend``

qpop                            ``update`` or ``qdown``

qpush                           ``update`` or ``gup`` sometimes ``stabilize``

qrm                             ``kill``

qfold                           ``amend -c`` (for now, ``collapse`` soon)

qdiff                           ``odiff``

qfinish                         --

qimport                         --

==============================  ============================================

Replacement details

---------------------

hg qseries

```````````

This will result in something like that::

  [alias]

  wip = log -r 'not public()' --template='{rev}:{node|short} {desc|firstline}\n'

hg qnew

````````

With evolve you handle standard changesets without an additional overlay.

Standard changeset are created using hg commit as usual.::

  $ hg commit

Note that you only need it for the first commit you want to be secret. Later

commits will inherit their parents phase.

If you always want your new commit to be in the secret phase, your should

consider updating your configuration:

  [phases]

  new-commit=secret

hg qref

````````

A new command from evolution will allow you to rewrite the changeset you are

  $ hg amend

This command takes the same options as commit, plus the switch '-e' (--edit)

to edit the commit message in an editor.

  $ 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 qref -X

````````````

To remove change from you current commit use::

  $ hg uncommit not-ready.txt

hg qpop

`````````

  $ hg gdown

  $ hg update

.. note:: gdown and update allow movement with working directory changes applied

          and gracefully merge them.

hg qpush

````````

When you rewrite changesets, descendants of rewritten changesets are marked as

"out of sync". You need to rewrite them on top of the new version of their

ancestor.

  $ hg stabilize

You can also decide to do it manually using::

  $ hg graft -O <old-version>

or::

  $ hg rebase -r <revset for old version> -d .

option of qpush do.

hg qrm

```````

evolution introduce a new command to mark a changeset as "not wanted anymore".::

  $ hg kill <revset>

hg qfold

`````````

::

  $ hg up <top changeset>

  $ amend --edit -c <bottom changeset>

or later::

  $ hg collapse # XXX not implemented

  $ hg rebase --collapse # XXX not tested

hg qdiff

`````````

``odiff`` is an alias for `hg diff -r .^` it works as qdiff, but outside mq.

hg qfinish and hg qimport

````````````````````````````

hg qcommit

```````````````

If you really need to send patches through versioned mq patches, you should

look at the qsync extension.