author | Matt Mackall <mpm@selenic.com> |
Fri, 28 May 2010 16:01:57 -0500 | |
changeset 11228 | 5cdac5c35e68 |
parent 11202 | f974fe896921 |
child 11229 | 1e701ffd9df4 |
permissions | -rw-r--r-- |
2729 | 1 |
% help |
8932
f87884329419
extensions: fix up description lines some more
Dirkjan Ochtman <dirkjan@ochtman.nl>
parents:
8894
diff
changeset
|
2 |
mq extension - manage a stack of patches |
2729 | 3 |
|
4 |
This extension lets you work with a stack of patches in a Mercurial |
|
9067
2ebac2bf7ad5
mq: wrapped docstrings at 78 characters
Martin Geisler <mg@lazybytes.net>
parents:
8932
diff
changeset
|
5 |
repository. It manages two stacks of patches - all known patches, and applied |
2ebac2bf7ad5
mq: wrapped docstrings at 78 characters
Martin Geisler <mg@lazybytes.net>
parents:
8932
diff
changeset
|
6 |
patches (subset of known patches). |
2729 | 7 |
|
9067
2ebac2bf7ad5
mq: wrapped docstrings at 78 characters
Martin Geisler <mg@lazybytes.net>
parents:
8932
diff
changeset
|
8 |
Known patches are represented as patch files in the .hg/patches directory. |
2ebac2bf7ad5
mq: wrapped docstrings at 78 characters
Martin Geisler <mg@lazybytes.net>
parents:
8932
diff
changeset
|
9 |
Applied patches are both patch files and changesets. |
2729 | 10 |
|
11 |
Common tasks (use "hg help command" for more details): |
|
12 |
||
9291
cd5b6a11b607
minirst: indent literal blocks with two spaces
Martin Geisler <mg@lazybytes.net>
parents:
9152
diff
changeset
|
13 |
create new patch qnew |
cd5b6a11b607
minirst: indent literal blocks with two spaces
Martin Geisler <mg@lazybytes.net>
parents:
9152
diff
changeset
|
14 |
import existing patch qimport |
2729 | 15 |
|
9291
cd5b6a11b607
minirst: indent literal blocks with two spaces
Martin Geisler <mg@lazybytes.net>
parents:
9152
diff
changeset
|
16 |
print patch series qseries |
cd5b6a11b607
minirst: indent literal blocks with two spaces
Martin Geisler <mg@lazybytes.net>
parents:
9152
diff
changeset
|
17 |
print applied patches qapplied |
2729 | 18 |
|
9291
cd5b6a11b607
minirst: indent literal blocks with two spaces
Martin Geisler <mg@lazybytes.net>
parents:
9152
diff
changeset
|
19 |
add known patch to applied stack qpush |
cd5b6a11b607
minirst: indent literal blocks with two spaces
Martin Geisler <mg@lazybytes.net>
parents:
9152
diff
changeset
|
20 |
remove patch from applied stack qpop |
cd5b6a11b607
minirst: indent literal blocks with two spaces
Martin Geisler <mg@lazybytes.net>
parents:
9152
diff
changeset
|
21 |
refresh contents of top applied patch qrefresh |
2729 | 22 |
|
10190
9c2c94934f0d
mq: upgrade to git patch when necessary (issue767)
Patrick Mezard <pmezard@gmail.com>
parents:
10149
diff
changeset
|
23 |
By default, mq will automatically use git patches when required to avoid |
9c2c94934f0d
mq: upgrade to git patch when necessary (issue767)
Patrick Mezard <pmezard@gmail.com>
parents:
10149
diff
changeset
|
24 |
losing file mode changes, copy records, binary files or empty files creations |
9c2c94934f0d
mq: upgrade to git patch when necessary (issue767)
Patrick Mezard <pmezard@gmail.com>
parents:
10149
diff
changeset
|
25 |
or deletions. This behaviour can be configured with: |
9c2c94934f0d
mq: upgrade to git patch when necessary (issue767)
Patrick Mezard <pmezard@gmail.com>
parents:
10149
diff
changeset
|
26 |
|
9c2c94934f0d
mq: upgrade to git patch when necessary (issue767)
Patrick Mezard <pmezard@gmail.com>
parents:
10149
diff
changeset
|
27 |
[mq] |
9c2c94934f0d
mq: upgrade to git patch when necessary (issue767)
Patrick Mezard <pmezard@gmail.com>
parents:
10149
diff
changeset
|
28 |
git = auto/keep/yes/no |
9c2c94934f0d
mq: upgrade to git patch when necessary (issue767)
Patrick Mezard <pmezard@gmail.com>
parents:
10149
diff
changeset
|
29 |
|
9c2c94934f0d
mq: upgrade to git patch when necessary (issue767)
Patrick Mezard <pmezard@gmail.com>
parents:
10149
diff
changeset
|
30 |
If set to 'keep', mq will obey the [diff] section configuration while |
9c2c94934f0d
mq: upgrade to git patch when necessary (issue767)
Patrick Mezard <pmezard@gmail.com>
parents:
10149
diff
changeset
|
31 |
preserving existing git patches upon qrefresh. If set to 'yes' or 'no', mq |
9c2c94934f0d
mq: upgrade to git patch when necessary (issue767)
Patrick Mezard <pmezard@gmail.com>
parents:
10149
diff
changeset
|
32 |
will override the [diff] section and always generate git or regular patches, |
9c2c94934f0d
mq: upgrade to git patch when necessary (issue767)
Patrick Mezard <pmezard@gmail.com>
parents:
10149
diff
changeset
|
33 |
possibly losing data in the second case. |
9c2c94934f0d
mq: upgrade to git patch when necessary (issue767)
Patrick Mezard <pmezard@gmail.com>
parents:
10149
diff
changeset
|
34 |
|
4315
bc6f5a1d8b7b
Add a pointer to "hg -v help" to the bottom of hg help {,cmd} output
Alexis S. L. Carvalho <alexis@cecm.usp.br>
parents:
4173
diff
changeset
|
35 |
list of commands: |
2729 | 36 |
|
37 |
qapplied print the patches already applied |
|
38 |
qclone clone main and patch repository at same time |
|
2910
41f8b041893b
Adjusted test to changed help output.
Thomas Arendsen Hein <thomas@intevation.de>
parents:
2852
diff
changeset
|
39 |
qdelete remove patches from queue |
6608
8d9d09d7c8b7
test-mq: update qdiff summary output
Patrick Mezard <pmezard@gmail.com>
parents:
6554
diff
changeset
|
40 |
qdiff diff of the current patch and subsequent modifications |
6645
37eedb1a1848
mq: introduce the qfinish command
Dirkjan Ochtman <dirkjan@ochtman.nl>
parents:
6644
diff
changeset
|
41 |
qfinish move applied patches into repository history |
2748
752b9475a700
New mq command qfold: Merge patches into the current patch.
Brendan Cully <brendan@kublai.com>
parents:
2747
diff
changeset
|
42 |
qfold fold the named patches into the current patch |
4432
905397be7688
mq: add qgoto command.
Bryan O'Sullivan <bos@serpentine.com>
parents:
4325
diff
changeset
|
43 |
qgoto push or pop patches until named patch is at top of stack |
2821
2e4ace008c94
mq: new commands qselect, qguard
Vadim Gelfer <vadim.gelfer@gmail.com>
parents:
2758
diff
changeset
|
44 |
qguard set or print guards for a patch |
7598 | 45 |
qheader print the header of the topmost or specified patch |
2729 | 46 |
qimport import a patch |
47 |
qnew create a new patch |
|
9439
f2acc0c00bec
Backed out premature qprev/qnext removal
Matt Mackall <mpm@selenic.com>
parents:
9365
diff
changeset
|
48 |
qnext print the name of the next patch |
2729 | 49 |
qpop pop the current patch off the stack |
9439
f2acc0c00bec
Backed out premature qprev/qnext removal
Matt Mackall <mpm@selenic.com>
parents:
9365
diff
changeset
|
50 |
qprev print the name of the previous patch |
2729 | 51 |
qpush push the next patch onto the stack |
52 |
qrefresh update the current patch |
|
2750
8c814c1ab31e
New self-explanatory command qrename.
Brendan Cully <brendan@kublai.com>
parents:
2748
diff
changeset
|
53 |
qrename rename a patch |
2821
2e4ace008c94
mq: new commands qselect, qguard
Vadim Gelfer <vadim.gelfer@gmail.com>
parents:
2758
diff
changeset
|
54 |
qselect set or print guarded patches to push |
2729 | 55 |
qseries print the entire series file |
9439
f2acc0c00bec
Backed out premature qprev/qnext removal
Matt Mackall <mpm@selenic.com>
parents:
9365
diff
changeset
|
56 |
qtop print the name of the current patch |
2729 | 57 |
qunapplied print the patches not yet applied |
11073
ee5b112aa529
mq: rewrite strip docstrings
Faheem Mitha <faheem@email.unc.edu> |