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

From MQ To Evolve, The Refugee Book

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

Cheat sheet

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

Replacement details

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

hg qseries

```````````

All your work in progress is now in real changeset all the time.

You can use the standard log to display them. You can use the phase revset to

display unfinished business only and templates to have the same kind of compact

  [alias]

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

hg qnew

````````

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

  $ hg commit

If you want to keep the "wip are not pushed" behavior, you are looking for

setting your changeset in the secret phase using the phase command.

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

````````

  $ hg amend

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

to edit the commit message in an editor.

Amend have also 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 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

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 .

note: using graft allow you to pick the changeset you want next as the --move

option of qpush do.

hg qrm

```````

  $ hg kill <revset>

hg qfold

`````````

::

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

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

changesets, see the phase feature

hg qcommit

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

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

look at the qsync extension.