This is an archive of the discontinued Mercurial Phabricator instance.

Differential D5067

help: assigning categories to existing commands
ClosedPublic

Authored by rdamazio on Oct 13 2018, 6:19 AM.

Details

Reviewers
durin42
martinvonz
Group Reviewers
hg-reviewers
Commits
rHGc303d65d2e34: help: assigning categories to existing commands
Summary

I'm separating this into its own commit so people can bikeshed over the actual
categorization (vs the support for categories). These categories are based on
the help implementation we've been using internally at Google, and have had
zero complaints.

Diff Detail

Repository
rHG Mercurial
Lint
Automatic diff as part of commit; lint not applicable.
Unit
Automatic diff as part of commit; unit tests not applicable.

Event Timeline

rdamazio created this revision.Oct 13 2018, 6:19 AM
rdamazio updated this revision to Diff 12041.Oct 13 2018, 6:44 AM
rdamazio updated this revision to Diff 12062.Oct 13 2018, 8:44 AM
yuja added a subscriber: yuja.Oct 14 2018, 4:42 AM
  1. Command categories.

+CATEGORY_REPO_CREATION = _('Repository creation')
+CATEGORY_REMOTE_REPO_MANAGEMENT = _('Remote repository management')
+CATEGORY_COMMITTING = _('Change creation')
+CATEGORY_CHANGE_NAVIGATION = _('Change navigation')
+CATEGORY_CHANGE_MANAGEMENT = _('Change manipulation')
+CATEGORY_CHANGE_ORGANIZATION = _('Change organization')
+CATEGORY_WORKING_DIRECTORY = _('Working directory management')
+CATEGORY_FILE_CONTENTS = _('File content management')
+CATEGORY_IMPORT_EXPORT = _('Change import/export')
+CATEGORY_MAINTENANCE = _('Repository maintenance')
+CATEGORY_HELP = _('Help')
+CATEGORY_MISC = _('Miscellaneous commands')
CATEGORY_NONE = _('Uncategorized commands')

Can you make these constants untranslated (e.g. 'help' instead of _('Help'))
and map them to corresponding translation later?

And, perhaps they can be moved to registrar.command so we can avoid
importing help.py everywhere.

rdamazio updated this revision to Diff 12122.Oct 14 2018, 6:32 AM
rdamazio added a comment.Oct 14 2018, 6:32 AM
In D5067#76195, @yuja wrote:

Can you make these constants untranslated (e.g. 'help' instead of _('Help'))
and map them to corresponding translation later?
And, perhaps they can be moved to registrar.command so we can avoid
importing help.py everywhere.

See if this is what you had in mind. Also updated all parent changesets accordingly.

yuja added a comment.Oct 14 2018, 9:02 AM
See if this is what you had in mind. Also updated all parent changesets accordingly.

Yeah, that's it, thanks. I'll review the new series.

Closed by commit rHGc303d65d2e34: help: assigning categories to existing commands (authored by rdamazio). · Explain WhyOct 14 2018, 11:17 AM
This revision was automatically updated to reflect the committed changes.
yuja added a comment.Oct 14 2018, 11:30 AM

+# Add our category before "Repository maintenance".
+help.CATEGORY_ORDER.insert(
+ help.CATEGORY_ORDER.index(command.CATEGORY_MAINTENANCE),
+ _HELP_CATEGORY)
+help.CATEGORY_NAMES[_HELP_CATEGORY] = 'GPG signing'

Moved this to extsetup(), since otherwise it could leave phantom None
on import failure.

yuja added a comment.Oct 14 2018, 11:30 AM

Queued the first 5 patches, thanks.

  1. Human-readable category names. These are translated.
  2. Extensions with custom categories should add their names here.

To make these being collected to i18n catalog, we have to wrap them with _().
But that can be fixed later.

CATEGORY_NAMES = {
+ registrar.command.CATEGORY_REPO_CREATION: 'Repository creation',
+ registrar.command.CATEGORY_REMOTE_REPO_MANAGEMENT:
+ 'Remote repository management',
+ registrar.command.CATEGORY_COMMITTING: 'Change creation',
+ registrar.command.CATEGORY_CHANGE_NAVIGATION: 'Change navigation',
+ registrar.command.CATEGORY_CHANGE_MANAGEMENT: 'Change manipulation',
+ registrar.command.CATEGORY_CHANGE_ORGANIZATION: 'Change organization',
+ registrar.command.CATEGORY_WORKING_DIRECTORY:
+ 'Working directory management',
+ registrar.command.CATEGORY_FILE_CONTENTS: 'File content management',
+ registrar.command.CATEGORY_IMPORT_EXPORT: 'Change import/export',
+ registrar.command.CATEGORY_MAINTENANCE: 'Repository maintenance',
+ registrar.command.CATEGORY_HELP: 'Help',
+ registrar.command.CATEGORY_MISC: 'Miscellaneous commands',

registrar.command.CATEGORY_NONE: 'Uncategorized commands',

Perhaps, using all-lowercase names is our convention.

Revision Contents
Changeset List

PathPackages
Mhgext/absorb.py (3 lines)
Mhgext/amend.py (1 line)
Mhgext/blackbox.py (3 lines)
Mhgext/censor.py (3 lines)
Mhgext/children.py (1 line)
Mhgext/churn.py (1 line)
Mhgext/closehead.py (4 lines)
Mhgext/extdiff.py (1 line)
Mhgext/fetch.py (3 lines)
Mhgext/fix.py (3 lines)
Mhgext/githelp.py (3 lines)
Mhgext/gpg.py (18 lines)
Mhgext/graphlog.py (1 line)
Mhgext/hgk.py (3 lines)
Mhgext/histedit.py (3 lines)
Mhgext/journal.py (3 lines)
Mhgext/mq.py (68 lines)
Mhgext/patchbomb.py (3 lines)
Mhgext/purge.py (3 lines)
Mhgext/rebase.py (3 lines)
Mhgext/record.py (4 lines)
Mhgext/releasenotes.py (3 lines)
Mhgext/relink.py (2 lines)
Mhgext/share.py (3 lines)
Mhgext/shelve.py (6 lines)
Mhgext/show.py (3 lines)
Mhgext/split.py (3 lines)
Mhgext/strip.py (3 lines)
Mhgext/transplant.py (3 lines)
Mhgext/uncommit.py (5 lines)
Mmercurial/commands.py (129 lines)
Mmercurial/help.py (26 lines)
Mmercurial/registrar.py (12 lines)
Mtests/test-globalopts.t (188 lines)
Mtests/test-help.t (282 lines)
Mtests/test-mq.t (29 lines)

Diff 12145

hgext/absorb.py

('p', 'print-changes', None, ('p', 'print-changes', None,
_('always print which changesets are modified by which changes')), _('always print which changesets are modified by which changes')),
('i', 'interactive', None, ('i', 'interactive', None,
_('interactively select which chunks to apply (EXPERIMENTAL)')), _('interactively select which chunks to apply (EXPERIMENTAL)')),
('e', 'edit-lines', None, ('e', 'edit-lines', None,
_('edit what lines belong to which changesets before commit ' _('edit what lines belong to which changesets before commit '
'(EXPERIMENTAL)')), '(EXPERIMENTAL)')),
] + commands.dryrunopts + commands.templateopts + commands.walkopts, ] + commands.dryrunopts + commands.templateopts + commands.walkopts,
_('hg absorb [OPTION] [FILE]...')) _('hg absorb [OPTION] [FILE]...'),
helpcategory=command.CATEGORY_COMMITTING)
def absorbcmd(ui, repo, *pats, **opts): def absorbcmd(ui, repo, *pats, **opts):
"""incorporate corrections into the stack of draft changesets """incorporate corrections into the stack of draft changesets
absorb analyzes each change in your working directory and attempts to absorb analyzes each change in your working directory and attempts to
amend the changed lines into the changesets in your stack that first amend the changed lines into the changesets in your stack that first
introduced those lines. introduced those lines.
If absorb cannot find an unambiguous changeset to amend for a change, If absorb cannot find an unambiguous changeset to amend for a change,

hgext/amend.py

@command('amend', @command('amend',
[('A', 'addremove', None, [('A', 'addremove', None,
_('mark new/missing files as added/removed before committing')), _('mark new/missing files as added/removed before committing')),
('e', 'edit', None, _('invoke editor on commit messages')), ('e', 'edit', None, _('invoke editor on commit messages')),
('i', 'interactive', None, _('use interactive mode')), ('i', 'interactive', None, _('use interactive mode')),
('n', 'note', '', _('store a note on the amend')), ('n', 'note', '', _('store a note on the amend')),
] + cmdutil.walkopts + cmdutil.commitopts + cmdutil.commitopts2, ] + cmdutil.walkopts + cmdutil.commitopts + cmdutil.commitopts2,
_('[OPTION]... [FILE]...'), _('[OPTION]... [FILE]...'),
helpcategory=command.CATEGORY_COMMITTING,
inferrepo=True) inferrepo=True)
def amend(ui, repo, *pats, **opts): def amend(ui, repo, *pats, **opts):
"""amend the working copy parent with all or specified outstanding changes """amend the working copy parent with all or specified outstanding changes
Similar to :hg:`commit --amend`, but reuse the commit message without Similar to :hg:`commit --amend`, but reuse the commit message without
invoking editor, unless ``--edit`` was set. invoking editor, unless ``--edit`` was set.
See :hg:`help commit` for more details. See :hg:`help commit` for more details.

hgext/blackbox.py

if lastui is None: if lastui is None:
lastui = ui lastui = ui
repo._wlockfreeprefix.add('blackbox.log') repo._wlockfreeprefix.add('blackbox.log')
@command('^blackbox', @command('^blackbox',
[('l', 'limit', 10, _('the number of events to show')), [('l', 'limit', 10, _('the number of events to show')),
], ],
_('hg blackbox [OPTION]...')) _('hg blackbox [OPTION]...'),
helpcategory=command.CATEGORY_MAINTENANCE)
def blackbox(ui, repo, *revs, **opts): def blackbox(ui, repo, *revs, **opts):
'''view the recent repository events '''view the recent repository events
''' '''
if not repo.vfs.exists('blackbox.log'): if not repo.vfs.exists('blackbox.log'):
return return
limit = opts.get(r'limit') limit = opts.get(r'limit')

hgext/censor.py

# extensions which SHIP WITH MERCURIAL. Non-mainline extensions should # extensions which SHIP WITH MERCURIAL. Non-mainline extensions should
# be specifying the version(s) of Mercurial they are tested with, or # be specifying the version(s) of Mercurial they are tested with, or
# leave the attribute unspecified. # leave the attribute unspecified.
testedwith = 'ships-with-hg-core' testedwith = 'ships-with-hg-core'
@command('censor', @command('censor',
[('r', 'rev', '', _('censor file from specified revision'), _('REV')), [('r', 'rev', '', _('censor file from specified revision'), _('REV')),
('t', 'tombstone', '', _('replacement tombstone data'), _('TEXT'))], ('t', 'tombstone', '', _('replacement tombstone data'), _('TEXT'))],
_('-r REV [-t TEXT] [FILE]')) _('-r REV [-t TEXT] [FILE]'),
helpcategory=command.CATEGORY_MAINTENANCE)
def censor(ui, repo, path, rev='', tombstone='', **opts): def censor(ui, repo, path, rev='', tombstone='', **opts):
with repo.wlock(), repo.lock(): with repo.wlock(), repo.lock():
return _docensor(ui, repo, path, rev, tombstone, **opts) return _docensor(ui, repo, path, rev, tombstone, **opts)
def _docensor(ui, repo, path, rev='', tombstone='', **opts): def _docensor(ui, repo, path, rev='', tombstone='', **opts):
if not path: if not path:
raise error.Abort(_('must specify file path to censor')) raise error.Abort(_('must specify file path to censor'))
if not rev: if not rev:

hgext/children.py

# leave the attribute unspecified. # leave the attribute unspecified.
testedwith = 'ships-with-hg-core' testedwith = 'ships-with-hg-core'
@command('children', @command('children',
[('r', 'rev', '.', [('r', 'rev', '.',
_('show children of the specified revision'), _('REV')), _('show children of the specified revision'), _('REV')),
] + templateopts, ] + templateopts,
_('hg children [-r REV] [FILE]'), _('hg children [-r REV] [FILE]'),
helpcategory=command.CATEGORY_CHANGE_NAVIGATION,
inferrepo=True) inferrepo=True)
def children(ui, repo, file_=None, **opts): def children(ui, repo, file_=None, **opts):
"""show the children of the given or working directory revision """show the children of the given or working directory revision
Print the children of the working directory's revisions. If a Print the children of the working directory's revisions. If a
revision is given via -r/--rev, the children of that revision will revision is given via -r/--rev, the children of that revision will
be printed. If a file argument is given, revision in which the be printed. If a file argument is given, revision in which the
file was last changed (after the working directory revision or the file was last changed (after the working directory revision or the

hgext/churn.py

('f', 'dateformat', '', ('f', 'dateformat', '',
_('strftime-compatible format for grouping by date'), _('FORMAT')), _('strftime-compatible format for grouping by date'), _('FORMAT')),
('c', 'changesets', False, _('count rate by number of changesets')), ('c', 'changesets', False, _('count rate by number of changesets')),
('s', 'sort', False, _('sort by key (default: sort by count)')), ('s', 'sort', False, _('sort by key (default: sort by count)')),
('', 'diffstat', False, _('display added/removed lines separately')), ('', 'diffstat', False, _('display added/removed lines separately')),
('', 'aliases', '', _('file with email aliases'), _('FILE')), ('', 'aliases', '', _('file with email aliases'), _('FILE')),
] + cmdutil.walkopts, ] + cmdutil.walkopts,
_("hg churn [-d DATE] [-r REV] [--aliases FILE] [FILE]"), _("hg churn [-d DATE] [-r REV] [--aliases FILE] [FILE]"),
helpcategory=command.CATEGORY_MAINTENANCE,
inferrepo=True) inferrepo=True)
def churn(ui, repo, *pats, **opts): def churn(ui, repo, *pats, **opts):
'''histogram of changes to the repository '''histogram of changes to the repository
This command will display a histogram representing the number This command will display a histogram representing the number
of changed lines or revisions, grouped according to the given of changed lines or revisions, grouped according to the given
template. The default template will group changes by author. template. The default template will group changes by author.
The --dateformat option may be used to group the results by The --dateformat option may be used to group the results by

hgext/closehead.py

testedwith = 'ships-with-hg-core' testedwith = 'ships-with-hg-core'
commitopts = cmdutil.commitopts commitopts = cmdutil.commitopts
commitopts2 = cmdutil.commitopts2 commitopts2 = cmdutil.commitopts2
commitopts3 = [('r', 'rev', [], commitopts3 = [('r', 'rev', [],
_('revision to check'), _('REV'))] _('revision to check'), _('REV'))]
@command('close-head|close-heads', commitopts + commitopts2 + commitopts3, @command('close-head|close-heads', commitopts + commitopts2 + commitopts3,
_('[OPTION]... [REV]...'), inferrepo=True) _('[OPTION]... [REV]...'),
helpcategory=command.CATEGORY_CHANGE_MANAGEMENT,
inferrepo=True)
def close_branch(ui, repo, *revs, **opts): def close_branch(ui, repo, *revs, **opts):
"""close the given head revisions """close the given head revisions
This is equivalent to checking out each revision in a clean tree and running This is equivalent to checking out each revision in a clean tree and running
``hg commit --close-branch``, except that it doesn't change the working ``hg commit --close-branch``, except that it doesn't change the working
directory. directory.
The commit message must be specified with -l or -m. The commit message must be specified with -l or -m.

hgext/extdiff.py

('c', 'change', '', _('change made by revision'), _('REV')), ('c', 'change', '', _('change made by revision'), _('REV')),
('', 'patch', None, _('compare patches for two revisions')) ('', 'patch', None, _('compare patches for two revisions'))
] + cmdutil.walkopts + cmdutil.subrepoopts ] + cmdutil.walkopts + cmdutil.subrepoopts
@command('extdiff', @command('extdiff',
[('p', 'program', '', _('comparison program to run'), _('CMD')), [('p', 'program', '', _('comparison program to run'), _('CMD')),
] + extdiffopts, ] + extdiffopts,
_('hg extdiff [OPT]... [FILE]...'), _('hg extdiff [OPT]... [FILE]...'),
helpcategory=command.CATEGORY_FILE_CONTENTS,
inferrepo=True) inferrepo=True)
def extdiff(ui, repo, *pats, **opts): def extdiff(ui, repo, *pats, **opts):
'''use external program to diff repository (or selected files) '''use external program to diff repository (or selected files)
Show differences between revisions for the specified files, using Show differences between revisions for the specified files, using
an external program. The default program used is diff, with an external program. The default program used is diff, with
default options "-Npru". default options "-Npru".

hgext/fetch.py

@command('fetch', @command('fetch',
[('r', 'rev', [], [('r', 'rev', [],
_('a specific revision you would like to pull'), _('REV')), _('a specific revision you would like to pull'), _('REV')),
('', 'edit', None, _('invoke editor on commit messages')), ('', 'edit', None, _('invoke editor on commit messages')),
('', 'force-editor', None, _('edit commit message (DEPRECATED)')), ('', 'force-editor', None, _('edit commit message (DEPRECATED)')),
('', 'switch-parent', None, _('switch parents when merging')), ('', 'switch-parent', None, _('switch parents when merging')),
] + cmdutil.commitopts + cmdutil.commitopts2 + cmdutil.remoteopts, ] + cmdutil.commitopts + cmdutil.commitopts2 + cmdutil.remoteopts,
_('hg fetch [SOURCE]')) _('hg fetch [SOURCE]'),
helpcategory=command.CATEGORY_REMOTE_REPO_MANAGEMENT)
def fetch(ui, repo, source='default', **opts): def fetch(ui, repo, source='default', **opts):
'''pull changes from a remote repository, merge new changes if needed. '''pull changes from a remote repository, merge new changes if needed.
This finds all changes from the repository at the specified path This finds all changes from the repository at the specified path
or URL and adds them to the local repository. or URL and adds them to the local repository.
If the pulled changes add a new branch head, the head is If the pulled changes add a new branch head, the head is
automatically merged, and the result of the merge is committed. automatically merged, and the result of the merge is committed.

hgext/fix.py

baseopt = ('', 'base', [], _('revisions to diff against (overrides automatic ' baseopt = ('', 'base', [], _('revisions to diff against (overrides automatic '
'selection, and applies to every revision being ' 'selection, and applies to every revision being '
'fixed)'), _('REV')) 'fixed)'), _('REV'))
revopt = ('r', 'rev', [], _('revisions to fix'), _('REV')) revopt = ('r', 'rev', [], _('revisions to fix'), _('REV'))
wdiropt = ('w', 'working-dir', False, _('fix the working directory')) wdiropt = ('w', 'working-dir', False, _('fix the working directory'))
wholeopt = ('', 'whole', False, _('always fix every line of a file')) wholeopt = ('', 'whole', False, _('always fix every line of a file'))
usage = _('[OPTION]... [FILE]...') usage = _('[OPTION]... [FILE]...')
@command('fix', [allopt, baseopt, revopt, wdiropt, wholeopt], usage) @command('fix', [allopt, baseopt, revopt, wdiropt, wholeopt], usage,
helpcategory=command.CATEGORY_FILE_CONTENTS)
def fix(ui, repo, *pats, **opts): def fix(ui, repo, *pats, **opts):
"""rewrite file content in changesets or working directory """rewrite file content in changesets or working directory
Runs any configured tools to fix the content of files. Only affects files Runs any configured tools to fix the content of files. Only affects files
with changes, unless file arguments are provided. Only affects changed lines with changes, unless file arguments are provided. Only affects changed lines
of files, unless the --whole flag is used. Some tools may always affect the of files, unless the --whole flag is used. Some tools may always affect the
whole file regardless of --whole. whole file regardless of --whole.

hgext/githelp.py

return s[7:] return s[7:]
if 'HEAD' in s: if 'HEAD' in s:
s = s.replace('HEAD', '.') s = s.replace('HEAD', '.')
# HEAD~ in git is .~1 in mercurial # HEAD~ in git is .~1 in mercurial
s = re.sub('~$', '~1', s) s = re.sub('~$', '~1', s)
return s return s
@command('^githelp|git', [ @command('^githelp|git', [
], _('hg githelp')) ], _('hg githelp'),
helpcategory=command.CATEGORY_HELP)
def githelp(ui, repo, *args, **kwargs): def githelp(ui, repo, *args, **kwargs):
'''suggests the Mercurial equivalent of the given git command '''suggests the Mercurial equivalent of the given git command
Usage: hg githelp -- <git command> Usage: hg githelp -- <git command>
''' '''
if len(args) == 0 or (len(args) == 1 and args[0] =='git'): if len(args) == 0 or (len(args) == 1 and args[0] =='git'):
raise error.Abort(_('missing git command - ' raise error.Abort(_('missing git command - '

hgext/gpg.py

# Copyright 2005, 2006 Benoit Boissinot <benoit.boissinot@ens-lyon.org> # Copyright 2005, 2006 Benoit Boissinot <benoit.boissinot@ens-lyon.org>
# #
# This software may be used and distributed according to the terms of the # This software may be used and distributed according to the terms of the
# GNU General Public License version 2 or any later version. # GNU General Public License version 2 or any later version.
'''commands to sign and verify changesets''' '''commands to sign and verify changesets'''
from __future__ import absolute_import from __future__ import absolute_import
import binascii import binascii
import os import os
from mercurial.i18n import _ from mercurial.i18n import _
from mercurial import ( from mercurial import (
cmdutil, cmdutil,
error, error,
help,
match, match,
node as hgnode, node as hgnode,
pycompat, pycompat,
registrar, registrar,
) )
from mercurial.utils import ( from mercurial.utils import (
dateutil, dateutil,
procutil, procutil,
configitem('gpg', 'key', configitem('gpg', 'key',
default=None, default=None,
) )
configitem('gpg', '.*', configitem('gpg', '.*',
default=None, default=None,
generic=True, generic=True,
) )
# Custom help category
_HELP_CATEGORY = 'gpg'
class gpg(object): class gpg(object):
def __init__(self, path, key=None): def __init__(self, path, key=None):
self.path = path self.path = path
self.key = (key and " --local-user \"%s\"" % key) or "" self.key = (key and " --local-user \"%s\"" % key) or ""
def sign(self, data): def sign(self, data):
gpgcmd = "%s --sign --detach-sign%s" % (self.path, self.key) gpgcmd = "%s --sign --detach-sign%s" % (self.path, self.key)
return procutil.filter(data, gpgcmd) return procutil.filter(data, gpgcmd)
ui.write(_("%s Note: Signature has expired" ui.write(_("%s Note: Signature has expired"
" (signed by: \"%s\")\n") % (prefix, key[2])) " (signed by: \"%s\")\n") % (prefix, key[2]))
elif key[0] == "EXPKEYSIG": elif key[0] == "EXPKEYSIG":
ui.write(_("%s Note: This key has expired" ui.write(_("%s Note: This key has expired"
" (signed by: \"%s\")\n") % (prefix, key[2])) " (signed by: \"%s\")\n") % (prefix, key[2]))
validkeys.append((key[1], key[2], key[3])) validkeys.append((key[1], key[2], key[3]))
return validkeys return validkeys
@command("sigs", [], _('hg sigs')) @command("sigs", [], _('hg sigs'), helpcategory=_HELP_CATEGORY)
def sigs(ui, repo): def sigs(ui, repo):
"""list signed changesets""" """list signed changesets"""
mygpg = newgpg(ui) mygpg = newgpg(ui)
revs = {} revs = {}
for data, context in sigwalk(repo): for data, context in sigwalk(repo):
node, version, sig = data node, version, sig = data
fn, ln = context fn, ln = context
try: try:
n = repo.lookup(node) n = repo.lookup(node)
except KeyError: except KeyError:
ui.warn(_("%s:%d node does not exist\n") % (fn, ln)) ui.warn(_("%s:%d node does not exist\n") % (fn, ln))
continue continue
r = repo.changelog.rev(n) r = repo.changelog.rev(n)
keys = getkeys(ui, repo, mygpg, data, context) keys = getkeys(ui, repo, mygpg, data, context)
if not keys: if not keys:
continue continue
revs.setdefault(r, []) revs.setdefault(r, [])
revs[r].extend(keys) revs[r].extend(keys)
for rev in sorted(revs, reverse=True): for rev in sorted(revs, reverse=True):
for k in revs[rev]: for k in revs[rev]:
r = "%5d:%s" % (rev, hgnode.hex(repo.changelog.node(rev))) r = "%5d:%s" % (rev, hgnode.hex(repo.changelog.node(rev)))
ui.write("%-30s %s\n" % (keystr(ui, k), r)) ui.write("%-30s %s\n" % (keystr(ui, k), r))
@command("sigcheck", [], _('hg sigcheck REV')) @command("sigcheck", [], _('hg sigcheck REV'), helpcategory=_HELP_CATEGORY)
def sigcheck(ui, repo, rev): def sigcheck(ui, repo, rev):
"""verify all the signatures there may be for a particular revision""" """verify all the signatures there may be for a particular revision"""
mygpg = newgpg(ui) mygpg = newgpg(ui)
rev = repo.lookup(rev) rev = repo.lookup(rev)
hexrev = hgnode.hex(rev) hexrev = hgnode.hex(rev)
keys = [] keys = []
for data, context in sigwalk(repo): for data, context in sigwalk(repo):
('f', 'force', None, _('sign even if the sigfile is modified')), ('f', 'force', None, _('sign even if the sigfile is modified')),
('', 'no-commit', None, _('do not commit the sigfile after signing')), ('', 'no-commit', None, _('do not commit the sigfile after signing')),
('k', 'key', '', ('k', 'key', '',
_('the key id to sign with'), _('ID')), _('the key id to sign with'), _('ID')),
('m', 'message', '', ('m', 'message', '',
_('use text as commit message'), _('TEXT')), _('use text as commit message'), _('TEXT')),
('e', 'edit', False, _('invoke editor on commit messages')), ('e', 'edit', False, _('invoke editor on commit messages')),
] + cmdutil.commitopts2, ] + cmdutil.commitopts2,
_('hg sign [OPTION]... [REV]...')) _('hg sign [OPTION]... [REV]...'),
helpcategory=_HELP_CATEGORY)
def sign(ui, repo, *revs, **opts): def sign(ui, repo, *revs, **opts):
"""add a signature for the current or given revision """add a signature for the current or given revision
If no revision is given, the parent of the working directory is used, If no revision is given, the parent of the working directory is used,
or tip if no revision is checked out. or tip if no revision is checked out.
The ``gpg.cmd`` config setting can be used to specify the command The ``gpg.cmd`` config setting can be used to specify the command
to run. A default key can be specified with ``gpg.key``. to run. A default key can be specified with ``gpg.key``.
raise error.Abort(pycompat.bytestr(inst)) raise error.Abort(pycompat.bytestr(inst))
def node2txt(repo, node, ver): def node2txt(repo, node, ver):
"""map a manifest into some text""" """map a manifest into some text"""
if ver == "0": if ver == "0":
return "%s\n" % hgnode.hex(node) return "%s\n" % hgnode.hex(node)
else: else:
raise error.Abort(_("unknown signature version")) raise error.Abort(_("unknown signature version"))
def extsetup(ui):
# Add our category before "Repository maintenance".
help.CATEGORY_ORDER.insert(
help.CATEGORY_ORDER.index(command.CATEGORY_MAINTENANCE),
_HELP_CATEGORY)
help.CATEGORY_NAMES[_HELP_CATEGORY] = 'GPG signing'

hgext/graphlog.py

_('show only changesets within the given named branch (DEPRECATED)'), _('show only changesets within the given named branch (DEPRECATED)'),
_('BRANCH')), _('BRANCH')),
('b', 'branch', [], ('b', 'branch', [],
_('show changesets within the given named branch'), _('BRANCH')), _('show changesets within the given named branch'), _('BRANCH')),
('P', 'prune', [], ('P', 'prune', [],
_('do not display revision or any of its ancestors'), _('REV')), _('do not display revision or any of its ancestors'), _('REV')),
] + cmdutil.logopts + cmdutil.walkopts, ] + cmdutil.logopts + cmdutil.walkopts,
_('[OPTION]... [FILE]'), _('[OPTION]... [FILE]'),
helpcategory=command.CATEGORY_CHANGE_NAVIGATION,
inferrepo=True) inferrepo=True)
def glog(ui, repo, *pats, **opts): def glog(ui, repo, *pats, **opts):
"""show revision history alongside an ASCII revision graph """show revision history alongside an ASCII revision graph
Print a revision history alongside a revision graph drawn with Print a revision history alongside a revision graph drawn with
ASCII characters. ASCII characters.
Nodes printed as an @ character are parents of the working Nodes printed as an @ character are parents of the working
directory. directory.
This is an alias to :hg:`log -G`. This is an alias to :hg:`log -G`.
""" """
opts[r'graph'] = True opts[r'graph'] = True
return commands.log(ui, repo, *pats, **opts) return commands.log(ui, repo, *pats, **opts)

hgext/hgk.py

else: else:
full = None full = None
copy = [x for x in revs] copy = [x for x in revs]
revtree(ui, copy, repo, full, opts[r'max_count'], opts[r'parents']) revtree(ui, copy, repo, full, opts[r'max_count'], opts[r'parents'])
@command('view', @command('view',
[('l', 'limit', '', [('l', 'limit', '',
_('limit number of changes displayed'), _('NUM'))], _('limit number of changes displayed'), _('NUM'))],
_('[-l LIMIT] [REVRANGE]')) _('[-l LIMIT] [REVRANGE]'),
helpcategory=command.CATEGORY_CHANGE_NAVIGATION)
def view(ui, repo, *etc, **opts): def view(ui, repo, *etc, **opts):
"start interactive history viewer" "start interactive history viewer"
opts = pycompat.byteskwargs(opts) opts = pycompat.byteskwargs(opts)
os.chdir(repo.root) os.chdir(repo.root)
optstr = ' '.join(['--%s %s' % (k, v) for k, v in opts.iteritems() if v]) optstr = ' '.join(['--%s %s' % (k, v) for k, v in opts.iteritems() if v])
if repo.filtername is None: if repo.filtername is None:
optstr += '--hidden' optstr += '--hidden'
cmd = ui.config("hgk", "path") + " %s %s" % (optstr, " ".join(etc)) cmd = ui.config("hgk", "path") + " %s %s" % (optstr, " ".join(etc))
ui.debug("running %s\n" % cmd) ui.debug("running %s\n" % cmd)
ui.system(cmd, blockedtag='hgk_view') ui.system(cmd, blockedtag='hgk_view')

hgext/histedit.py

('k', 'keep', False, ('k', 'keep', False,
_("don't strip old nodes after edit is complete")), _("don't strip old nodes after edit is complete")),
('', 'abort', False, _('abort an edit in progress')), ('', 'abort', False, _('abort an edit in progress')),
('o', 'outgoing', False, _('changesets not found in destination')), ('o', 'outgoing', False, _('changesets not found in destination')),
('f', 'force', False, ('f', 'force', False,
_('force outgoing even for unrelated repositories')), _('force outgoing even for unrelated repositories')),
('r', 'rev', [], _('first revision to be edited'), _('REV'))] + ('r', 'rev', [], _('first revision to be edited'), _('REV'))] +
cmdutil.formatteropts, cmdutil.formatteropts,
_("[OPTIONS] ([ANCESTOR] | --outgoing [URL])")) _("[OPTIONS] ([ANCESTOR] | --outgoing [URL])"),
helpcategory=command.CATEGORY_CHANGE_MANAGEMENT)
def histedit(ui, repo, *freeargs, **opts): def histedit(ui, repo, *freeargs, **opts):
"""interactively edit changeset history """interactively edit changeset history
This command lets you edit a linear series of changesets (up to This command lets you edit a linear series of changesets (up to
and including the working directory, which should be clean). and including the working directory, which should be clean).
You can: You can:
- `pick` to [re]order a changeset - `pick` to [re]order a changeset

hgext/journal.py

# journal reading # journal reading
# log options that don't make sense for journal # log options that don't make sense for journal
_ignoreopts = ('no-merges', 'graph') _ignoreopts = ('no-merges', 'graph')
@command( @command(
'journal', [ 'journal', [
('', 'all', None, 'show history for all names'), ('', 'all', None, 'show history for all names'),
('c', 'commits', None, 'show commit metadata'), ('c', 'commits', None, 'show commit metadata'),
] + [opt for opt in cmdutil.logopts if opt[1] not in _ignoreopts], ] + [opt for opt in cmdutil.logopts if opt[1] not in _ignoreopts],
'[OPTION]... [BOOKMARKNAME]') '[OPTION]... [BOOKMARKNAME]',
helpcategory=command.CATEGORY_CHANGE_ORGANIZATION)
def journal(ui, repo, *args, **opts): def journal(ui, repo, *args, **opts):
"""show the previous position of bookmarks and the working copy """show the previous position of bookmarks and the working copy
The journal is used to see the previous commits that bookmarks and the The journal is used to see the previous commits that bookmarks and the
working copy pointed to. By default the previous locations for the working working copy pointed to. By default the previous locations for the working
copy. Passing a bookmark name will show all the previous positions of copy. Passing a bookmark name will show all the previous positions of
that bookmark. Use the --all switch to show previous locations for all that bookmark. Use the --all switch to show previous locations for all
bookmarks and the working copy; each line will then include the bookmark bookmarks and the working copy; each line will then include the bookmark

hgext/mq.py

opts = dict(opts) opts = dict(opts)
opts['keep_changes'] = True opts['keep_changes'] = True
return opts return opts
@command("qdelete|qremove|qrm", @command("qdelete|qremove|qrm",
[('k', 'keep', None, _('keep patch file')), [('k', 'keep', None, _('keep patch file')),
('r', 'rev', [], ('r', 'rev', [],
_('stop managing a revision (DEPRECATED)'), _('REV'))], _('stop managing a revision (DEPRECATED)'), _('REV'))],
_('hg qdelete [-k] [PATCH]...')) _('hg qdelete [-k] [PATCH]...'),
helpcategory=command.CATEGORY_CHANGE_ORGANIZATION)
def delete(ui, repo, *patches, **opts): def delete(ui, repo, *patches, **opts):
"""remove patches from queue """remove patches from queue
The patches must not be applied, and at least one patch is required. Exact The patches must not be applied, and at least one patch is required. Exact
patch identifiers must be given. With -k/--keep, the patch files are patch identifiers must be given. With -k/--keep, the patch files are
preserved in the patch directory. preserved in the patch directory.
To stop managing a patch and move it into permanent history, To stop managing a patch and move it into permanent history,
use the :hg:`qfinish` command.""" use the :hg:`qfinish` command."""
q = repo.mq q = repo.mq
q.delete(repo, patches, pycompat.byteskwargs(opts)) q.delete(repo, patches, pycompat.byteskwargs(opts))
q.savedirty() q.savedirty()
return 0 return 0
@command("qapplied", @command("qapplied",
[('1', 'last', None, _('show only the preceding applied patch')) [('1', 'last', None, _('show only the preceding applied patch'))
] + seriesopts, ] + seriesopts,
_('hg qapplied [-1] [-s] [PATCH]')) _('hg qapplied [-1] [-s] [PATCH]'),
helpcategory=command.CATEGORY_CHANGE_ORGANIZATION)
def applied(ui, repo, patch=None, **opts): def applied(ui, repo, patch=None, **opts):
"""print the patches already applied """print the patches already applied
Returns 0 on success.""" Returns 0 on success."""
q = repo.mq q = repo.mq
opts = pycompat.byteskwargs(opts) opts = pycompat.byteskwargs(opts)
start = 0 start = 0
q.qseries(repo, length=end, start=start, status='A', q.qseries(repo, length=end, start=start, status='A',
summary=opts.get('summary')) summary=opts.get('summary'))
@command("qunapplied", @command("qunapplied",
[('1', 'first', None, _('show only the first patch'))] + seriesopts, [('1', 'first', None, _('show only the first patch'))] + seriesopts,
_('hg qunapplied [-1] [-s] [PATCH]')) _('hg qunapplied [-1] [-s] [PATCH]'),
helpcategory=command.CATEGORY_CHANGE_ORGANIZATION)
def unapplied(ui, repo, patch=None, **opts): def unapplied(ui, repo, patch=None, **opts):
"""print the patches not yet applied """print the patches not yet applied
Returns 0 on success.""" Returns 0 on success."""
q = repo.mq q = repo.mq
opts = pycompat.byteskwargs(opts) opts = pycompat.byteskwargs(opts)
if patch: if patch:
[('e', 'existing', None, _('import file in patch directory')), [('e', 'existing', None, _('import file in patch directory')),
('n', 'name', '', ('n', 'name', '',
_('name of patch file'), _('NAME')), _('name of patch file'), _('NAME')),
('f', 'force', None, _('overwrite existing files')), ('f', 'force', None, _('overwrite existing files')),
('r', 'rev', [], ('r', 'rev', [],
_('place existing revisions under mq control'), _('REV')), _('place existing revisions under mq control'), _('REV')),
('g', 'git', None, _('use git extended diff format')), ('g', 'git', None, _('use git extended diff format')),
('P', 'push', None, _('qpush after importing'))], ('P', 'push', None, _('qpush after importing'))],
_('hg qimport [-e] [-n NAME] [-f] [-g] [-P] [-r REV]... [FILE]...')) _('hg qimport [-e] [-n NAME] [-f] [-g] [-P] [-r REV]... [FILE]...'),
helpcategory=command.CATEGORY_IMPORT_EXPORT)
def qimport(ui, repo, *filename, **opts): def qimport(ui, repo, *filename, **opts):
"""import a patch or existing changeset """import a patch or existing changeset
The patch is inserted into the series after the last applied The patch is inserted into the series after the last applied
patch. If no patches have been applied, qimport prepends the patch patch. If no patches have been applied, qimport prepends the patch
to the series. to the series.
The patch will have the same name as its source file unless you The patch will have the same name as its source file unless you
if not os.path.exists(r.wjoin('series')): if not os.path.exists(r.wjoin('series')):
r.wvfs('series', 'w').close() r.wvfs('series', 'w').close()
r[None].add(['.hgignore', 'series']) r[None].add(['.hgignore', 'series'])
commands.add(ui, r) commands.add(ui, r)
return 0 return 0
@command("^qinit", @command("^qinit",
[('c', 'create-repo', None, _('create queue repository'))], [('c', 'create-repo', None, _('create queue repository'))],
_('hg qinit [-c]')) _('hg qinit [-c]'),
helpcategory=command.CATEGORY_REPO_CREATION)
def init(ui, repo, **opts): def init(ui, repo, **opts):
"""init a new queue repository (DEPRECATED) """init a new queue repository (DEPRECATED)
The queue repository is unversioned by default. If The queue repository is unversioned by default. If
-c/--create-repo is specified, qinit will create a separate nested -c/--create-repo is specified, qinit will create a separate nested
repository for patches (qinit -c may also be run later to convert repository for patches (qinit -c may also be run later to convert
an unversioned patch repository into a versioned one). You can use an unversioned patch repository into a versioned one). You can use
qcommit to commit changes to this queue repository. qcommit to commit changes to this queue repository.
This command is deprecated. Without -c, it's implied by other relevant This command is deprecated. Without -c, it's implied by other relevant
commands. With -c, use :hg:`init --mq` instead.""" commands. With -c, use :hg:`init --mq` instead."""
return qinit(ui, repo, create=opts.get(r'create_repo')) return qinit(ui, repo, create=opts.get(r'create_repo'))
@command("qclone", @command("qclone",
[('', 'pull', None, _('use pull protocol to copy metadata')), [('', 'pull', None, _('use pull protocol to copy metadata')),
('U', 'noupdate', None, ('U', 'noupdate', None,
_('do not update the new working directories')), _('do not update the new working directories')),
('', 'uncompressed', None, ('', 'uncompressed', None,
_('use uncompressed transfer (fast over LAN)')), _('use uncompressed transfer (fast over LAN)')),
('p', 'patches', '', ('p', 'patches', '',
_('location of source patch repository'), _('REPO')), _('location of source patch repository'), _('REPO')),
] + cmdutil.remoteopts, ] + cmdutil.remoteopts,
_('hg qclone [OPTION]... SOURCE [DEST]'), _('hg qclone [OPTION]... SOURCE [DEST]'),
helpcategory=command.CATEGORY_REPO_CREATION,
norepo=True) norepo=True)
def clone(ui, source, dest=None, **opts): def clone(ui, source, dest=None, **opts):
'''clone main and patch repository at same time '''clone main and patch repository at same time
If source is local, destination will have no patches applied. If If source is local, destination will have no patches applied. If
source is remote, this command can not check if patches are source is remote, this command can not check if patches are
applied in source, so cannot guarantee that patches are not applied in source, so cannot guarantee that patches are not
applied in destination. If you clone remote repository, be sure applied in destination. If you clone remote repository, be sure
strip(ui, repo, [qbase], update=False, backup=None) strip(ui, repo, [qbase], update=False, backup=None)
if not opts.get('noupdate'): if not opts.get('noupdate'):
ui.note(_('updating destination repository\n')) ui.note(_('updating destination repository\n'))
hg.update(repo, repo.changelog.tip()) hg.update(repo, repo.changelog.tip())
@command("qcommit|qci", @command("qcommit|qci",
commands.table["^commit|ci"][1], commands.table["^commit|ci"][1],
_('hg qcommit [OPTION]... [FILE]...'), _('hg qcommit [OPTION]... [FILE]...'),
helpcategory=command.CATEGORY_COMMITTING,
inferrepo=True) inferrepo=True)
def commit(ui, repo, *pats, **opts): def commit(ui, repo, *pats, **opts):
"""commit changes in the queue repository (DEPRECATED) """commit changes in the queue repository (DEPRECATED)
This command is deprecated; use :hg:`commit --mq` instead.""" This command is deprecated; use :hg:`commit --mq` instead."""
q = repo.mq q = repo.mq
r = q.qrepo() r = q.qrepo()
if not r: if not r:
raise error.Abort('no queue repository') raise error.Abort('no queue repository')
commands.commit(r.ui, r, *pats, **opts) commands.commit(r.ui, r, *pats, **opts)
@command("qseries", @command("qseries",
[('m', 'missing', None, _('print patches not in series')), [('m', 'missing', None, _('print patches not in series')),
] + seriesopts, ] + seriesopts,
_('hg qseries [-ms]')) _('hg qseries [-ms]'),
helpcategory=command.CATEGORY_CHANGE_ORGANIZATION)
def series(ui, repo, **opts): def series(ui, repo, **opts):
"""print the entire series file """print the entire series file
Returns 0 on success.""" Returns 0 on success."""
repo.mq.qseries(repo, missing=opts.get(r'missing'), repo.mq.qseries(repo, missing=opts.get(r'missing'),
summary=opts.get(r'summary')) summary=opts.get(r'summary'))
return 0 return 0
@command("qtop", seriesopts, _('hg qtop [-s]')) @command("qtop", seriesopts, _('hg qtop [-s]'),
helpcategory=command.CATEGORY_CHANGE_ORGANIZATION)
def top(ui, repo, **opts): def top(ui, repo, **opts):
"""print the name of the current patch """print the name of the current patch
Returns 0 on success.""" Returns 0 on success."""
q = repo.mq q = repo.mq
if q.applied: if q.applied:
t = q.seriesend(True) t = q.seriesend(True)
else: else:
t = 0 t = 0
if t: if t:
q.qseries(repo, start=t - 1, length=1, status='A', q.qseries(repo, start=t - 1, length=1, status='A',
summary=opts.get(r'summary')) summary=opts.get(r'summary'))
else: else:
ui.write(_("no patches applied\n")) ui.write(_("no patches applied\n"))
return 1 return 1
@command("qnext", seriesopts, _('hg qnext [-s]')) @command("qnext", seriesopts, _('hg qnext [-s]'),
helpcategory=command.CATEGORY_CHANGE_ORGANIZATION)
def next(ui, repo, **opts): def next(ui, repo, **opts):
"""print the name of the next pushable patch """print the name of the next pushable patch
Returns 0 on success.""" Returns 0 on success."""
q = repo.mq q = repo.mq
end = q.seriesend() end = q.seriesend()
if end == len(q.series): if end == len(q.series):
ui.write(_("all patches applied\n")) ui.write(_("all patches applied\n"))
return 1 return 1
q.qseries(repo, start=end, length=1, summary=opts.get(r'summary')) q.qseries(repo, start=end, length=1, summary=opts.get(r'summary'))
@command("qprev", seriesopts, _('hg qprev [-s]')) @command("qprev", seriesopts, _('hg qprev [-s]'),
helpcategory=command.CATEGORY_CHANGE_ORGANIZATION)
def prev(ui, repo, **opts): def prev(ui, repo, **opts):
"""print the name of the preceding applied patch """print the name of the preceding applied patch
Returns 0 on success.""" Returns 0 on success."""
q = repo.mq q = repo.mq
l = len(q.applied) l = len(q.applied)
if l == 1: if l == 1:
ui.write(_("only one patch applied\n")) ui.write(_("only one patch applied\n"))
('U', 'currentuser', None, _('add "From: <current user>" to patch')), ('U', 'currentuser', None, _('add "From: <current user>" to patch')),
('u', 'user', '', ('u', 'user', '',
_('add "From: <USER>" to patch'), _('USER')), _('add "From: <USER>" to patch'), _('USER')),
('D', 'currentdate', None, _('add "Date: <current date>" to patch')), ('D', 'currentdate', None, _('add "Date: <current date>" to patch')),
('d', 'date', '', ('d', 'date', '',
_('add "Date: <DATE>" to patch'), _('DATE')) _('add "Date: <DATE>" to patch'), _('DATE'))
] + cmdutil.walkopts + cmdutil.commitopts, ] + cmdutil.walkopts + cmdutil.commitopts,
_('hg qnew [-e] [-m TEXT] [-l FILE] PATCH [FILE]...'), _('hg qnew [-e] [-m TEXT] [-l FILE] PATCH [FILE]...'),
helpcategory=command.CATEGORY_COMMITTING,
inferrepo=True) inferrepo=True)
def new(ui, repo, patch, *args, **opts): def new(ui, repo, patch, *args, **opts):
"""create a new patch """create a new patch
qnew creates a new patch on top of the currently-applied patch (if qnew creates a new patch on top of the currently-applied patch (if
any). The patch will be initialized with any outstanding changes any). The patch will be initialized with any outstanding changes
in the working directory. You may also use -I/--include, in the working directory. You may also use -I/--include,
-X/--exclude, and/or a list of files after the patch name to add -X/--exclude, and/or a list of files after the patch name to add
('u', 'user', '', ('u', 'user', '',
_('add/update author field in patch with given user'), _('USER')), _('add/update author field in patch with given user'), _('USER')),
('D', 'currentdate', None, ('D', 'currentdate', None,
_('add/update date field in patch with current date')), _('add/update date field in patch with current date')),
('d', 'date', '', ('d', 'date', '',
_('add/update date field in patch with given date'), _('DATE')) _('add/update date field in patch with given date'), _('DATE'))
] + cmdutil.walkopts + cmdutil.commitopts, ] + cmdutil.walkopts + cmdutil.commitopts,
_('hg qrefresh [-I] [-X] [-e] [-m TEXT] [-l FILE] [-s] [FILE]...'), _('hg qrefresh [-I] [-X] [-e] [-m TEXT] [-l FILE] [-s] [FILE]...'),
helpcategory=command.CATEGORY_COMMITTING,
inferrepo=True) inferrepo=True)
def refresh(ui, repo, *pats, **opts): def refresh(ui, repo, *pats, **opts):
"""update the current patch """update the current patch
If any file patterns are provided, the refreshed patch will If any file patterns are provided, the refreshed patch will
contain only the modifications that match those patterns; the contain only the modifications that match those patterns; the
remaining modifications will remain in the working directory. remaining modifications will remain in the working directory.
with repo.wlock(): with repo.wlock():
ret = q.refresh(repo, pats, msg=message, **pycompat.strkwargs(opts)) ret = q.refresh(repo, pats, msg=message, **pycompat.strkwargs(opts))
q.savedirty() q.savedirty()
return ret return ret
@command("^qdiff", @command("^qdiff",
cmdutil.diffopts + cmdutil.diffopts2 + cmdutil.walkopts, cmdutil.diffopts + cmdutil.diffopts2 + cmdutil.walkopts,
_('hg qdiff [OPTION]... [FILE]...'), _('hg qdiff [OPTION]... [FILE]...'),
helpcategory=command.CATEGORY_FILE_CONTENTS,
inferrepo=True) inferrepo=True)
def diff(ui, repo, *pats, **opts): def diff(ui, repo, *pats, **opts):
"""diff of the current patch and subsequent modifications """diff of the current patch and subsequent modifications
Shows a diff which includes the current patch as well as any Shows a diff which includes the current patch as well as any
changes which have been made in the working directory since the changes which have been made in the working directory since the
last refresh (thus showing what the current patch would become last refresh (thus showing what the current patch would become
after a qrefresh). after a qrefresh).
Use :hg:`diff` if you only want to see the changes made since the Use :hg:`diff` if you only want to see the changes made since the
last qrefresh, or :hg:`export qtip` if you want to see changes last qrefresh, or :hg:`export qtip` if you want to see changes
made by the current patch without including changes made since the made by the current patch without including changes made since the
qrefresh. qrefresh.
Returns 0 on success. Returns 0 on success.
""" """
ui.pager('qdiff') ui.pager('qdiff')
repo.mq.diff(repo, pats, pycompat.byteskwargs(opts)) repo.mq.diff(repo, pats, pycompat.byteskwargs(opts))
return 0 return 0
@command('qfold', @command('qfold',
[('e', 'edit', None, _('invoke editor on commit messages')), [('e', 'edit', None, _('invoke editor on commit messages')),
('k', 'keep', None, _('keep folded patch files')), ('k', 'keep', None, _('keep folded patch files')),
] + cmdutil.commitopts, ] + cmdutil.commitopts,
_('hg qfold [-e] [-k] [-m TEXT] [-l FILE] PATCH...')) _('hg qfold [-e] [-k] [-m TEXT] [-l FILE] PATCH...'),
helpcategory=command.CATEGORY_CHANGE_MANAGEMENT)
def fold(ui, repo, *files, **opts): def fold(ui, repo, *files, **opts):
"""fold the named patches into the current patch """fold the named patches into the current patch
Patches must not yet be applied. Each patch will be successively Patches must not yet be applied. Each patch will be successively
applied to the current patch in the order given. If all the applied to the current patch in the order given. If all the
patches apply successfully, the current patch will be refreshed patches apply successfully, the current patch will be refreshed
with the new cumulative patch, and the folded patches will be with the new cumulative patch, and the folded patches will be
deleted. With -k/--keep, the folded patch files will not be deleted. With -k/--keep, the folded patch files will not be
q.delete(repo, patches, opts) q.delete(repo, patches, opts)
q.savedirty() q.savedirty()
@command("qgoto", @command("qgoto",
[('', 'keep-changes', None, [('', 'keep-changes', None,
_('tolerate non-conflicting local changes')), _('tolerate non-conflicting local changes')),
('f', 'force', None, _('overwrite any local changes')), ('f', 'force', None, _('overwrite any local changes')),
('', 'no-backup', None, _('do not save backup copies of files'))], ('', 'no-backup', None, _('do not save backup copies of files'))],
_('hg qgoto [OPTION]... PATCH')) _('hg qgoto [OPTION]... PATCH'),
helpcategory=command.CATEGORY_CHANGE_ORGANIZATION)
def goto(ui, repo, patch, **opts): def goto(ui, repo, patch, **opts):
'''push or pop patches until named patch is at top of stack '''push or pop patches until named patch is at top of stack
Returns 0 on success.''' Returns 0 on success.'''
opts = pycompat.byteskwargs(opts) opts = pycompat.byteskwargs(opts)
opts = fixkeepchangesopts(ui, opts) opts = fixkeepchangesopts(ui, opts)
q = repo.mq q = repo.mq
patch = q.lookup(patch) patch = q.lookup(patch)
nobackup = opts.get('no_backup') nobackup = opts.get('no_backup')
keepchanges = opts.get('keep_changes') keepchanges = opts.get('keep_changes')
if q.isapplied(patch): if q.isapplied(patch):
ret = q.pop(repo, patch, force=opts.get('force'), nobackup=nobackup, ret = q.pop(repo, patch, force=opts.get('force'), nobackup=nobackup,
keepchanges=keepchanges) keepchanges=keepchanges)
else: else:
ret = q.push(repo, patch, force=opts.get('force'), nobackup=nobackup, ret = q.push(repo, patch, force=opts.get('force'), nobackup=nobackup,
keepchanges=keepchanges) keepchanges=keepchanges)
q.savedirty() q.savedirty()
return ret return ret
@command("qguard", @command("qguard",
[('l', 'list', None, _('list all patches and guards')), [('l', 'list', None, _('list all patches and guards')),
('n', 'none', None, _('drop all guards'))], ('n', 'none', None, _('drop all guards'))],
_('hg qguard [-l] [-n] [PATCH] [-- [+GUARD]... [-GUARD]...]')) _('hg qguard [-l] [-n] [PATCH] [-- [+GUARD]... [-GUARD]...]'),
helpcategory=command.CATEGORY_CHANGE_ORGANIZATION)
def guard(ui, repo, *args, **opts): def guard(ui, repo, *args, **opts):
'''set or print guards for a patch '''set or print guards for a patch
Guards control whether a patch can be pushed. A patch with no Guards control whether a patch can be pushed. A patch with no
guards is always pushed. A patch with a positive guard ("+foo") is guards is always pushed. A patch with a positive guard ("+foo") is
pushed only if the :hg:`qselect` command has activated it. A patch with pushed only if the :hg:`qselect` command has activated it. A patch with
a negative guard ("-foo") is never pushed if the :hg:`qselect` command a negative guard ("-foo") is never pushed if the :hg:`qselect` command
has activated it. has activated it.
idx = q.findseries(patch) idx = q.findseries(patch)
if idx is None: if idx is None:
raise error.Abort(_('no patch named %s') % patch) raise error.Abort(_('no patch named %s') % patch)
q.setguards(idx, args) q.setguards(idx, args)
q.savedirty() q.savedirty()
else: else:
status(q.series.index(q.lookup(patch))) status(q.series.index(q.lookup(patch)))
@command("qheader", [], _('hg qheader [PATCH]')) @command("qheader", [], _('hg qheader [PATCH]'),
helpcategory=command.CATEGORY_CHANGE_ORGANIZATION)
def header(ui, repo, patch=None): def header(ui, repo, patch=None):
"""print the header of the topmost or specified patch """print the header of the topmost or specified patch
Returns 0 on success.""" Returns 0 on success."""
q = repo.mq q = repo.mq
if patch: if patch:
patch = q.lookup(patch) patch = q.lookup(patch)
('l', 'list', None, _('list patch name in commit text')), ('l', 'list', None, _('list patch name in commit text')),
('a', 'all', None, _('apply all patches')), ('a', 'all', None, _('apply all patches')),
('m', 'merge', None, _('merge from another queue (DEPRECATED)')), ('m', 'merge', None, _('merge from another queue (DEPRECATED)')),
('n', 'name', '', ('n', 'name', '',
_('merge queue name (DEPRECATED)'), _('NAME')), _('merge queue name (DEPRECATED)'), _('NAME')),
('', 'move', None, ('', 'move', None,
_('reorder patch series and apply only the patch')), _('reorder patch series and apply only the patch')),
('', 'no-backup', None, _('do not save backup copies of files'))], ('', 'no-backup', None, _('do not save backup copies of files'))],
_('hg qpush [-f] [-l] [-a] [--move] [PATCH | INDEX]')) _('hg qpush [-f] [-l] [-a] [--move] [PATCH | INDEX]'),
helpcategory=command.CATEGORY_CHANGE_ORGANIZATION)
def push(ui, repo, patch=None, **opts): def push(ui, repo, patch=None, **opts):
"""push the next patch onto the stack """push the next patch onto the stack
By default, abort if the working directory contains uncommitted By default, abort if the working directory contains uncommitted
changes. With --keep-changes, abort only if the uncommitted files changes. With --keep-changes, abort only if the uncommitted files
overlap with patched files. With -f/--force, backup and patch over overlap with patched files. With -f/--force, backup and patch over
uncommitted changes. uncommitted changes.
@command("^qpop", @command("^qpop",
[('a', 'all', None, _('pop all patches')), [('a', 'all', None, _('pop all patches')),
('n', 'name', '', ('n', 'name', '',
_('queue name to pop (DEPRECATED)'), _('NAME')), _('queue name to pop (DEPRECATED)'), _('NAME')),
('', 'keep-changes', None, ('', 'keep-changes', None,
_('tolerate non-conflicting local changes')), _('tolerate non-conflicting local changes')),
('f', 'force', None, _('forget any local changes to patched files')), ('f', 'force', None, _('forget any local changes to patched files')),
('', 'no-backup', None, _('do not save backup copies of files'))], ('', 'no-backup', None, _('do not save backup copies of files'))],
_('hg qpop [-a] [-f] [PATCH | INDEX]')) _('hg qpop [-a] [-f] [PATCH | INDEX]'),
helpcategory=command.CATEGORY_CHANGE_ORGANIZATION)
def pop(ui, repo, patch=None, **opts): def pop(ui, repo, patch=None, **opts):
"""pop the current patch off the stack """pop the current patch off the stack
Without argument, pops off the top of the patch stack. If given a Without argument, pops off the top of the patch stack. If given a
patch name, keeps popping off patches until the named patch is at patch name, keeps popping off patches until the named patch is at
the top of the stack. the top of the stack.
By default, abort if the working directory contains uncommitted By default, abort if the working directory contains uncommitted
else: else:
q = repo.mq q = repo.mq
ret = q.pop(repo, patch, force=opts.get('force'), update=localupdate, ret = q.pop(repo, patch, force=opts.get('force'), update=localupdate,
all=opts.get('all'), nobackup=opts.get('no_backup'), all=opts.get('all'), nobackup=opts.get('no_backup'),
keepchanges=opts.get('keep_changes')) keepchanges=opts.get('keep_changes'))
q.savedirty() q.savedirty()
return ret return ret
@command("qrename|qmv", [], _('hg qrename PATCH1 [PATCH2]')) @command("qrename|qmv", [], _('hg qrename PATCH1 [PATCH2]'),
helpcategory=command.CATEGORY_CHANGE_ORGANIZATION)
def rename(ui, repo, patch, name=None, **opts): def rename(ui, repo, patch, name=None, **opts):
"""rename a patch """rename a patch
With one argument, renames the current patch to PATCH1. With one argument, renames the current patch to PATCH1.
With two arguments, renames PATCH1 to PATCH2. With two arguments, renames PATCH1 to PATCH2.
Returns 0 on success.""" Returns 0 on success."""
q = repo.mq q = repo.mq
wctx.copy(patch, name) wctx.copy(patch, name)
wctx.forget([patch]) wctx.forget([patch])
q.savedirty() q.savedirty()
@command("qrestore", @command("qrestore",
[('d', 'delete', None, _('delete save entry')), [('d', 'delete', None, _('delete save entry')),
('u', 'update', None, _('update queue working directory'))], ('u', 'update', None, _('update queue working directory'))],
_('hg qrestore [-d] [-u] REV')) _('hg qrestore [-d] [-u] REV'),
helpcategory=command.CATEGORY_CHANGE_ORGANIZATION)
def restore(ui, repo, rev, **opts): def restore(ui, repo, rev, **opts):
"""restore the queue state saved by a revision (DEPRECATED) """restore the queue state saved by a revision (DEPRECATED)
This command is deprecated, use :hg:`rebase` instead.""" This command is deprecated, use :hg:`rebase` instead."""
rev = repo.lookup(rev) rev = repo.lookup(rev)
q = repo.mq q = repo.mq
q.restore(repo, rev, delete=opts.get(r'delete'), q.restore(repo, rev, delete=opts.get(r'delete'),
qupdate=opts.get(r'update')) qupdate=opts.get(r'update'))
q.savedirty() q.savedirty()
return 0 return 0
@command("qsave", @command("qsave",
[('c', 'copy', None, _('copy patch directory')), [('c', 'copy', None, _('copy patch directory')),
('n', 'name', '', ('n', 'name', '',
_('copy directory name'), _('NAME')), _('copy directory name'), _('NAME')),
('e', 'empty', None, _('clear queue status file')), ('e', 'empty', None, _('clear queue status file')),
('f', 'force', None, _('force copy'))] + cmdutil.commitopts, ('f', 'force', None, _('force copy'))] + cmdutil.commitopts,
_('hg qsave [-m TEXT] [-l FILE] [-c] [-n NAME] [-e] [-f]')) _('hg qsave [-m TEXT] [-l FILE] [-c] [-n NAME] [-e] [-f]'),
helpcategory=command.CATEGORY_CHANGE_ORGANIZATION)
def save(ui, repo, **opts): def save(ui, repo, **opts):
"""save current queue state (DEPRECATED) """save current queue state (DEPRECATED)
This command is deprecated, use :hg:`rebase` instead.""" This command is deprecated, use :hg:`rebase` instead."""
q = repo.mq q = repo.mq
opts = pycompat.byteskwargs(opts) opts = pycompat.byteskwargs(opts)
message = cmdutil.logmessage(ui, opts) message = cmdutil.logmessage(ui, opts)
ret = q.save(repo, msg=message) ret = q.save(repo, msg=message)
return 0 return 0
@command("qselect", @command("qselect",
[('n', 'none', None, _('disable all guards')), [('n', 'none', None, _('disable all guards')),
('s', 'series', None, _('list all guards in series file')), ('s', 'series', None, _('list all guards in series file')),
('', 'pop', None, _('pop to before first guarded applied patch')), ('', 'pop', None, _('pop to before first guarded applied patch')),
('', 'reapply', None, _('pop, then reapply patches'))], ('', 'reapply', None, _('pop, then reapply patches'))],
_('hg qselect [OPTION]... [GUARD]...')) _('hg qselect [OPTION]... [GUARD]...'),
helpcategory=command.CATEGORY_CHANGE_ORGANIZATION)
def select(ui, repo, *args, **opts): def select(ui, repo, *args, **opts):
'''set or print guarded patches to push '''set or print guarded patches to push
Use the :hg:`qguard` command to set or print guards on patch, then use Use the :hg:`qguard` command to set or print guards on patch, then use
qselect to tell mq which guards to use. A patch will be pushed if qselect to tell mq which guards to use. A patch will be pushed if
it has no guards or any positive guards match the currently it has no guards or any positive guards match the currently
selected guard, but will not be pushed if any negative guards selected guard, but will not be pushed if any negative guards
match the current guard. For example:: match the current guard. For example::
if reapply: if reapply:
ui.status(_('reapplying unguarded patches\n')) ui.status(_('reapplying unguarded patches\n'))
q.push(repo, reapply) q.push(repo, reapply)
finally: finally:
q.savedirty() q.savedirty()
@command("qfinish", @command("qfinish",
[('a', 'applied', None, _('finish all applied changesets'))], [('a', 'applied', None, _('finish all applied changesets'))],
_('hg qfinish [-a] [REV]...')) _('hg qfinish [-a] [REV]...'),
helpcategory=command.CATEGORY_CHANGE_ORGANIZATION)
def finish(ui, repo, *revrange, **opts): def finish(ui, repo, *revrange, **opts):
"""move applied patches into repository history """move applied patches into repository history
Finishes the specified revisions (corresponding to applied Finishes the specified revisions (corresponding to applied
patches) by moving them out of mq control into regular repository patches) by moving them out of mq control into regular repository
history. history.
Accepts a revision range or the -a/--applied option. If --applied Accepts a revision range or the -a/--applied option. If --applied
@command("qqueue", @command("qqueue",
[('l', 'list', False, _('list all available queues')), [('l', 'list', False, _('list all available queues')),
('', 'active', False, _('print name of active queue')), ('', 'active', False, _('print name of active queue')),
('c', 'create', False, _('create new queue')), ('c', 'create', False, _('create new queue')),
('', 'rename', False, _('rename active queue')), ('', 'rename', False, _('rename active queue')),
('', 'delete', False, _('delete reference to queue')), ('', 'delete', False, _('delete reference to queue')),
('', 'purge', False, _('delete queue, and remove patch dir')), ('', 'purge', False, _('delete queue, and remove patch dir')),
], ],
_('[OPTION] [QUEUE]')) _('[OPTION] [QUEUE]'),
helpcategory=command.CATEGORY_CHANGE_ORGANIZATION)
def qqueue(ui, repo, name=None, **opts): def qqueue(ui, repo, name=None, **opts):
'''manage multiple patch queues '''manage multiple patch queues
Supports switching between different patch queues, as well as creating Supports switching between different patch queues, as well as creating
new patch queues and deleting existing ones. new patch queues and deleting existing ones.
Omitting a queue name or specifying -l/--list will show you the registered Omitting a queue name or specifying -l/--list will show you the registered
queues - by default the "normal" patches queue is registered. The currently queues - by default the "normal" patches queue is registered. The currently

hgext/patchbomb.py

_('name of the bundle attachment file'), _('NAME')), _('name of the bundle attachment file'), _('NAME')),
('r', 'rev', [], _('a revision to send'), _('REV')), ('r', 'rev', [], _('a revision to send'), _('REV')),
('', 'force', None, _('run even when remote repository is unrelated ' ('', 'force', None, _('run even when remote repository is unrelated '
'(with -b/--bundle)')), '(with -b/--bundle)')),
('', 'base', [], _('a base changeset to specify instead of a destination ' ('', 'base', [], _('a base changeset to specify instead of a destination '
'(with -b/--bundle)'), _('REV')), '(with -b/--bundle)'), _('REV')),
('', 'intro', None, _('send an introduction email for a single patch')), ('', 'intro', None, _('send an introduction email for a single patch')),
] + emailopts + cmdutil.remoteopts, ] + emailopts + cmdutil.remoteopts,
_('hg email [OPTION]... [DEST]...')) _('hg email [OPTION]... [DEST]...'),
helpcategory=command.CATEGORY_IMPORT_EXPORT)
def email(ui, repo, *revs, **opts): def email(ui, repo, *revs, **opts):
'''send changesets by email '''send changesets by email
By default, diffs are sent in the format generated by By default, diffs are sent in the format generated by
:hg:`export`, one per message. The series starts with a "[PATCH 0 :hg:`export`, one per message. The series starts with a "[PATCH 0
of N]" introduction, which describes the series as a whole. of N]" introduction, which describes the series as a whole.
Each patch email has a Subject line of "[PATCH M of N] ...", using Each patch email has a Subject line of "[PATCH M of N] ...", using

hgext/purge.py

[('a', 'abort-on-err', None, _('abort if an error occurs')), [('a', 'abort-on-err', None, _('abort if an error occurs')),
('', 'all', None, _('purge ignored files too')), ('', 'all', None, _('purge ignored files too')),
('', 'dirs', None, _('purge empty directories')), ('', 'dirs', None, _('purge empty directories')),
('', 'files', None, _('purge files')), ('', 'files', None, _('purge files')),
('p', 'print', None, _('print filenames instead of deleting them')), ('p', 'print', None, _('print filenames instead of deleting them')),
('0', 'print0', None, _('end filenames with NUL, for use with xargs' ('0', 'print0', None, _('end filenames with NUL, for use with xargs'
' (implies -p/--print)')), ' (implies -p/--print)')),
] + cmdutil.walkopts, ] + cmdutil.walkopts,
_('hg purge [OPTION]... [DIR]...')) _('hg purge [OPTION]... [DIR]...'),
helpcategory=command.CATEGORY_MAINTENANCE)
def purge(ui, repo, *dirs, **opts): def purge(ui, repo, *dirs, **opts):
'''removes files not tracked by Mercurial '''removes files not tracked by Mercurial
Delete files not known to Mercurial. This is useful to test local Delete files not known to Mercurial. This is useful to test local
and uncommitted changes in an otherwise-clean source tree. and uncommitted changes in an otherwise-clean source tree.
This means that purge will delete the following by default: This means that purge will delete the following by default:

hgext/rebase.py

('i', 'interactive', False, _('(DEPRECATED)')), ('i', 'interactive', False, _('(DEPRECATED)')),
('t', 'tool', '', _('specify merge tool')), ('t', 'tool', '', _('specify merge tool')),
('', 'stop', False, _('stop interrupted rebase')), ('', 'stop', False, _('stop interrupted rebase')),
('c', 'continue', False, _('continue an interrupted rebase')), ('c', 'continue', False, _('continue an interrupted rebase')),
('a', 'abort', False, _('abort an interrupted rebase')), ('a', 'abort', False, _('abort an interrupted rebase')),
('', 'auto-orphans', '', _('automatically rebase orphan revisions ' ('', 'auto-orphans', '', _('automatically rebase orphan revisions '
'in the specified revset (EXPERIMENTAL)')), 'in the specified revset (EXPERIMENTAL)')),
] + cmdutil.dryrunopts + cmdutil.formatteropts + cmdutil.confirmopts, ] + cmdutil.dryrunopts + cmdutil.formatteropts + cmdutil.confirmopts,
_('[-s REV | -b REV] [-d REV] [OPTION]')) _('[-s REV | -b REV] [-d REV] [OPTION]'),
helpcategory=command.CATEGORY_CHANGE_MANAGEMENT)
def rebase(ui, repo, **opts): def rebase(ui, repo, **opts):
"""move changeset (and descendants) to a different branch """move changeset (and descendants) to a different branch
Rebase uses repeated merging to graft changesets from one part of Rebase uses repeated merging to graft changesets from one part of
history (the source) onto another (the destination). This can be history (the source) onto another (the destination). This can be
useful for linearizing *local* changes relative to a master useful for linearizing *local* changes relative to a master
development tree. development tree.

hgext/record.py

# leave the attribute unspecified. # leave the attribute unspecified.
testedwith = 'ships-with-hg-core' testedwith = 'ships-with-hg-core'
@command("record", @command("record",
# same options as commit + white space diff options # same options as commit + white space diff options
[c for c in commands.table['^commit|ci'][1][:] [c for c in commands.table['^commit|ci'][1][:]
if c[1] != "interactive"] + cmdutil.diffwsopts, if c[1] != "interactive"] + cmdutil.diffwsopts,
_('hg record [OPTION]... [FILE]...')) _('hg record [OPTION]... [FILE]...'),
helpcategory=command.CATEGORY_COMMITTING)
def record(ui, repo, *pats, **opts): def record(ui, repo, *pats, **opts):
'''interactively select changes to commit '''interactively select changes to commit
If a list of files is omitted, all changes reported by :hg:`status` If a list of files is omitted, all changes reported by :hg:`status`
will be candidates for recording. will be candidates for recording.
See :hg:`help dates` for a list of formats valid for -d/--date. See :hg:`help dates` for a list of formats valid for -d/--date.
# backup all changed files # backup all changed files
cmdutil.dorecord(ui, repo, committomq, None, True, cmdutil.dorecord(ui, repo, committomq, None, True,
cmdutil.recordfilter, *pats, **opts) cmdutil.recordfilter, *pats, **opts)
# This command registration is replaced during uisetup(). # This command registration is replaced during uisetup().
@command('qrecord', @command('qrecord',
[], [],
_('hg qrecord [OPTION]... PATCH [FILE]...'), _('hg qrecord [OPTION]... PATCH [FILE]...'),
helpcategory=command.CATEGORY_COMMITTING,
inferrepo=True) inferrepo=True)
def qrecord(ui, repo, patch, *pats, **opts): def qrecord(ui, repo, patch, *pats, **opts):
'''interactively record a new patch '''interactively record a new patch
See :hg:`help qnew` & :hg:`help record` for more information and See :hg:`help qnew` & :hg:`help record` for more information and
usage. usage.
''' '''
return _qrecord('qnew', ui, repo, patch, *pats, **opts) return _qrecord('qnew', ui, repo, patch, *pats, **opts)

hgext/releasenotes.py

return '\n'.join(lines) return '\n'.join(lines)
@command('releasenotes', @command('releasenotes',
[('r', 'rev', '', _('revisions to process for release notes'), _('REV')), [('r', 'rev', '', _('revisions to process for release notes'), _('REV')),
('c', 'check', False, _('checks for validity of admonitions (if any)'), ('c', 'check', False, _('checks for validity of admonitions (if any)'),
_('REV')), _('REV')),
('l', 'list', False, _('list the available admonitions with their title'), ('l', 'list', False, _('list the available admonitions with their title'),
None)], None)],
_('hg releasenotes [-r REV] [-c] FILE')) _('hg releasenotes [-r REV] [-c] FILE'),
helpcategory=command.CATEGORY_CHANGE_NAVIGATION)
def releasenotes(ui, repo, file_=None, **opts): def releasenotes(ui, repo, file_=None, **opts):
"""parse release notes from commit messages into an output file """parse release notes from commit messages into an output file
Given an output file and set of revisions, this command will parse commit Given an output file and set of revisions, this command will parse commit
messages for release notes then add them to the output file. messages for release notes then add them to the output file.
Release notes are defined in commit messages as ReStructuredText Release notes are defined in commit messages as ReStructuredText
directives. These have the form:: directives. These have the form::

hgext/relink.py

cmdtable = {} cmdtable = {}
command = registrar.command(cmdtable) command = registrar.command(cmdtable)
# Note for extension authors: ONLY specify testedwith = 'ships-with-hg-core' for # Note for extension authors: ONLY specify testedwith = 'ships-with-hg-core' for
# extensions which SHIP WITH MERCURIAL. Non-mainline extensions should # extensions which SHIP WITH MERCURIAL. Non-mainline extensions should
# be specifying the version(s) of Mercurial they are tested with, or # be specifying the version(s) of Mercurial they are tested with, or
# leave the attribute unspecified. # leave the attribute unspecified.
testedwith = 'ships-with-hg-core' testedwith = 'ships-with-hg-core'
@command('relink', [], _('[ORIGIN]')) @command('relink', [], _('[ORIGIN]'), helpcategory=command.CATEGORY_MAINTENANCE)
def relink(ui, repo, origin=None, **opts): def relink(ui, repo, origin=None, **opts):
"""recreate hardlinks between two repositories """recreate hardlinks between two repositories
When repositories are cloned locally, their data files will be When repositories are cloned locally, their data files will be
hardlinked so that they only use the space of a single repository. hardlinked so that they only use the space of a single repository.
Unfortunately, subsequent pulls into either repository will break Unfortunately, subsequent pulls into either repository will break
hardlinks for any files touched by the new changesets, even if hardlinks for any files touched by the new changesets, even if

hgext/share.py

@command('share', @command('share',
[('U', 'noupdate', None, _('do not create a working directory')), [('U', 'noupdate', None, _('do not create a working directory')),
('B', 'bookmarks', None, _('also share bookmarks')), ('B', 'bookmarks', None, _('also share bookmarks')),
('', 'relative', None, _('point to source using a relative path ' ('', 'relative', None, _('point to source using a relative path '
'(EXPERIMENTAL)')), '(EXPERIMENTAL)')),
], ],
_('[-U] [-B] SOURCE [DEST]'), _('[-U] [-B] SOURCE [DEST]'),
helpcategory=command.CATEGORY_REPO_CREATION,
norepo=True) norepo=True)
def share(ui, source, dest=None, noupdate=False, bookmarks=False, def share(ui, source, dest=None, noupdate=False, bookmarks=False,
relative=False): relative=False):
"""create a new shared repository """create a new shared repository
Initialize a new repository and working directory that shares its Initialize a new repository and working directory that shares its
history (and optionally bookmarks) with another repository. history (and optionally bookmarks) with another repository.
.. note:: .. note::
using rollback or extensions that destroy/modify history (mq, using rollback or extensions that destroy/modify history (mq,
rebase, etc.) can cause considerable confusion with shared rebase, etc.) can cause considerable confusion with shared
clones. In particular, if two shared clones are both updated to clones. In particular, if two shared clones are both updated to
the same changeset, and one of them destroys that changeset the same changeset, and one of them destroys that changeset
with rollback, the other clone will suddenly stop working: all with rollback, the other clone will suddenly stop working: all
operations will fail with "abort: working directory has unknown operations will fail with "abort: working directory has unknown
parent". The only known workaround is to use debugsetparents on parent". The only known workaround is to use debugsetparents on
the broken clone to reset it to a changeset that still exists. the broken clone to reset it to a changeset that still exists.
""" """
hg.share(ui, source, dest=dest, update=not noupdate, hg.share(ui, source, dest=dest, update=not noupdate,
bookmarks=bookmarks, relative=relative) bookmarks=bookmarks, relative=relative)
return 0 return 0
@command('unshare', [], '') @command('unshare', [], '', helpcategory=command.CATEGORY_MAINTENANCE)
def unshare(ui, repo): def unshare(ui, repo):
"""convert a shared repository to a normal one """convert a shared repository to a normal one
Copy the store data to the repo and remove the sharedpath data. Copy the store data to the repo and remove the sharedpath data.
""" """
if not repo.shared(): if not repo.shared():
raise error.Abort(_("this is not a shared repo")) raise error.Abort(_("this is not a shared repo"))

hgext/shelve.py

_('continue an incomplete unshelve operation')), _('continue an incomplete unshelve operation')),
('k', 'keep', None, ('k', 'keep', None,
_('keep shelve after unshelving')), _('keep shelve after unshelving')),
('n', 'name', '', ('n', 'name', '',
_('restore shelved change with given name'), _('NAME')), _('restore shelved change with given name'), _('NAME')),
('t', 'tool', '', _('specify merge tool')), ('t', 'tool', '', _('specify merge tool')),
('', 'date', '', ('', 'date', '',
_('set date for temporary commits (DEPRECATED)'), _('DATE'))], _('set date for temporary commits (DEPRECATED)'), _('DATE'))],
_('hg unshelve [[-n] SHELVED]')) _('hg unshelve [[-n] SHELVED]'),
helpcategory=command.CATEGORY_WORKING_DIRECTORY)
def unshelve(ui, repo, *shelved, **opts): def unshelve(ui, repo, *shelved, **opts):
"""restore a shelved change to the working directory """restore a shelved change to the working directory
This command accepts an optional name of a shelved change to This command accepts an optional name of a shelved change to
restore. If none is given, the most recent shelved change is used. restore. If none is given, the most recent shelved change is used.
If a shelved change is applied successfully, the bundle that If a shelved change is applied successfully, the bundle that
contains the shelved changes is moved to a backup location contains the shelved changes is moved to a backup location
_('output patches for changes (provide the names of the shelved ' _('output patches for changes (provide the names of the shelved '
'changes as positional arguments)')), 'changes as positional arguments)')),
('i', 'interactive', None, ('i', 'interactive', None,
_('interactive mode, only works while creating a shelve')), _('interactive mode, only works while creating a shelve')),
('', 'stat', None, ('', 'stat', None,
_('output diffstat-style summary of changes (provide the names of ' _('output diffstat-style summary of changes (provide the names of '
'the shelved changes as positional arguments)') 'the shelved changes as positional arguments)')
)] + cmdutil.walkopts, )] + cmdutil.walkopts,
_('hg shelve [OPTION]... [FILE]...')) _('hg shelve [OPTION]... [FILE]...'),
helpcategory=command.CATEGORY_WORKING_DIRECTORY)
def shelvecmd(ui, repo, *pats, **opts): def shelvecmd(ui, repo, *pats, **opts):
'''save and set aside changes from the working directory '''save and set aside changes from the working directory
Shelving takes files that "hg status" reports as not clean, saves Shelving takes files that "hg status" reports as not clean, saves
the modifications to a bundle (a shelved change), and reverts the the modifications to a bundle (a shelved change), and reverts the
files so that their state in the working directory becomes clean. files so that their state in the working directory becomes clean.
To restore these changes to the working directory, using "hg To restore these changes to the working directory, using "hg

hgext/show.py

@command('show', [ @command('show', [
# TODO: Switch this template flag to use cmdutil.formatteropts if # TODO: Switch this template flag to use cmdutil.formatteropts if
# 'hg show' becomes stable before --template/-T is stable. For now, # 'hg show' becomes stable before --template/-T is stable. For now,
# we are putting it here without the '(EXPERIMENTAL)' flag because it # we are putting it here without the '(EXPERIMENTAL)' flag because it
# is an important part of the 'hg show' user experience and the entire # is an important part of the 'hg show' user experience and the entire
# 'hg show' experience is experimental. # 'hg show' experience is experimental.
('T', 'template', '', ('display with template'), _('TEMPLATE')), ('T', 'template', '', ('display with template'), _('TEMPLATE')),
], _('VIEW')) ], _('VIEW'),
helpcategory=command.CATEGORY_CHANGE_NAVIGATION)
def show(ui, repo, view=None, template=None): def show(ui, repo, view=None, template=None):
"""show various repository information """show various repository information
A requested view of repository data is displayed. A requested view of repository data is displayed.
If no view is requested, the list of available views is shown and the If no view is requested, the list of available views is shown and the
command aborts. command aborts.

hgext/split.py

# be specifying the version(s) of Mercurial they are tested with, or # be specifying the version(s) of Mercurial they are tested with, or
# leave the attribute unspecified. # leave the attribute unspecified.
testedwith = 'ships-with-hg-core' testedwith = 'ships-with-hg-core'
@command('^split', @command('^split',
[('r', 'rev', '', _("revision to split"), _('REV')), [('r', 'rev', '', _("revision to split"), _('REV')),
('', 'rebase', True, _('rebase descendants after split')), ('', 'rebase', True, _('rebase descendants after split')),
] + cmdutil.commitopts2, ] + cmdutil.commitopts2,
_('hg split [--no-rebase] [[-r] REV]')) _('hg split [--no-rebase] [[-r] REV]'),
helpcategory=command.CATEGORY_CHANGE_MANAGEMENT)
def split(ui, repo, *revs, **opts): def split(ui, repo, *revs, **opts):
"""split a changeset into smaller ones """split a changeset into smaller ones
Repeatedly prompt changes and commit message for new changesets until there Repeatedly prompt changes and commit message for new changesets until there
is nothing left in the original changeset. is nothing left in the original changeset.
If --rev was not given, split the working directory parent. If --rev was not given, split the working directory parent.

hgext/strip.py

('', 'no-backup', None, _('do not save backup bundle')), ('', 'no-backup', None, _('do not save backup bundle')),
('', 'nobackup', None, _('do not save backup bundle ' ('', 'nobackup', None, _('do not save backup bundle '
'(DEPRECATED)')), '(DEPRECATED)')),
('n', '', None, _('ignored (DEPRECATED)')), ('n', '', None, _('ignored (DEPRECATED)')),
('k', 'keep', None, _("do not modify working directory during " ('k', 'keep', None, _("do not modify working directory during "
"strip")), "strip")),
('B', 'bookmark', [], _("remove revs only reachable from given" ('B', 'bookmark', [], _("remove revs only reachable from given"
" bookmark"))], " bookmark"))],
_('hg strip [-k] [-f] [-B bookmark] [-r] REV...')) _('hg strip [-k] [-f] [-B bookmark] [-r] REV...'),
helpcategory=command.CATEGORY_MAINTENANCE)
def stripcmd(ui, repo, *revs, **opts): def stripcmd(ui, repo, *revs, **opts):
"""strip changesets and all their descendants from the repository """strip changesets and all their descendants from the repository
The strip command removes the specified changesets and all their The strip command removes the specified changesets and all their
descendants. If the working directory has uncommitted changes, the descendants. If the working directory has uncommitted changes, the
operation is aborted unless the --force flag is supplied, in which operation is aborted unless the --force flag is supplied, in which
case changes will be discarded. case changes will be discarded.

hgext/transplant.py

_('parent to choose when transplanting merge'), _('REV')), _('parent to choose when transplanting merge'), _('REV')),
('e', 'edit', False, _('invoke editor on commit messages')), ('e', 'edit', False, _('invoke editor on commit messages')),
('', 'log', None, _('append transplant info to log message')), ('', 'log', None, _('append transplant info to log message')),
('c', 'continue', None, _('continue last transplant session ' ('c', 'continue', None, _('continue last transplant session '
'after fixing conflicts')), 'after fixing conflicts')),
('', 'filter', '', ('', 'filter', '',
_('filter changesets through command'), _('CMD'))], _('filter changesets through command'), _('CMD'))],
_('hg transplant [-s REPO] [-b BRANCH [-a]] [-p REV] ' _('hg transplant [-s REPO] [-b BRANCH [-a]] [-p REV] '
'[-m REV] [REV]...')) '[-m REV] [REV]...'),
helpcategory=command.CATEGORY_CHANGE_MANAGEMENT)
def transplant(ui, repo, *revs, **opts): def transplant(ui, repo, *revs, **opts):
'''transplant changesets from another branch '''transplant changesets from another branch
Selected changesets will be applied on top of the current working Selected changesets will be applied on top of the current working
directory with the log of the original changeset. The changesets directory with the log of the original changeset. The changesets
are copied and will thus appear twice in the history with different are copied and will thus appear twice in the history with different
identities. identities.

hgext/uncommit.py

for dst, src in copies.iteritems(): for dst, src in copies.iteritems():
if (src not in newctx or dst in newctx or ds[dst] != 'a'): if (src not in newctx or dst in newctx or ds[dst] != 'a'):
src = None src = None
ds.copy(src, dst) ds.copy(src, dst)
@command('uncommit', @command('uncommit',
[('', 'keep', False, _('allow an empty commit after uncommiting')), [('', 'keep', False, _('allow an empty commit after uncommiting')),
] + commands.walkopts, ] + commands.walkopts,
_('[OPTION]... [FILE]...')) _('[OPTION]... [FILE]...'),
helpcategory=command.CATEGORY_CHANGE_MANAGEMENT)
def uncommit(ui, repo, *pats, **opts): def uncommit(ui, repo, *pats, **opts):
"""uncommit part or all of a local changeset """uncommit part or all of a local changeset
This command undoes the effect of a local commit, returning the affected This command undoes the effect of a local commit, returning the affected
files to their uncommitted state. This means that files modified or files to their uncommitted state. This means that files modified or
deleted in the changeset will be left unchanged, and so will remain deleted in the changeset will be left unchanged, and so will remain
modified in the working directory. modified in the working directory.
s = old.p1().status(old, match=match) s = old.p1().status(old, match=match)
_fixdirstate(repo, old, repo[newid], s) _fixdirstate(repo, old, repo[newid], s)
def predecessormarkers(ctx): def predecessormarkers(ctx):
"""yields the obsolete markers marking the given changeset as a successor""" """yields the obsolete markers marking the given changeset as a successor"""
for data in ctx.repo().obsstore.predecessors.get(ctx.node(), ()): for data in ctx.repo().obsstore.predecessors.get(ctx.node(), ()):
yield obsutil.marker(ctx.repo(), data) yield obsutil.marker(ctx.repo(), data)
@command('^unamend', []) @command('^unamend', [], helpcategory=command.CATEGORY_CHANGE_MANAGEMENT)
def unamend(ui, repo, **opts): def unamend(ui, repo, **opts):
"""undo the most recent amend operation on a current changeset """undo the most recent amend operation on a current changeset
This command will roll back to the previous version of a changeset, This command will roll back to the previous version of a changeset,
leaving working directory in state in which it was before running leaving working directory in state in which it was before running
`hg amend` (e.g. files modified as part of an amend will be `hg amend` (e.g. files modified as part of an amend will be
marked as modified `hg status`) marked as modified `hg status`)
""" """

mercurial/commands.py

subrepoopts = cmdutil.subrepoopts subrepoopts = cmdutil.subrepoopts
debugrevlogopts = cmdutil.debugrevlogopts debugrevlogopts = cmdutil.debugrevlogopts
# Commands start here, listed alphabetically # Commands start here, listed alphabetically
@command('^add', @command('^add',
walkopts + subrepoopts + dryrunopts, walkopts + subrepoopts + dryrunopts,
_('[OPTION]... [FILE]...'), _('[OPTION]... [FILE]...'),
helpcategory=command.CATEGORY_WORKING_DIRECTORY,
inferrepo=True) inferrepo=True)
def add(ui, repo, *pats, **opts): def add(ui, repo, *pats, **opts):
"""add the specified files on the next commit """add the specified files on the next commit
Schedule files to be version controlled and added to the Schedule files to be version controlled and added to the
repository. repository.
The files will be added to the repository at the next commit. To The files will be added to the repository at the next commit. To
m = scmutil.match(repo[None], pats, pycompat.byteskwargs(opts)) m = scmutil.match(repo[None], pats, pycompat.byteskwargs(opts))
rejected = cmdutil.add(ui, repo, m, "", False, **opts) rejected = cmdutil.add(ui, repo, m, "", False, **opts)
return rejected and 1 or 0 return rejected and 1 or 0
@command('addremove', @command('addremove',
similarityopts + subrepoopts + walkopts + dryrunopts, similarityopts + subrepoopts + walkopts + dryrunopts,
_('[OPTION]... [FILE]...'), _('[OPTION]... [FILE]...'),
helpcategory=command.CATEGORY_WORKING_DIRECTORY,
inferrepo=True) inferrepo=True)
def addremove(ui, repo, *pats, **opts): def addremove(ui, repo, *pats, **opts):
"""add all new files, delete all missing files """add all new files, delete all missing files
Add all new files and remove all missing files from the Add all new files and remove all missing files from the
repository. repository.
Unless names are given, new files are ignored if they match any of Unless names are given, new files are ignored if they match any of
('f', 'file', None, _('list the filename')), ('f', 'file', None, _('list the filename')),
('d', 'date', None, _('list the date (short with -q)')), ('d', 'date', None, _('list the date (short with -q)')),
('n', 'number', None, _('list the revision number (default)')), ('n', 'number', None, _('list the revision number (default)')),
('c', 'changeset', None, _('list the changeset')), ('c', 'changeset', None, _('list the changeset')),
('l', 'line-number', None, _('show line number at the first appearance')), ('l', 'line-number', None, _('show line number at the first appearance')),
('', 'skip', [], _('revision to not display (EXPERIMENTAL)'), _('REV')), ('', 'skip', [], _('revision to not display (EXPERIMENTAL)'), _('REV')),
] + diffwsopts + walkopts + formatteropts, ] + diffwsopts + walkopts + formatteropts,
_('[-r REV] [-f] [-a] [-u] [-d] [-n] [-c] [-l] FILE...'), _('[-r REV] [-f] [-a] [-u] [-d] [-n] [-c] [-l] FILE...'),
helpcategory=command.CATEGORY_FILE_CONTENTS,
inferrepo=True) inferrepo=True)
def annotate(ui, repo, *pats, **opts): def annotate(ui, repo, *pats, **opts):
"""show changeset information by line for each file """show changeset information by line for each file
List changes in files, showing the revision id responsible for List changes in files, showing the revision id responsible for
each line. each line.
This command is useful for discovering when a change was made and This command is useful for discovering when a change was made and
@command('archive', @command('archive',
[('', 'no-decode', None, _('do not pass files through decoders')), [('', 'no-decode', None, _('do not pass files through decoders')),
('p', 'prefix', '', _('directory prefix for files in archive'), ('p', 'prefix', '', _('directory prefix for files in archive'),
_('PREFIX')), _('PREFIX')),
('r', 'rev', '', _('revision to distribute'), _('REV')), ('r', 'rev', '', _('revision to distribute'), _('REV')),
('t', 'type', '', _('type of distribution to create'), _('TYPE')), ('t', 'type', '', _('type of distribution to create'), _('TYPE')),
] + subrepoopts + walkopts, ] + subrepoopts + walkopts,
_('[OPTION]... DEST')) _('[OPTION]... DEST'),
helpcategory=command.CATEGORY_IMPORT_EXPORT)
def archive(ui, repo, dest, **opts): def archive(ui, repo, dest, **opts):
'''create an unversioned archive of a repository revision '''create an unversioned archive of a repository revision
By default, the revision used is the parent of the working By default, the revision used is the parent of the working
directory; use -r/--rev to specify a different revision. directory; use -r/--rev to specify a different revision.
The archive type is automatically detected based on file The archive type is automatically detected based on file
extension (to override, use -t/--type). extension (to override, use -t/--type).
('', 'commit', None, ('', 'commit', None,
_('commit if no conflicts were encountered (DEPRECATED)')), _('commit if no conflicts were encountered (DEPRECATED)')),
('', 'no-commit', None, _('do not commit')), ('', 'no-commit', None, _('do not commit')),
('', 'parent', '', ('', 'parent', '',
_('parent to choose when backing out merge (DEPRECATED)'), _('REV')), _('parent to choose when backing out merge (DEPRECATED)'), _('REV')),
('r', 'rev', '', _('revision to backout'), _('REV')), ('r', 'rev', '', _('revision to backout'), _('REV')),
('e', 'edit', False, _('invoke editor on commit messages')), ('e', 'edit', False, _('invoke editor on commit messages')),
] + mergetoolopts + walkopts + commitopts + commitopts2, ] + mergetoolopts + walkopts + commitopts + commitopts2,
_('[OPTION]... [-r] REV')) _('[OPTION]... [-r] REV'),
helpcategory=command.CATEGORY_CHANGE_MANAGEMENT)
def backout(ui, repo, node=None, rev=None, **opts): def backout(ui, repo, node=None, rev=None, **opts):
'''reverse effect of earlier changeset '''reverse effect of earlier changeset
Prepare a new changeset with the effect of REV undone in the Prepare a new changeset with the effect of REV undone in the
current working directory. If no conflicts were encountered, current working directory. If no conflicts were encountered,
it will be committed immediately. it will be committed immediately.
If REV is the parent of the working directory, then this new changeset If REV is the parent of the working directory, then this new changeset
@command('bisect', @command('bisect',
[('r', 'reset', False, _('reset bisect state')), [('r', 'reset', False, _('reset bisect state')),
('g', 'good', False, _('mark changeset good')), ('g', 'good', False, _('mark changeset good')),
('b', 'bad', False, _('mark changeset bad')), ('b', 'bad', False, _('mark changeset bad')),
('s', 'skip', False, _('skip testing changeset')), ('s', 'skip', False, _('skip testing changeset')),
('e', 'extend', False, _('extend the bisect range')), ('e', 'extend', False, _('extend the bisect range')),
('c', 'command', '', _('use command to check changeset state'), _('CMD')), ('c', 'command', '', _('use command to check changeset state'), _('CMD')),
('U', 'noupdate', False, _('do not update to target'))], ('U', 'noupdate', False, _('do not update to target'))],
_("[-gbsr] [-U] [-c CMD] [REV]")) _("[-gbsr] [-U] [-c CMD] [REV]"),
helpcategory=command.CATEGORY_CHANGE_NAVIGATION)
def bisect(ui, repo, rev=None, extra=None, command=None, def bisect(ui, repo, rev=None, extra=None, command=None,
reset=None, good=None, bad=None, skip=None, extend=None, reset=None, good=None, bad=None, skip=None, extend=None,
noupdate=None): noupdate=None):
"""subdivision search of changesets """subdivision search of changesets
This command helps to find changesets which introduce problems. To This command helps to find changesets which introduce problems. To
use, mark the earliest changeset you know exhibits the problem as use, mark the earliest changeset you know exhibits the problem as
bad, then mark the latest changeset which is free from the problem bad, then mark the latest changeset which is free from the problem
@command('bookmarks|bookmark', @command('bookmarks|bookmark',
[('f', 'force', False, _('force')), [('f', 'force', False, _('force')),
('r', 'rev', '', _('revision for bookmark action'), _('REV')), ('r', 'rev', '', _('revision for bookmark action'), _('REV')),
('d', 'delete', False, _('delete a given bookmark')), ('d', 'delete', False, _('delete a given bookmark')),
('m', 'rename', '', _('rename a given bookmark'), _('OLD')), ('m', 'rename', '', _('rename a given bookmark'), _('OLD')),
('i', 'inactive', False, _('mark a bookmark inactive')), ('i', 'inactive', False, _('mark a bookmark inactive')),
('l', 'list', False, _('list existing bookmarks')), ('l', 'list', False, _('list existing bookmarks')),
] + formatteropts, ] + formatteropts,
_('hg bookmarks [OPTIONS]... [NAME]...')) _('hg bookmarks [OPTIONS]... [NAME]...'),
helpcategory=command.CATEGORY_CHANGE_ORGANIZATION)
def bookmark(ui, repo, *names, **opts): def bookmark(ui, repo, *names, **opts):
'''create a new bookmark or list existing bookmarks '''create a new bookmark or list existing bookmarks
Bookmarks are labels on changesets to help track lines of development. Bookmarks are labels on changesets to help track lines of development.
Bookmarks are unversioned and can be moved, renamed and deleted. Bookmarks are unversioned and can be moved, renamed and deleted.
Deleting or moving a bookmark has no effect on the associated changesets. Deleting or moving a bookmark has no effect on the associated changesets.
Creating or updating to a bookmark causes it to be marked as 'active'. Creating or updating to a bookmark causes it to be marked as 'active'.
raise error.ProgrammingError('invalid action: %s' % action) raise error.ProgrammingError('invalid action: %s' % action)
@command('branch', @command('branch',
[('f', 'force', None, [('f', 'force', None,
_('set branch name even if it shadows an existing branch')), _('set branch name even if it shadows an existing branch')),
('C', 'clean', None, _('reset branch name to parent branch name')), ('C', 'clean', None, _('reset branch name to parent branch name')),
('r', 'rev', [], _('change branches of the given revs (EXPERIMENTAL)')), ('r', 'rev', [], _('change branches of the given revs (EXPERIMENTAL)')),
], ],
_('[-fC] [NAME]')) _('[-fC] [NAME]'),
helpcategory=command.CATEGORY_CHANGE_ORGANIZATION)
def branch(ui, repo, label=None, **opts): def branch(ui, repo, label=None, **opts):
"""set or show the current branch name """set or show the current branch name
.. note:: .. note::
Branch names are permanent and global. Use :hg:`bookmark` to create a Branch names are permanent and global. Use :hg:`bookmark` to create a
light-weight bookmark instead. See :hg:`help glossary` for more light-weight bookmark instead. See :hg:`help glossary` for more
information about named branches and bookmarks. information about named branches and bookmarks.
'did you want a bookmark?)\n')) 'did you want a bookmark?)\n'))
@command('branches', @command('branches',
[('a', 'active', False, [('a', 'active', False,
_('show only branches that have unmerged heads (DEPRECATED)')), _('show only branches that have unmerged heads (DEPRECATED)')),
('c', 'closed', False, _('show normal and closed branches')), ('c', 'closed', False, _('show normal and closed branches')),
] + formatteropts, ] + formatteropts,
_('[-c]'), _('[-c]'),
helpcategory=command.CATEGORY_CHANGE_ORGANIZATION,
intents={INTENT_READONLY}) intents={INTENT_READONLY})
def branches(ui, repo, active=False, closed=False, **opts): def branches(ui, repo, active=False, closed=False, **opts):
"""list repository named branches """list repository named branches
List the repository's named branches, indicating which ones are List the repository's named branches, indicating which ones are
inactive. If -c/--closed is specified, also list branches which have inactive. If -c/--closed is specified, also list branches which have
been marked closed (see :hg:`commit --close-branch`). been marked closed (see :hg:`commit --close-branch`).
('b', 'branch', [], _('a specific branch you would like to bundle'), ('b', 'branch', [], _('a specific branch you would like to bundle'),
_('BRANCH')), _('BRANCH')),
('', 'base', [], ('', 'base', [],
_('a base changeset assumed to be available at the destination'), _('a base changeset assumed to be available at the destination'),
_('REV')), _('REV')),
('a', 'all', None, _('bundle all changesets in the repository')), ('a', 'all', None, _('bundle all changesets in the repository')),
('t', 'type', 'bzip2', _('bundle compression type to use'), _('TYPE')), ('t', 'type', 'bzip2', _('bundle compression type to use'), _('TYPE')),
] + remoteopts, ] + remoteopts,
_('[-f] [-t BUNDLESPEC] [-a] [-r REV]... [--base REV]... FILE [DEST]')) _('[-f] [-t BUNDLESPEC] [-a] [-r REV]... [--base REV]... FILE [DEST]'),
helpcategory=command.CATEGORY_IMPORT_EXPORT)
def bundle(ui, repo, fname, dest=None, **opts): def bundle(ui, repo, fname, dest=None, **opts):
"""create a bundle file """create a bundle file
Generate a bundle file containing data to be transferred to another Generate a bundle file containing data to be transferred to another
repository. repository.
To create a bundle containing all changesets, use -a/--all To create a bundle containing all changesets, use -a/--all
(or --base null). Otherwise, hg assumes the destination will have (or --base null). Otherwise, hg assumes the destination will have
@command('cat', @command('cat',
[('o', 'output', '', [('o', 'output', '',
_('print output to file with formatted name'), _('FORMAT')), _('print output to file with formatted name'), _('FORMAT')),
('r', 'rev', '', _('print the given revision'), _('REV')), ('r', 'rev', '', _('print the given revision'), _('REV')),
('', 'decode', None, _('apply any matching decode filter')), ('', 'decode', None, _('apply any matching decode filter')),
] + walkopts + formatteropts, ] + walkopts + formatteropts,
_('[OPTION]... FILE...'), _('[OPTION]... FILE...'),
helpcategory=command.CATEGORY_FILE_CONTENTS,
inferrepo=True, inferrepo=True,
intents={INTENT_READONLY}) intents={INTENT_READONLY})
def cat(ui, repo, file1, *pats, **opts): def cat(ui, repo, file1, *pats, **opts):
"""output the current or given revision of files """output the current or given revision of files
Print the specified files as they were at the given revision. If Print the specified files as they were at the given revision. If
no revision is given, the parent of the working directory is used. no revision is given, the parent of the working directory is used.
' changesets and their ancestors'), _('BRANCH')), ' changesets and their ancestors'), _('BRANCH')),
('', 'pull', None, _('use pull protocol to copy metadata')), ('', 'pull', None, _('use pull protocol to copy metadata')),
('', 'uncompressed', None, ('', 'uncompressed', None,
_('an alias to --stream (DEPRECATED)')), _('an alias to --stream (DEPRECATED)')),
('', 'stream', None, ('', 'stream', None,
_('clone with minimal data processing')), _('clone with minimal data processing')),
] + remoteopts, ] + remoteopts,
_('[OPTION]... SOURCE [DEST]'), _('[OPTION]... SOURCE [DEST]'),
helpcategory=command.CATEGORY_REPO_CREATION,
norepo=True) norepo=True)
def clone(ui, source, dest=None, **opts): def clone(ui, source, dest=None, **opts):
"""make a copy of an existing repository """make a copy of an existing repository
Create a copy of an existing repository in a new directory. Create a copy of an existing repository in a new directory.
If no destination directory name is specified, it defaults to the If no destination directory name is specified, it defaults to the
basename of the source. basename of the source.
('', 'close-branch', None, ('', 'close-branch', None,
_('mark a branch head as closed')), _('mark a branch head as closed')),
('', 'amend', None, _('amend the parent of the working directory')), ('', 'amend', None, _('amend the parent of the working directory')),
('s', 'secret', None, _('use the secret phase for committing')), ('s', 'secret', None, _('use the secret phase for committing')),
('e', 'edit', None, _('invoke editor on commit messages')), ('e', 'edit', None, _('invoke editor on commit messages')),
('i', 'interactive', None, _('use interactive mode')), ('i', 'interactive', None, _('use interactive mode')),
] + walkopts + commitopts + commitopts2 + subrepoopts, ] + walkopts + commitopts + commitopts2 + subrepoopts,
_('[OPTION]... [FILE]...'), _('[OPTION]... [FILE]...'),
helpcategory=command.CATEGORY_COMMITTING,
inferrepo=True) inferrepo=True)
def commit(ui, repo, *pats, **opts): def commit(ui, repo, *pats, **opts):
"""commit the specified files or all outstanding changes """commit the specified files or all outstanding changes
Commit changes to the given files into the repository. Unlike a Commit changes to the given files into the repository. Unlike a
centralized SCM, this operation is a local operation. See centralized SCM, this operation is a local operation. See
:hg:`push` for a way to actively distribute your changes. :hg:`push` for a way to actively distribute your changes.
cmdutil.commitstatus(repo, node, branch, bheads, opts) cmdutil.commitstatus(repo, node, branch, bheads, opts)
@command('config|showconfig|debugconfig', @command('config|showconfig|debugconfig',
[('u', 'untrusted', None, _('show untrusted configuration options')), [('u', 'untrusted', None, _('show untrusted configuration options')),
('e', 'edit', None, _('edit user config')), ('e', 'edit', None, _('edit user config')),
('l', 'local', None, _('edit repository config')), ('l', 'local', None, _('edit repository config')),
('g', 'global', None, _('edit global config'))] + formatteropts, ('g', 'global', None, _('edit global config'))] + formatteropts,
_('[-u] [NAME]...'), _('[-u] [NAME]...'),
helpcategory=command.CATEGORY_HELP,
optionalrepo=True, optionalrepo=True,
intents={INTENT_READONLY}) intents={INTENT_READONLY})
def config(ui, repo, *values, **opts): def config(ui, repo, *values, **opts):
"""show combined config settings from all hgrc files """show combined config settings from all hgrc files
With no arguments, print names and values of all config items. With no arguments, print names and values of all config items.
With one argument of the form section.name, print just the value With one argument of the form section.name, print just the value
if matched: if matched:
return 0 return 0
return 1 return 1
@command('copy|cp', @command('copy|cp',
[('A', 'after', None, _('record a copy that has already occurred')), [('A', 'after', None, _('record a copy that has already occurred')),
('f', 'force', None, _('forcibly copy over an existing managed file')), ('f', 'force', None, _('forcibly copy over an existing managed file')),
] + walkopts + dryrunopts, ] + walkopts + dryrunopts,
_('[OPTION]... [SOURCE]... DEST')) _('[OPTION]... [SOURCE]... DEST'),
helpcategory=command.CATEGORY_FILE_CONTENTS)
def copy(ui, repo, *pats, **opts): def copy(ui, repo, *pats, **opts):
"""mark files as copied for the next commit """mark files as copied for the next commit
Mark dest as having copies of source files. If dest is a Mark dest as having copies of source files. If dest is a
directory, copies are put in that directory. If dest is a file, directory, copies are put in that directory. If dest is a file,
the source must be a single file. the source must be a single file.
By default, this command copies the contents of files as they By default, this command copies the contents of files as they
exist in the working directory. If invoked with -A/--after, the exist in the working directory. If invoked with -A/--after, the
operation is recorded, but no copying is performed. operation is recorded, but no copying is performed.
This command takes effect with the next commit. To undo a copy This command takes effect with the next commit. To undo a copy
before that, see :hg:`revert`. before that, see :hg:`revert`.
Returns 0 on success, 1 if errors are encountered. Returns 0 on success, 1 if errors are encountered.
""" """
opts = pycompat.byteskwargs(opts) opts = pycompat.byteskwargs(opts)
with repo.wlock(False): with repo.wlock(False):
return cmdutil.copy(ui, repo, pats, opts) return cmdutil.copy(ui, repo, pats, opts)
@command('debugcommands', [], _('[COMMAND]'), norepo=True) @command(
'debugcommands', [], _('[COMMAND]'),
helpcategory=command.CATEGORY_HELP,
norepo=True)
def debugcommands(ui, cmd='', *args): def debugcommands(ui, cmd='', *args):
"""list all available commands and options""" """list all available commands and options"""
for cmd, vals in sorted(table.iteritems()): for cmd, vals in sorted(table.iteritems()):
cmd = cmd.split('|')[0].strip('^') cmd = cmd.split('|')[0].strip('^')
opts = ', '.join([i[1] for i in vals[1]]) opts = ', '.join([i[1] for i in vals[1]])
ui.write('%s: %s\n' % (cmd, opts)) ui.write('%s: %s\n' % (cmd, opts))
@command('debugcomplete', @command('debugcomplete',
[('o', 'options', None, _('show the command options'))], [('o', 'options', None, _('show the command options'))],
_('[-o] CMD'), _('[-o] CMD'),
helpcategory=command.CATEGORY_HELP,
norepo=True) norepo=True)
def debugcomplete(ui, cmd='', **opts): def debugcomplete(ui, cmd='', **opts):
"""returns the completion list associated with the given command""" """returns the completion list associated with the given command"""
if opts.get(r'options'): if opts.get(r'options'):
options = [] options = []
otables = [globalopts] otables = [globalopts]
if cmd: if cmd:
cmdlist = [' '.join(c[0]) for c in cmdlist.values()] cmdlist = [' '.join(c[0]) for c in cmdlist.values()]
ui.write("%s\n" % "\n".join(sorted(cmdlist))) ui.write("%s\n" % "\n".join(sorted(cmdlist)))
@command('^diff', @command('^diff',
[('r', 'rev', [], _('revision'), _('REV')), [('r', 'rev', [], _('revision'), _('REV')),
('c', 'change', '', _('change made by revision'), _('REV')) ('c', 'change', '', _('change made by revision'), _('REV'))
] + diffopts + diffopts2 + walkopts + subrepoopts, ] + diffopts + diffopts2 + walkopts + subrepoopts,
_('[OPTION]... ([-c REV] | [-r REV1 [-r REV2]]) [FILE]...'), _('[OPTION]... ([-c REV] | [-r REV1 [-r REV2]]) [FILE]...'),
helpcategory=command.CATEGORY_FILE_CONTENTS,
inferrepo=True, inferrepo=True,
intents={INTENT_READONLY}) intents={INTENT_READONLY})
def diff(ui, repo, *pats, **opts): def diff(ui, repo, *pats, **opts):
"""diff repository (or selected files) """diff repository (or selected files)
Show differences between revisions for the specified files. Show differences between revisions for the specified files.
Differences between files are shown using the unified diff format. Differences between files are shown using the unified diff format.
[('B', 'bookmark', '', [('B', 'bookmark', '',
_('export changes only reachable by given bookmark')), _('export changes only reachable by given bookmark')),
('o', 'output', '', ('o', 'output', '',
_('print output to file with formatted name'), _('FORMAT')), _('print output to file with formatted name'), _('FORMAT')),
('', 'switch-parent', None, _('diff against the second parent')), ('', 'switch-parent', None, _('diff against the second parent')),
('r', 'rev', [], _('revisions to export'), _('REV')), ('r', 'rev', [], _('revisions to export'), _('REV')),
] + diffopts + formatteropts, ] + diffopts + formatteropts,
_('[OPTION]... [-o OUTFILESPEC] [-r] [REV]...'), _('[OPTION]... [-o OUTFILESPEC] [-r] [REV]...'),
helpcategory=command.CATEGORY_IMPORT_EXPORT,
intents={INTENT_READONLY}) intents={INTENT_READONLY})
def export(ui, repo, *changesets, **opts): def export(ui, repo, *changesets, **opts):
"""dump the header and diffs for one or more changesets """dump the header and diffs for one or more changesets
Print the changeset header and diffs for one or more revisions. Print the changeset header and diffs for one or more revisions.
If no revision is given, the parent of the working directory is used. If no revision is given, the parent of the working directory is used.
The information shown in the changeset header is: author, date, The information shown in the changeset header is: author, date,
switch_parent=opts.get('switch_parent'), switch_parent=opts.get('switch_parent'),
opts=patch.diffallopts(ui, opts)) opts=patch.diffallopts(ui, opts))
@command('files', @command('files',
[('r', 'rev', '', _('search the repository as it is in REV'), _('REV')), [('r', 'rev', '', _('search the repository as it is in REV'), _('REV')),
('0', 'print0', None, _('end filenames with NUL, for use with xargs')), ('0', 'print0', None, _('end filenames with NUL, for use with xargs')),
] + walkopts + formatteropts + subrepoopts, ] + walkopts + formatteropts + subrepoopts,
_('[OPTION]... [FILE]...'), _('[OPTION]... [FILE]...'),
helpcategory=command.CATEGORY_WORKING_DIRECTORY,
intents={INTENT_READONLY}) intents={INTENT_READONLY})
def files(ui, repo, *pats, **opts): def files(ui, repo, *pats, **opts):
"""list tracked files """list tracked files
Print files under Mercurial control in the working directory or Print files under Mercurial control in the working directory or
specified revision for given files (excluding removed files). specified revision for given files (excluding removed files).
Files can be specified as filenames or filesets. Files can be specified as filenames or filesets.
ui.pager('files') ui.pager('files')
with ui.formatter('files', opts) as fm: with ui.formatter('files', opts) as fm:
return cmdutil.files(ui, ctx, m, fm, fmt, opts.get('subrepos')) return cmdutil.files(ui, ctx, m, fm, fmt, opts.get('subrepos'))
@command( @command(
'^forget', '^forget',
[('i', 'interactive', None, _('use interactive mode')), [('i', 'interactive', None, _('use interactive mode')),
] + walkopts + dryrunopts, ] + walkopts + dryrunopts,
_('[OPTION]... FILE...'), inferrepo=True) _('[OPTION]... FILE...'),
helpcategory=command.CATEGORY_WORKING_DIRECTORY,
inferrepo=True)
def forget(ui, repo, *pats, **opts): def forget(ui, repo, *pats, **opts):
"""forget the specified files on the next commit """forget the specified files on the next commit
Mark the specified files so they will no longer be tracked Mark the specified files so they will no longer be tracked
after the next commit. after the next commit.
This only removes files from the current branch, not from the This only removes files from the current branch, not from the
entire project history, and it does not delete them from the entire project history, and it does not delete them from the
('', 'no-commit', None, ('', 'no-commit', None,
_("don't commit, just apply the changes in working directory")), _("don't commit, just apply the changes in working directory")),
('f', 'force', False, _('force graft')), ('f', 'force', False, _('force graft')),
('D', 'currentdate', False, ('D', 'currentdate', False,
_('record the current date as commit date')), _('record the current date as commit date')),
('U', 'currentuser', False, ('U', 'currentuser', False,
_('record the current user as committer'), _('DATE'))] _('record the current user as committer'), _('DATE'))]
+ commitopts2 + mergetoolopts + dryrunopts, + commitopts2 + mergetoolopts + dryrunopts,
_('[OPTION]... [-r REV]... REV...')) _('[OPTION]... [-r REV]... REV...'),
helpcategory=command.CATEGORY_CHANGE_MANAGEMENT)
def graft(ui, repo, *revs, **opts): def graft(ui, repo, *revs, **opts):
'''copy changes from other branches onto the current branch '''copy changes from other branches onto the current branch
This command uses Mercurial's merge logic to copy individual This command uses Mercurial's merge logic to copy individual
changes from other branches without merging branches in the changes from other branches without merging branches in the
history graph. This is sometimes known as 'backporting' or history graph. This is sometimes known as 'backporting' or
'cherry-picking'. By default, graft will copy user, date, and 'cherry-picking'. By default, graft will copy user, date, and
description from the source changesets. description from the source changesets.
('r', 'rev', [], ('r', 'rev', [],
_('only search files changed within revision range'), _('REV')), _('only search files changed within revision range'), _('REV')),
('', 'all-files', None, ('', 'all-files', None,
_('include all files in the changeset while grepping (EXPERIMENTAL)')), _('include all files in the changeset while grepping (EXPERIMENTAL)')),
('u', 'user', None, _('list the author (long with -v)')), ('u', 'user', None, _('list the author (long with -v)')),
('d', 'date', None, _('list the date (short with -q)')), ('d', 'date', None, _('list the date (short with -q)')),
] + formatteropts + walkopts, ] + formatteropts + walkopts,
_('[OPTION]... PATTERN [FILE]...'), _('[OPTION]... PATTERN [FILE]...'),
helpcategory=command.CATEGORY_FILE_CONTENTS,
inferrepo=True, inferrepo=True,
intents={INTENT_READONLY}) intents={INTENT_READONLY})
def grep(ui, repo, pattern, *pats, **opts): def grep(ui, repo, pattern, *pats, **opts):
"""search revision history for a pattern in specified files """search revision history for a pattern in specified files
Search revision history for a regular expression in the specified Search revision history for a regular expression in the specified
files or the entire project. files or the entire project.
@command('heads', @command('heads',
[('r', 'rev', '', [('r', 'rev', '',
_('show only heads which are descendants of STARTREV'), _('STARTREV')), _('show only heads which are descendants of STARTREV'), _('STARTREV')),
('t', 'topo', False, _('show topological heads only')), ('t', 'topo', False, _('show topological heads only')),
('a', 'active', False, _('show active branchheads only (DEPRECATED)')), ('a', 'active', False, _('show active branchheads only (DEPRECATED)')),
('c', 'closed', False, _('show normal and closed branch heads')), ('c', 'closed', False, _('show normal and closed branch heads')),
] + templateopts, ] + templateopts,
_('[-ct] [-r STARTREV] [REV]...'), _('[-ct] [-r STARTREV] [REV]...'),
helpcategory=command.CATEGORY_CHANGE_NAVIGATION,
intents={INTENT_READONLY}) intents={INTENT_READONLY})
def heads(ui, repo, *branchrevs, **opts): def heads(ui, repo, *branchrevs, **opts):
"""show branch heads """show branch heads
With no arguments, show all open branch heads in the repository. With no arguments, show all open branch heads in the repository.
Branch heads are changesets that have no descendants on the Branch heads are changesets that have no descendants on the
same branch. They are where development generally takes place and same branch. They are where development generally takes place and
are the usual targets for update and merge operations. are the usual targets for update and merge operations.
@command('help', @command('help',
[('e', 'extension', None, _('show only help for extensions')), [('e', 'extension', None, _('show only help for extensions')),
('c', 'command', None, _('show only help for commands')), ('c', 'command', None, _('show only help for commands')),
('k', 'keyword', None, _('show topics matching keyword')), ('k', 'keyword', None, _('show topics matching keyword')),
('s', 'system', [], _('show help for specific platform(s)')), ('s', 'system', [], _('show help for specific platform(s)')),
], ],
_('[-ecks] [TOPIC]'), _('[-ecks] [TOPIC]'),
helpcategory=command.CATEGORY_HELP,
norepo=True, norepo=True,
intents={INTENT_READONLY}) intents={INTENT_READONLY})
def help_(ui, name=None, **opts): def help_(ui, name=None, **opts):
"""show help for a given topic or a help overview """show help for a given topic or a help overview
With no arguments, print a list of commands with short help messages. With no arguments, print a list of commands with short help messages.
Given a topic, extension, or command name, print help for that Given a topic, extension, or command name, print help for that
_('identify the specified revision'), _('REV')), _('identify the specified revision'), _('REV')),
('n', 'num', None, _('show local revision number')), ('n', 'num', None, _('show local revision number')),
('i', 'id', None, _('show global revision id')), ('i', 'id', None, _('show global revision id')),
('b', 'branch', None, _('show branch')), ('b', 'branch', None, _('show branch')),
('t', 'tags', None, _('show tags')), ('t', 'tags', None, _('show tags')),
('B', 'bookmarks', None, _('show bookmarks')), ('B', 'bookmarks', None, _('show bookmarks')),
] + remoteopts + formatteropts, ] + remoteopts + formatteropts,
_('[-nibtB] [-r REV] [SOURCE]'), _('[-nibtB] [-r REV] [SOURCE]'),
helpcategory=command.CATEGORY_CHANGE_NAVIGATION,
optionalrepo=True, optionalrepo=True,
intents={INTENT_READONLY}) intents={INTENT_READONLY})
def identify(ui, repo, source=None, rev=None, def identify(ui, repo, source=None, rev=None,
num=None, id=None, branch=None, tags=None, bookmarks=None, **opts): num=None, id=None, branch=None, tags=None, bookmarks=None, **opts):
"""identify the working directory or specified revision """identify the working directory or specified revision
Print a summary identifying the repository state at REV using one or Print a summary identifying the repository state at REV using one or
two parent hash identifiers, followed by a "+" if the working two parent hash identifiers, followed by a "+" if the working
_('commit even if some hunks fail')), _('commit even if some hunks fail')),
('', 'exact', None, ('', 'exact', None,
_('abort if patch would apply lossily')), _('abort if patch would apply lossily')),
('', 'prefix', '', ('', 'prefix', '',
_('apply patch to subdirectory'), _('DIR')), _('apply patch to subdirectory'), _('DIR')),
('', 'import-branch', None, ('', 'import-branch', None,
_('use any branch information in patch (implied by --exact)'))] + _('use any branch information in patch (implied by --exact)'))] +
commitopts + commitopts2 + similarityopts, commitopts + commitopts2 + similarityopts,
_('[OPTION]... PATCH...')) _('[OPTION]... PATCH...'),
helpcategory=command.CATEGORY_IMPORT_EXPORT)
def import_(ui, repo, patch1=None, *patches, **opts): def import_(ui, repo, patch1=None, *patches, **opts):
"""import an ordered set of patches """import an ordered set of patches
Import a list of patches and commit them individually (unless Import a list of patches and commit them individually (unless
--no-commit is specified). --no-commit is specified).
To read a patch from standard input (stdin), use "-" as the patch To read a patch from standard input (stdin), use "-" as the patch
name. If a URL is specified, the patch will be downloaded from name. If a URL is specified, the patch will be downloaded from
('n', 'newest-first', None, _('show newest record first')), ('n', 'newest-first', None, _('show newest record first')),
('', 'bundle', '', ('', 'bundle', '',
_('file to store the bundles into'), _('FILE')), _('file to store the bundles into'), _('FILE')),
('r', 'rev', [], _('a remote changeset intended to be added'), _('REV')), ('r', 'rev', [], _('a remote changeset intended to be added'), _('REV')),
('B', 'bookmarks', False, _("compare bookmarks")), ('B', 'bookmarks', False, _("compare bookmarks")),
('b', 'branch', [], ('b', 'branch', [],
_('a specific branch you would like to pull'), _('BRANCH')), _('a specific branch you would like to pull'), _('BRANCH')),
] + logopts + remoteopts + subrepoopts, ] + logopts + remoteopts + subrepoopts,
_('[-p] [-n] [-M] [-f] [-r REV]... [--bundle FILENAME] [SOURCE]')) _('[-p] [-n] [-M] [-f] [-r REV]... [--bundle FILENAME] [SOURCE]'),
helpcategory=command.CATEGORY_REMOTE_REPO_MANAGEMENT)
def incoming(ui, repo, source="default", **opts): def incoming(ui, repo, source="default", **opts):
"""show new changesets found in source """show new changesets found in source
Show new changesets found in the specified path/URL or the default Show new changesets found in the specified path/URL or the default
pull location. These are the changesets that would have been pulled pull location. These are the changesets that would have been pulled
by :hg:`pull` at the time you issued this command. by :hg:`pull` at the time you issued this command.
See pull for valid source format details. See pull for valid source format details.
repo._subtoppath = ui.expandpath(source) repo._subtoppath = ui.expandpath(source)
try: try:
return hg.incoming(ui, repo, source, opts) return hg.incoming(ui, repo, source, opts)
finally: finally:
del repo._subtoppath del repo._subtoppath
@command('^init', remoteopts, _('[-e CMD] [--remotecmd CMD] [DEST]'), @command('^init', remoteopts, _('[-e CMD] [--remotecmd CMD] [DEST]'),
helpcategory=command.CATEGORY_REPO_CREATION,
norepo=True) norepo=True)
def init(ui, dest=".", **opts): def init(ui, dest=".", **opts):
"""create a new repository in the given directory """create a new repository in the given directory
Initialize a new repository in the given directory. If the given Initialize a new repository in the given directory. If the given
directory does not exist, it will be created. directory does not exist, it will be created.
If no directory is given, the current directory is used. If no directory is given, the current directory is used.
It is possible to specify an ``ssh://`` URL as the destination. It is possible to specify an ``ssh://`` URL as the destination.
See :hg:`help urls` for more information. See :hg:`help urls` for more information.
Returns 0 on success. Returns 0 on success.
""" """
opts = pycompat.byteskwargs(opts) opts = pycompat.byteskwargs(opts)
hg.peer(ui, opts, ui.expandpath(dest), create=True) hg.peer(ui, opts, ui.expandpath(dest), create=True)
@command('locate', @command('locate',
[('r', 'rev', '', _('search the repository as it is in REV'), _('REV')), [('r', 'rev', '', _('search the repository as it is in REV'), _('REV')),
('0', 'print0', None, _('end filenames with NUL, for use with xargs')), ('0', 'print0', None, _('end filenames with NUL, for use with xargs')),
('f', 'fullpath', None, _('print complete paths from the filesystem root')), ('f', 'fullpath', None, _('print complete paths from the filesystem root')),
] + walkopts, ] + walkopts,
_('[OPTION]... [PATTERN]...')) _('[OPTION]... [PATTERN]...'),
helpcategory=command.CATEGORY_WORKING_DIRECTORY)
def locate(ui, repo, *pats, **opts): def locate(ui, repo, *pats, **opts):
"""locate files matching specific patterns (DEPRECATED) """locate files matching specific patterns (DEPRECATED)
Print files under Mercurial control in the working directory whose Print files under Mercurial control in the working directory whose
names match the given patterns. names match the given patterns.
By default, this command searches all directories in the working By default, this command searches all directories in the working
directory. To search just the current directory and its directory. To search just the current directory and its
_('show only changesets within the given named branch (DEPRECATED)'), _('show only changesets within the given named branch (DEPRECATED)'),
_('BRANCH')), _('BRANCH')),
('b', 'branch', [], ('b', 'branch', [],
_('show changesets within the given named branch'), _('BRANCH')), _('show changesets within the given named branch'), _('BRANCH')),
('P', 'prune', [], ('P', 'prune', [],
_('do not display revision or any of its ancestors'), _('REV')), _('do not display revision or any of its ancestors'), _('REV')),
] + logopts + walkopts, ] + logopts + walkopts,
_('[OPTION]... [FILE]'), _('[OPTION]... [FILE]'),
helpcategory=command.CATEGORY_CHANGE_NAVIGATION,
inferrepo=True, inferrepo=True,
intents={INTENT_READONLY}) intents={INTENT_READONLY})
def log(ui, repo, *pats, **opts): def log(ui, repo, *pats, **opts):
"""show revision history of entire repository or files """show revision history of entire repository or files
Print the revision history of the specified files or the entire Print the revision history of the specified files or the entire
project. project.
displayfn = logcmdutil.displayrevs displayfn = logcmdutil.displayrevs
displayfn(ui, repo, revs, displayer, getrenamed) displayfn(ui, repo, revs, displayer, getrenamed)
@command('manifest', @command('manifest',
[('r', 'rev', '', _('revision to display'), _('REV')), [('r', 'rev', '', _('revision to display'), _('REV')),
('', 'all', False, _("list files from all revisions"))] ('', 'all', False, _("list files from all revisions"))]
+ formatteropts, + formatteropts,
_('[-r REV]'), _('[-r REV]'),
helpcategory=command.CATEGORY_MAINTENANCE,
intents={INTENT_READONLY}) intents={INTENT_READONLY})
def manifest(ui, repo, node=None, rev=None, **opts): def manifest(ui, repo, node=None, rev=None, **opts):
"""output the current or given revision of the project manifest """output the current or given revision of the project manifest
Print a list of version controlled files for the given revision. Print a list of version controlled files for the given revision.
If no revision is given, the first parent of the working directory If no revision is given, the first parent of the working directory
is used, or the null revision if no revision is checked out. is used, or the null revision if no revision is checked out.
@command('^merge', @command('^merge',
[('f', 'force', None, [('f', 'force', None,
_('force a merge including outstanding changes (DEPRECATED)')), _('force a merge including outstanding changes (DEPRECATED)')),
('r', 'rev', '', _('revision to merge'), _('REV')), ('r', 'rev', '', _('revision to merge'), _('REV')),
('P', 'preview', None, ('P', 'preview', None,
_('review revisions to merge (no merge is performed)')), _('review revisions to merge (no merge is performed)')),
('', 'abort', None, _('abort the ongoing merge')), ('', 'abort', None, _('abort the ongoing merge')),
] + mergetoolopts, ] + mergetoolopts,
_('[-P] [[-r] REV]')) _('[-P] [[-r] REV]'),
helpcategory=command.CATEGORY_CHANGE_MANAGEMENT)
def merge(ui, repo, node=None, **opts): def merge(ui, repo, node=None, **opts):
"""merge another revision into working directory """merge another revision into working directory
The current working directory is updated with all changes made in The current working directory is updated with all changes made in
the requested revision since the last common predecessor revision. the requested revision since the last common predecessor revision.
Files that changed between either parent are marked as changed for Files that changed between either parent are marked as changed for
the next commit and a commit must be performed before any further the next commit and a commit must be performed before any further
[('f', 'force', None, _('run even when the destination is unrelated')), [('f', 'force', None, _('run even when the destination is unrelated')),
('r', 'rev', [], ('r', 'rev', [],
_('a changeset intended to be included in the destination'), _('REV')), _('a changeset intended to be included in the destination'), _('REV')),
('n', 'newest-first', None, _('show newest record first')), ('n', 'newest-first', None, _('show newest record first')),
('B', 'bookmarks', False, _('compare bookmarks')), ('B', 'bookmarks', False, _('compare bookmarks')),
('b', 'branch', [], _('a specific branch you would like to push'), ('b', 'branch', [], _('a specific branch you would like to push'),
_('BRANCH')), _('BRANCH')),
] + logopts + remoteopts + subrepoopts, ] + logopts + remoteopts + subrepoopts,
_('[-M] [-p] [-n] [-f] [-r REV]... [DEST]')) _('[-M] [-p] [-n] [-f] [-r REV]... [DEST]'),
helpcategory=command.CATEGORY_REMOTE_REPO_MANAGEMENT)
def outgoing(ui, repo, dest=None, **opts): def outgoing(ui, repo, dest=None, **opts):
"""show changesets not found in the destination """show changesets not found in the destination
Show changesets not found in the specified destination repository Show changesets not found in the specified destination repository
or the default push location. These are the changesets that would or the default push location. These are the changesets that would
be pushed if a push was requested. be pushed if a push was requested.
See pull for details of valid destination formats. See pull for details of valid destination formats.
return hg.outgoing(ui, repo, dest, opts) return hg.outgoing(ui, repo, dest, opts)
finally: finally:
del repo._subtoppath del repo._subtoppath
@command('parents', @command('parents',
[('r', 'rev', '', _('show parents of the specified revision'), _('REV')), [('r', 'rev', '', _('show parents of the specified revision'), _('REV')),
] + templateopts, ] + templateopts,
_('[-r REV] [FILE]'), _('[-r REV] [FILE]'),
helpcategory=command.CATEGORY_CHANGE_NAVIGATION,
inferrepo=True) inferrepo=True)
def parents(ui, repo, file_=None, **opts): def parents(ui, repo, file_=None, **opts):
"""show the parents of the working directory or revision (DEPRECATED) """show the parents of the working directory or revision (DEPRECATED)
Print the working directory's parent revisions. If a revision is Print the working directory's parent revisions. If a revision is
given via -r/--rev, the parent of that revision will be printed. given via -r/--rev, the parent of that revision will be printed.
If a file argument is given, the revision in which the file was If a file argument is given, the revision in which the file was
last changed (before the working directory revision or the last changed (before the working directory revision or the
p = [cp.node() for cp in ctx.parents()] p = [cp.node() for cp in ctx.parents()]
displayer = logcmdutil.changesetdisplayer(ui, repo, opts) displayer = logcmdutil.changesetdisplayer(ui, repo, opts)
for n in p: for n in p:
if n != nullid: if n != nullid:
displayer.show(repo[n]) displayer.show(repo[n])
displayer.close() displayer.close()
@command('paths', formatteropts, _('[NAME]'), optionalrepo=True, @command('paths', formatteropts, _('[NAME]'),
intents={INTENT_READONLY}) helpcategory=command.CATEGORY_REMOTE_REPO_MANAGEMENT,
optionalrepo=True, intents={INTENT_READONLY})
def paths(ui, repo, search=None, **opts): def paths(ui, repo, search=None, **opts):
"""show aliases for remote repositories """show aliases for remote repositories
Show definition of symbolic path name NAME. If no name is given, Show definition of symbolic path name NAME. If no name is given,
show definition of all available names. show definition of all available names.
Option -q/--quiet suppresses all output when searching for NAME Option -q/--quiet suppresses all output when searching for NAME
and shows only the path names when listing all definitions. and shows only the path names when listing all definitions.
@command('phase', @command('phase',
[('p', 'public', False, _('set changeset phase to public')), [('p', 'public', False, _('set changeset phase to public')),
('d', 'draft', False, _('set changeset phase to draft')), ('d', 'draft', False, _('set changeset phase to draft')),
('s', 'secret', False, _('set changeset phase to secret')), ('s', 'secret', False, _('set changeset phase to secret')),
('f', 'force', False, _('allow to move boundary backward')), ('f', 'force', False, _('allow to move boundary backward')),
('r', 'rev', [], _('target revision'), _('REV')), ('r', 'rev', [], _('target revision'), _('REV')),
], ],
_('[-p|-d|-s] [-f] [-r] [REV...]')) _('[-p|-d|-s] [-f] [-r] [REV...]'),
helpcategory=command.CATEGORY_CHANGE_ORGANIZATION)
def phase(ui, repo, *revs, **opts): def phase(ui, repo, *revs, **opts):
"""set or show the current phase name """set or show the current phase name
With no argument, show the phase name of the current revision(s). With no argument, show the phase name of the current revision(s).
With one of -p/--public, -d/--draft or -s/--secret, change the With one of -p/--public, -d/--draft or -s/--secret, change the
phase value of the specified revisions. phase value of the specified revisions.
[('u', 'update', None, [('u', 'update', None,
_('update to new branch head if new descendants were pulled')), _('update to new branch head if new descendants were pulled')),
('f', 'force', None, _('run even when remote repository is unrelated')), ('f', 'force', None, _('run even when remote repository is unrelated')),
('r', 'rev', [], _('a remote changeset intended to be added'), _('REV')), ('r', 'rev', [], _('a remote changeset intended to be added'), _('REV')),
('B', 'bookmark', [], _("bookmark to pull"), _('BOOKMARK')), ('B', 'bookmark', [], _("bookmark to pull"), _('BOOKMARK')),
('b', 'branch', [], _('a specific branch you would like to pull'), ('b', 'branch', [], _('a specific branch you would like to pull'),
_('BRANCH')), _('BRANCH')),
] + remoteopts, ] + remoteopts,
_('[-u] [-f] [-r REV]... [-e CMD] [--remotecmd CMD] [SOURCE]')) _('[-u] [-f] [-r REV]... [-e CMD] [--remotecmd CMD] [SOURCE]'),
helpcategory=command.CATEGORY_REMOTE_REPO_MANAGEMENT)
def pull(ui, repo, source="default", **opts): def pull(ui, repo, source="default", **opts):
"""pull changes from the specified source """pull changes from the specified source
Pull changes from a remote repository to a local one. Pull changes from a remote repository to a local one.
This finds all changes from the repository at the specified path This finds all changes from the repository at the specified path
or URL and adds them to a local repository (the current one unless or URL and adds them to a local repository (the current one unless
-R is specified). By default, this does not update the copy of the -R is specified). By default, this does not update the copy of the
_('a changeset intended to be included in the destination'), _('a changeset intended to be included in the destination'),
_('REV')), _('REV')),
('B', 'bookmark', [], _("bookmark to push"), _('BOOKMARK')), ('B', 'bookmark', [], _("bookmark to push"), _('BOOKMARK')),
('b', 'branch', [], ('b', 'branch', [],
_('a specific branch you would like to push'), _('BRANCH')), _('a specific branch you would like to push'), _('BRANCH')),
('', 'new-branch', False, _('allow pushing a new branch')), ('', 'new-branch', False, _('allow pushing a new branch')),
('', 'pushvars', [], _('variables that can be sent to server (ADVANCED)')), ('', 'pushvars', [], _('variables that can be sent to server (ADVANCED)')),
] + remoteopts, ] + remoteopts,
_('[-f] [-r REV]... [-e CMD] [--remotecmd CMD] [DEST]')) _('[-f] [-r REV]... [-e CMD] [--remotecmd CMD] [DEST]'),
helpcategory=command.CATEGORY_REMOTE_REPO_MANAGEMENT)
def push(ui, repo, dest=None, **opts): def push(ui, repo, dest=None, **opts):
"""push changes to the specified destination """push changes to the specified destination
Push changesets from the local repository to the specified Push changesets from the local repository to the specified
destination. destination.
This operation is symmetrical to pull: it is identical to a pull This operation is symmetrical to pull: it is identical to a pull
in the destination repository from the current one. in the destination repository from the current one.
if pushop.bkresult is not None: if pushop.bkresult is not None:
if pushop.bkresult == 2: if pushop.bkresult == 2:
result = 2 result = 2
elif not result and pushop.bkresult: elif not result and pushop.bkresult:
result = 2 result = 2
return result return result
@command('recover', []) @command('recover', [], helpcategory=command.CATEGORY_MAINTENANCE)
def recover(ui, repo): def recover(ui, repo):
"""roll back an interrupted transaction """roll back an interrupted transaction
Recover from an interrupted commit or pull. Recover from an interrupted commit or pull.
This command tries to fix the repository status after an This command tries to fix the repository status after an
interrupted operation. It should only be necessary when Mercurial interrupted operation. It should only be necessary when Mercurial
suggests it. suggests it.
Returns 0 if successful, 1 if nothing to recover or verify fails. Returns 0 if successful, 1 if nothing to recover or verify fails.
""" """
if repo.recover(): if repo.recover():
return hg.verify(repo) return hg.verify(repo)
return 1 return 1
@command('^remove|rm', @command('^remove|rm',
[('A', 'after', None, _('record delete for missing files')), [('A', 'after', None, _('record delete for missing files')),
('f', 'force', None, ('f', 'force', None,
_('forget added files, delete modified files')), _('forget added files, delete modified files')),
] + subrepoopts + walkopts + dryrunopts, ] + subrepoopts + walkopts + dryrunopts,
_('[OPTION]... FILE...'), _('[OPTION]... FILE...'),
helpcategory=command.CATEGORY_WORKING_DIRECTORY,
inferrepo=True) inferrepo=True)
def remove(ui, repo, *pats, **opts): def remove(ui, repo, *pats, **opts):
"""remove the specified files on the next commit """remove the specified files on the next commit
Schedule the indicated files for removal from the current branch. Schedule the indicated files for removal from the current branch.
This command schedules the files to be removed at the next commit. This command schedules the files to be removed at the next commit.
To undo a remove before that, see :hg:`revert`. To undo added To undo a remove before that, see :hg:`revert`. To undo added
subrepos = opts.get('subrepos') subrepos = opts.get('subrepos')
return cmdutil.remove(ui, repo, m, "", after, force, subrepos, return cmdutil.remove(ui, repo, m, "", after, force, subrepos,
dryrun=dryrun) dryrun=dryrun)
@command('rename|move|mv', @command('rename|move|mv',
[('A', 'after', None, _('record a rename that has already occurred')), [('A', 'after', None, _('record a rename that has already occurred')),
('f', 'force', None, _('forcibly copy over an existing managed file')), ('f', 'force', None, _('forcibly copy over an existing managed file')),
] + walkopts + dryrunopts, ] + walkopts + dryrunopts,
_('[OPTION]... SOURCE... DEST')) _('[OPTION]... SOURCE... DEST'),
helpcategory=command.CATEGORY_WORKING_DIRECTORY)
def rename(ui, repo, *pats, **opts): def rename(ui, repo, *pats, **opts):
"""rename files; equivalent of copy + remove """rename files; equivalent of copy + remove
Mark dest as copies of sources; mark sources for deletion. If dest Mark dest as copies of sources; mark sources for deletion. If dest
is a directory, copies are put in that directory. If dest is a is a directory, copies are put in that directory. If dest is a
file, there can only be one source. file, there can only be one source.
By default, this command copies the contents of files as they By default, this command copies the contents of files as they
[('a', 'all', None, _('select all unresolved files')), [('a', 'all', None, _('select all unresolved files')),
('l', 'list', None, _('list state of files needing merge')), ('l', 'list', None, _('list state of files needing merge')),
('m', 'mark', None, _('mark files as resolved')), ('m', 'mark', None, _('mark files as resolved')),
('u', 'unmark', None, _('mark files as unresolved')), ('u', 'unmark', None, _('mark files as unresolved')),
('n', 'no-status', None, _('hide status prefix')), ('n', 'no-status', None, _('hide status prefix')),
('', 're-merge', None, _('re-merge files'))] ('', 're-merge', None, _('re-merge files'))]
+ mergetoolopts + walkopts + formatteropts, + mergetoolopts + walkopts + formatteropts,
_('[OPTION]... [FILE]...'), _('[OPTION]... [FILE]...'),
helpcategory=command.CATEGORY_WORKING_DIRECTORY,
inferrepo=True) inferrepo=True)
def resolve(ui, repo, *pats, **opts): def resolve(ui, repo, *pats, **opts):
"""redo merges or set/view the merge status of files """redo merges or set/view the merge status of files
Merges with unresolved conflicts are often the result of Merges with unresolved conflicts are often the result of
non-interactive merging using the ``internal:merge`` configuration non-interactive merging using the ``internal:merge`` configuration
setting, or a command-line merge tool like ``diff3``. The resolve setting, or a command-line merge tool like ``diff3``. The resolve
command is used to manage the files involved in a merge, after command is used to manage the files involved in a merge, after
@command('revert', @command('revert',
[('a', 'all', None, _('revert all changes when no arguments given')), [('a', 'all', None, _('revert all changes when no arguments given')),
('d', 'date', '', _('tipmost revision matching date'), _('DATE')), ('d', 'date', '', _('tipmost revision matching date'), _('DATE')),
('r', 'rev', '', _('revert to the specified revision'), _('REV')), ('r', 'rev', '', _('revert to the specified revision'), _('REV')),
('C', 'no-backup', None, _('do not save backup copies of files')), ('C', 'no-backup', None, _('do not save backup copies of files')),
('i', 'interactive', None, _('interactively select the changes')), ('i', 'interactive', None, _('interactively select the changes')),
] + walkopts + dryrunopts, ] + walkopts + dryrunopts,
_('[OPTION]... [-r REV] [NAME]...')) _('[OPTION]... [-r REV] [NAME]...'),
helpcategory=command.CATEGORY_WORKING_DIRECTORY)
def revert(ui, repo, *pats, **opts): def revert(ui, repo, *pats, **opts):
"""restore files to their checkout state """restore files to their checkout state
.. note:: .. note::
To check out earlier revisions, you should use :hg:`update REV`. To check out earlier revisions, you should use :hg:`update REV`.
To cancel an uncommitted merge (and lose your changes), To cancel an uncommitted merge (and lose your changes),
use :hg:`merge --abort`. use :hg:`merge --abort`.
hint = _("uncommitted changes, use --all to discard all changes") hint = _("uncommitted changes, use --all to discard all changes")
else: else:
hint = _("use --all to revert all files") hint = _("use --all to revert all files")
raise error.Abort(msg, hint=hint) raise error.Abort(msg, hint=hint)
return cmdutil.revert(ui, repo, ctx, (parent, p2), *pats, return cmdutil.revert(ui, repo, ctx, (parent, p2), *pats,
**pycompat.strkwargs(opts)) **pycompat.strkwargs(opts))
@command('rollback', dryrunopts + @command(
[('f', 'force', False, _('ignore safety measures'))]) 'rollback',
dryrunopts + [('f', 'force', False, _('ignore safety measures'))],
helpcategory=command.CATEGORY_MAINTENANCE)
def rollback(ui, repo, **opts): def rollback(ui, repo, **opts):
"""roll back the last transaction (DANGEROUS) (DEPRECATED) """roll back the last transaction (DANGEROUS) (DEPRECATED)
Please use :hg:`commit --amend` instead of rollback to correct Please use :hg:`commit --amend` instead of rollback to correct
mistakes in the last commit. mistakes in the last commit.
This command should be used with care. There is only one level of This command should be used with care. There is only one level of
rollback, and there is no way to undo a rollback. It will also rollback, and there is no way to undo a rollback. It will also
Returns 0 on success, 1 if no rollback data is available. Returns 0 on success, 1 if no rollback data is available.
""" """
if not ui.configbool('ui', 'rollback'): if not ui.configbool('ui', 'rollback'):
raise error.Abort(_('rollback is disabled because it is unsafe'), raise error.Abort(_('rollback is disabled because it is unsafe'),
hint=('see `hg help -v rollback` for information')) hint=('see `hg help -v rollback` for information'))
return repo.rollback(dryrun=opts.get(r'dry_run'), return repo.rollback(dryrun=opts.get(r'dry_run'),
force=opts.get(r'force')) force=opts.get(r'force'))
@command('root', [], intents={INTENT_READONLY}) @command(
'root', [], intents={INTENT_READONLY},
helpcategory=command.CATEGORY_WORKING_DIRECTORY)
def root(ui, repo): def root(ui, repo):
"""print the root (top) of the current working directory """print the root (top) of the current working directory
Print the root directory of the current repository. Print the root directory of the current repository.
Returns 0 on success. Returns 0 on success.
""" """
ui.write(repo.root + "\n") ui.write(repo.root + "\n")
('', 'cmdserver', '', _('for remote clients (ADVANCED)'), _('MODE')), ('', 'cmdserver', '', _('for remote clients (ADVANCED)'), _('MODE')),
('t', 'templates', '', _('web templates to use'), _('TEMPLATE')), ('t', 'templates', '', _('web templates to use'), _('TEMPLATE')),
('', 'style', '', _('template style to use'), _('STYLE')), ('', 'style', '', _('template style to use'), _('STYLE')),
('6', 'ipv6', None, _('use IPv6 in addition to IPv4')), ('6', 'ipv6', None, _('use IPv6 in addition to IPv4')),
('', 'certificate', '', _('SSL certificate file'), _('FILE')), ('', 'certificate', '', _('SSL certificate file'), _('FILE')),
('', 'print-url', None, _('start and print only the URL'))] ('', 'print-url', None, _('start and print only the URL'))]
+ subrepoopts, + subrepoopts,
_('[OPTION]...'), _('[OPTION]...'),
helpcategory=command.CATEGORY_REMOTE_REPO_MANAGEMENT,
optionalrepo=True) optionalrepo=True)
def serve(ui, repo, **opts): def serve(ui, repo, **opts):
"""start stand-alone webserver """start stand-alone webserver
Start a local HTTP repository browser and pull server. You can use Start a local HTTP repository browser and pull server. You can use
this for ad-hoc sharing and browsing of repositories. It is this for ad-hoc sharing and browsing of repositories. It is
recommended to use a real web server to serve a repository for recommended to use a real web server to serve a repository for
longer periods of time. longer periods of time.
('n', 'no-status', None, _('hide status prefix')), ('n', 'no-status', None, _('hide status prefix')),
('t', 'terse', _NOTTERSE, _('show the terse output (EXPERIMENTAL)')), ('t', 'terse', _NOTTERSE, _('show the terse output (EXPERIMENTAL)')),
('C', 'copies', None, _('show source of copied files')), ('C', 'copies', None, _('show source of copied files')),
('0', 'print0', None, _('end filenames with NUL, for use with xargs')), ('0', 'print0', None, _('end filenames with NUL, for use with xargs')),
('', 'rev', [], _('show difference from revision'), _('REV')), ('', 'rev', [], _('show difference from revision'), _('REV')),
('', 'change', '', _('list the changed files of a revision'), _('REV')), ('', 'change', '', _('list the changed files of a revision'), _('REV')),
] + walkopts + subrepoopts + formatteropts, ] + walkopts + subrepoopts + formatteropts,
_('[OPTION]... [FILE]...'), _('[OPTION]... [FILE]...'),
helpcategory=command.CATEGORY_WORKING_DIRECTORY,
inferrepo=True, inferrepo=True,
intents={INTENT_READONLY}) intents={INTENT_READONLY})
def status(ui, repo, *pats, **opts): def status(ui, repo, *pats, **opts):
"""show changed files in the working directory """show changed files in the working directory
Show status of files in the repository. If names are given, only Show status of files in the repository. If names are given, only
files that match are shown. Files that are clean or ignored or files that match are shown. Files that are clean or ignored or
the source of a copy/move operation, are not listed unless the source of a copy/move operation, are not listed unless
if ((ui.verbose or ui.configbool('commands', 'status.verbose')) if ((ui.verbose or ui.configbool('commands', 'status.verbose'))
and not ui.plain()): and not ui.plain()):
cmdutil.morestatus(repo, fm) cmdutil.morestatus(repo, fm)
fm.end() fm.end()
@command('^summary|sum', @command('^summary|sum',
[('', 'remote', None, _('check for push and pull'))], [('', 'remote', None, _('check for push and pull'))],
'[--remote]', '[--remote]',
helpcategory=command.CATEGORY_WORKING_DIRECTORY,
intents={INTENT_READONLY}) intents={INTENT_READONLY})
def summary(ui, repo, **opts): def summary(ui, repo, **opts):
"""summarize working directory state """summarize working directory state
This generates a brief summary of the working directory state, This generates a brief summary of the working directory state,
including parents, branch, commit status, phase and available updates. including parents, branch, commit status, phase and available updates.
With the --remote option, this will check the default paths for With the --remote option, this will check the default paths for
[('f', 'force', None, _('force tag')), [('f', 'force', None, _('force tag')),
('l', 'local', None, _('make the tag local')), ('l', 'local', None, _('make the tag local')),
('r', 'rev', '', _('revision to tag'), _('REV')), ('r', 'rev', '', _('revision to tag'), _('REV')),
('', 'remove', None, _('remove a tag')), ('', 'remove', None, _('remove a tag')),
# -l/--local is already there, commitopts cannot be used # -l/--local is already there, commitopts cannot be used
('e', 'edit', None, _('invoke editor on commit messages')), ('e', 'edit', None, _('invoke editor on commit messages')),
('m', 'message', '', _('use text as commit message'), _('TEXT')), ('m', 'message', '', _('use text as commit message'), _('TEXT')),
] + commitopts2, ] + commitopts2,
_('[-f] [-l] [-m TEXT] [-d DATE] [-u USER] [-r REV] NAME...')) _('[-f] [-l] [-m TEXT] [-d DATE] [-u USER] [-r REV] NAME...'),
helpcategory=command.CATEGORY_CHANGE_ORGANIZATION)
def tag(ui, repo, name1, *names, **opts): def tag(ui, repo, name1, *names, **opts):
"""add one or more tags for the current or given revision """add one or more tags for the current or given revision
Name a particular revision using <name>. Name a particular revision using <name>.
Tags are used to name particular revisions of the repository and are Tags are used to name particular revisions of the repository and are
very useful to compare different revisions, to go back to significant very useful to compare different revisions, to go back to significant
earlier versions or to mark branch points as releases, etc. Changing earlier versions or to mark branch points as releases, etc. Changing
# don't allow tagging the null rev # don't allow tagging the null rev
if (not opts.get('remove') and if (not opts.get('remove') and
scmutil.revsingle(repo, rev_).rev() == nullrev): scmutil.revsingle(repo, rev_).rev() == nullrev):
raise error.Abort(_("cannot tag null revision")) raise error.Abort(_("cannot tag null revision"))
tagsmod.tag(repo, names, node, message, opts.get('local'), tagsmod.tag(repo, names, node, message, opts.get('local'),
opts.get('user'), date, editor=editor) opts.get('user'), date, editor=editor)
@command('tags', formatteropts, '', intents={INTENT_READONLY}) @command(
'tags', formatteropts, '',
helpcategory=command.CATEGORY_CHANGE_ORGANIZATION,
intents={INTENT_READONLY})
def tags(ui, repo, **opts): def tags(ui, repo, **opts):
"""list repository tags """list repository tags
This lists both regular and local tags. When the -v/--verbose This lists both regular and local tags. When the -v/--verbose
switch is used, a third column "local" is printed for local tags. switch is used, a third column "local" is printed for local tags.
When the -q/--quiet switch is used, only the tag name is printed. When the -q/--quiet switch is used, only the tag name is printed.
.. container:: verbose .. container:: verbose
tagtype, label=label) tagtype, label=label)
fm.plain('\n') fm.plain('\n')
fm.end() fm.end()
@command('tip', @command('tip',
[('p', 'patch', None, _('show patch')), [('p', 'patch', None, _('show patch')),
('g', 'git', None, _('use git extended diff format')), ('g', 'git', None, _('use git extended diff format')),
] + templateopts, ] + templateopts,
_('[-p] [-g]')) _('[-p] [-g]'),
helpcategory=command.CATEGORY_CHANGE_NAVIGATION)
def tip(ui, repo, **opts): def tip(ui, repo, **opts):
"""show the tip revision (DEPRECATED) """show the tip revision (DEPRECATED)
The tip revision (usually just called the tip) is the changeset The tip revision (usually just called the tip) is the changeset
most recently added to the repository (and therefore the most most recently added to the repository (and therefore the most
recently changed head). recently changed head).
If you have just made a commit, that commit will be the tip. If If you have just made a commit, that commit will be the tip. If
you have just pulled changes from another repository, the tip of you have just pulled changes from another repository, the tip of
that repository becomes the current tip. The "tip" tag is special that repository becomes the current tip. The "tip" tag is special
and cannot be renamed or assigned to a different changeset. and cannot be renamed or assigned to a different changeset.
This command is deprecated, please use :hg:`heads` instead. This command is deprecated, please use :hg:`heads` instead.
Returns 0 on success. Returns 0 on success.
""" """
opts = pycompat.byteskwargs(opts) opts = pycompat.byteskwargs(opts)
displayer = logcmdutil.changesetdisplayer(ui, repo, opts) displayer = logcmdutil.changesetdisplayer(ui, repo, opts)
displayer.show(repo['tip']) displayer.show(repo['tip'])
displayer.close() displayer.close()
@command('unbundle', @command('unbundle',
[('u', 'update', None, [('u', 'update', None,
_('update to new branch head if changesets were unbundled'))], _('update to new branch head if changesets were unbundled'))],
_('[-u] FILE...')) _('[-u] FILE...'),
helpcategory=command.CATEGORY_IMPORT_EXPORT)
def unbundle(ui, repo, fname1, *fnames, **opts): def unbundle(ui, repo, fname1, *fnames, **opts):
"""apply one or more bundle files """apply one or more bundle files
Apply one or more bundle files generated by :hg:`bundle`. Apply one or more bundle files generated by :hg:`bundle`.
Returns 0 on success, 1 if an update has unresolved files. Returns 0 on success, 1 if an update has unresolved files.
""" """
fnames = (fname1,) + fnames fnames = (fname1,) + fnames
@command('^update|up|checkout|co', @command('^update|up|checkout|co',
[('C', 'clean', None, _('discard uncommitted changes (no backup)')), [('C', 'clean', None, _('discard uncommitted changes (no backup)')),
('c', 'check', None, _('require clean working directory')), ('c', 'check', None, _('require clean working directory')),
('m', 'merge', None, _('merge uncommitted changes')), ('m', 'merge', None, _('merge uncommitted changes')),
('d', 'date', '', _('tipmost revision matching date'), _('DATE')), ('d', 'date', '', _('tipmost revision matching date'), _('DATE')),
('r', 'rev', '', _('revision'), _('REV')) ('r', 'rev', '', _('revision'), _('REV'))
] + mergetoolopts, ] + mergetoolopts,
_('[-C|-c|-m] [-d DATE] [[-r] REV]')) _('[-C|-c|-m] [-d DATE] [[-r] REV]'),
helpcategory=command.CATEGORY_WORKING_DIRECTORY)
def update(ui, repo, node=None, **opts): def update(ui, repo, node=None, **opts):
"""update working directory (or switch revisions) """update working directory (or switch revisions)
Update the repository's working directory to the specified Update the repository's working directory to the specified
changeset. If no changeset is specified, update to the tip of the changeset. If no changeset is specified, update to the tip of the
current named branch and move the active bookmark (see :hg:`help current named branch and move the active bookmark (see :hg:`help
bookmarks`). bookmarks`).
ctxstr = ctx.hex()[:12] ctxstr = ctx.hex()[:12]
ui.warn(_("updated to hidden changeset %s\n") % ctxstr) ui.warn(_("updated to hidden changeset %s\n") % ctxstr)
if ctx.obsolete(): if ctx.obsolete():
obsfatemsg = obsutil._getfilteredreason(repo, ctxstr, ctx) obsfatemsg = obsutil._getfilteredreason(repo, ctxstr, ctx)
ui.warn("(%s)\n" % obsfatemsg) ui.warn("(%s)\n" % obsfatemsg)
return ret return ret
@command('verify', []) @command('verify', [], helpcategory=command.CATEGORY_MAINTENANCE)
def verify(ui, repo): def verify(ui, repo):
"""verify the integrity of the repository """verify the integrity of the repository
Verify the integrity of the current repository. Verify the integrity of the current repository.
This will perform an extensive check of the repository's This will perform an extensive check of the repository's
integrity, validating the hashes and checksums of each entry in integrity, validating the hashes and checksums of each entry in
the changelog, manifest, and tracked files, as well as the the changelog, manifest, and tracked files, as well as the
integrity of their crosslinks and indices. integrity of their crosslinks and indices.
Please see https://mercurial-scm.org/wiki/RepositoryCorruption Please see https://mercurial-scm.org/wiki/RepositoryCorruption
for more information about recovery from corruption of the for more information about recovery from corruption of the
repository. repository.
Returns 0 on success, 1 if errors are encountered. Returns 0 on success, 1 if errors are encountered.
""" """
return hg.verify(repo) return hg.verify(repo)
@command('version', [] + formatteropts, norepo=True, @command(
intents={INTENT_READONLY}) 'version', [] + formatteropts, helpcategory=command.CATEGORY_HELP,
norepo=True, intents={INTENT_READONLY})
def version_(ui, **opts): def version_(ui, **opts):
"""output version and copyright information """output version and copyright information
.. container:: verbose .. container:: verbose
Template: Template:
The following keywords are supported. See also :hg:`help templates`. The following keywords are supported. See also :hg:`help templates`.

mercurial/help.py

_("(EXPERIMENTAL)"), _("(EXPERIMENTAL)"),
} }
# The order in which command categories will be displayed. # The order in which command categories will be displayed.
# Extensions with custom categories should insert them into this list # Extensions with custom categories should insert them into this list
# after/before the appropriate item, rather than replacing the list or # after/before the appropriate item, rather than replacing the list or
# assuming absolute positions. # assuming absolute positions.
CATEGORY_ORDER = [ CATEGORY_ORDER = [
registrar.command.CATEGORY_REPO_CREATION,
registrar.command.CATEGORY_REMOTE_REPO_MANAGEMENT,
registrar.command.CATEGORY_COMMITTING,
registrar.command.CATEGORY_CHANGE_MANAGEMENT,
registrar.command.CATEGORY_CHANGE_ORGANIZATION,
registrar.command.CATEGORY_FILE_CONTENTS,
registrar.command.CATEGORY_CHANGE_NAVIGATION ,
registrar.command.CATEGORY_WORKING_DIRECTORY,
registrar.command.CATEGORY_IMPORT_EXPORT,
registrar.command.CATEGORY_MAINTENANCE,
registrar.command.CATEGORY_HELP,
registrar.command.CATEGORY_MISC,
registrar.command.CATEGORY_NONE, registrar.command.CATEGORY_NONE,
] ]
# Human-readable category names. These are translated. # Human-readable category names. These are translated.
# Extensions with custom categories should add their names here. # Extensions with custom categories should add their names here.
CATEGORY_NAMES = { CATEGORY_NAMES = {
registrar.command.CATEGORY_REPO_CREATION: 'Repository creation',
registrar.command.CATEGORY_REMOTE_REPO_MANAGEMENT:
'Remote repository management',
registrar.command.CATEGORY_COMMITTING: 'Change creation',
registrar.command.CATEGORY_CHANGE_NAVIGATION: 'Change navigation',
registrar.command.CATEGORY_CHANGE_MANAGEMENT: 'Change manipulation',
registrar.command.CATEGORY_CHANGE_ORGANIZATION: 'Change organization',
registrar.command.CATEGORY_WORKING_DIRECTORY:
'Working directory management',
registrar.command.CATEGORY_FILE_CONTENTS: 'File content management',
registrar.command.CATEGORY_IMPORT_EXPORT: 'Change import/export',
registrar.command.CATEGORY_MAINTENANCE: 'Repository maintenance',
registrar.command.CATEGORY_HELP: 'Help',
registrar.command.CATEGORY_MISC: 'Miscellaneous commands',
registrar.command.CATEGORY_NONE: 'Uncategorized commands', registrar.command.CATEGORY_NONE: 'Uncategorized commands',
} }
# Topic categories. # Topic categories.
TOPIC_CATEGORY_NONE = 'none' TOPIC_CATEGORY_NONE = 'none'
# The order in which topic categories will be displayed. # The order in which topic categories will be displayed.
# Extensions with custom categories should insert them into this list # Extensions with custom categories should insert them into this list

mercurial/registrar.py

`<options>` are keyword arguments (or `**options`) of option arguments `<options>` are keyword arguments (or `**options`) of option arguments
from the command line. from the command line.
See the WritingExtensions and MercurialApi documentation for more exhaustive See the WritingExtensions and MercurialApi documentation for more exhaustive
descriptions and examples. descriptions and examples.
""" """
# Command categories for grouping them in help output. # Command categories for grouping them in help output.
CATEGORY_REPO_CREATION = 'repo'
CATEGORY_REMOTE_REPO_MANAGEMENT = 'remote'
CATEGORY_COMMITTING = 'commit'
CATEGORY_CHANGE_MANAGEMENT = 'management'
CATEGORY_CHANGE_ORGANIZATION = 'organization'
CATEGORY_FILE_CONTENTS = 'files'
CATEGORY_CHANGE_NAVIGATION = 'navigation'
CATEGORY_WORKING_DIRECTORY = 'wdir'
CATEGORY_IMPORT_EXPORT = 'import'
CATEGORY_MAINTENANCE = 'maintenance'
CATEGORY_HELP = 'help'
CATEGORY_MISC = 'misc'
CATEGORY_NONE = 'none' CATEGORY_NONE = 'none'
def _doregister(self, func, name, options=(), synopsis=None, def _doregister(self, func, name, options=(), synopsis=None,
norepo=False, optionalrepo=False, inferrepo=False, norepo=False, optionalrepo=False, inferrepo=False,
intents=None, helpcategory=None): intents=None, helpcategory=None):
func.norepo = norepo func.norepo = norepo
func.optionalrepo = optionalrepo func.optionalrepo = optionalrepo
func.inferrepo = inferrepo func.inferrepo = inferrepo

tests/test-globalopts.t

#if no-extraextensions #if no-extraextensions
$ hg -h $ hg -h
Mercurial Distributed SCM Mercurial Distributed SCM
list of commands: list of commands:
add add the specified files on the next commit Repository creation:
addremove add all new files, delete all missing files
annotate show changeset information by line for each file clone make a copy of an existing repository
archive create an unversioned archive of a repository revision init create a new repository in the given directory
Remote repository management:
incoming show new changesets found in source
outgoing show changesets not found in the destination
paths show aliases for remote repositories
pull pull changes from the specified source
push push changes to the specified destination
serve start stand-alone webserver
Change creation:
commit commit the specified files or all outstanding changes
Change manipulation:
backout reverse effect of earlier changeset backout reverse effect of earlier changeset
bisect subdivision search of changesets graft copy changes from other branches onto the current branch
merge merge another revision into working directory
Change organization:
bookmarks create a new bookmark or list existing bookmarks bookmarks create a new bookmark or list existing bookmarks
branch set or show the current branch name branch set or show the current branch name
branches list repository named branches branches list repository named branches
bundle create a bundle file phase set or show the current phase name
tag add one or more tags for the current or given revision
tags list repository tags
File content management:
annotate show changeset information by line for each file
cat output the current or given revision of files cat output the current or given revision of files
clone make a copy of an existing repository
commit commit the specified files or all outstanding changes
config show combined config settings from all hgrc files
copy mark files as copied for the next commit copy mark files as copied for the next commit
diff diff repository (or selected files) diff diff repository (or selected files)
export dump the header and diffs for one or more changesets
files list tracked files
forget forget the specified files on the next commit
graft copy changes from other branches onto the current branch
grep search revision history for a pattern in specified files grep search revision history for a pattern in specified files
Change navigation:
bisect subdivision search of changesets
heads show branch heads heads show branch heads
help show help for a given topic or a help overview
identify identify the working directory or specified revision identify identify the working directory or specified revision
import import an ordered set of patches
incoming show new changesets found in source
init create a new repository in the given directory
log show revision history of entire repository or files log show revision history of entire repository or files
manifest output the current or given revision of the project manifest
merge merge another revision into working directory Working directory management:
outgoing show changesets not found in the destination
paths show aliases for remote repositories add add the specified files on the next commit
phase set or show the current phase name addremove add all new files, delete all missing files
pull pull changes from the specified source files list tracked files
push push changes to the specified destination forget forget the specified files on the next commit
recover roll back an interrupted transaction
remove remove the specified files on the next commit remove remove the specified files on the next commit
rename rename files; equivalent of copy + remove rename rename files; equivalent of copy + remove
resolve redo merges or set/view the merge status of files resolve redo merges or set/view the merge status of files
revert restore files to their checkout state revert restore files to their checkout state
root print the root (top) of the current working directory root print the root (top) of the current working directory
serve start stand-alone webserver
status show changed files in the working directory status show changed files in the working directory
summary summarize working directory state summary summarize working directory state
tag add one or more tags for the current or given revision
tags list repository tags
unbundle apply one or more bundle files
update update working directory (or switch revisions) update update working directory (or switch revisions)
Change import/export:
archive create an unversioned archive of a repository revision
bundle create a bundle file
export dump the header and diffs for one or more changesets
import import an ordered set of patches
unbundle apply one or more bundle files
Repository maintenance:
manifest output the current or given revision of the project manifest
recover roll back an interrupted transaction
verify verify the integrity of the repository verify verify the integrity of the repository
Help:
config show combined config settings from all hgrc files
help show help for a given topic or a help overview
version output version and copyright information version output version and copyright information
additional help topics: additional help topics:
bundlespec Bundle File Formats bundlespec Bundle File Formats
color Colorizing Outputs color Colorizing Outputs
config Configuration Files config Configuration Files
dates Date Formats dates Date Formats
(use 'hg help -v' to show built-in aliases and global options) (use 'hg help -v' to show built-in aliases and global options)
$ hg --help $ hg --help
Mercurial Distributed SCM Mercurial Distributed SCM
list of commands: list of commands:
add add the specified files on the next commit Repository creation:
addremove add all new files, delete all missing files
annotate show changeset information by line for each file clone make a copy of an existing repository
archive create an unversioned archive of a repository revision init create a new repository in the given directory
Remote repository management:
incoming show new changesets found in source
outgoing show changesets not found in the destination
paths show aliases for remote repositories
pull pull changes from the specified source
push push changes to the specified destination
serve start stand-alone webserver
Change creation:
commit commit the specified files or all outstanding changes
Change manipulation:
backout reverse effect of earlier changeset backout reverse effect of earlier changeset
bisect subdivision search of changesets graft copy changes from other branches onto the current branch
merge merge another revision into working directory
Change organization:
bookmarks create a new bookmark or list existing bookmarks bookmarks create a new bookmark or list existing bookmarks
branch set or show the current branch name branch set or show the current branch name
branches list repository named branches branches list repository named branches
bundle create a bundle file phase set or show the current phase name
tag add one or more tags for the current or given revision
tags list repository tags
File content management:
annotate show changeset information by line for each file
cat output the current or given revision of files cat output the current or given revision of files
clone make a copy of an existing repository
commit commit the specified files or all outstanding changes
config show combined config settings from all hgrc files
copy mark files as copied for the next commit copy mark files as copied for the next commit
diff diff repository (or selected files) diff diff repository (or selected files)
export dump the header and diffs for one or more changesets
files list tracked files
forget forget the specified files on the next commit
graft copy changes from other branches onto the current branch
grep search revision history for a pattern in specified files grep search revision history for a pattern in specified files
Change navigation:
bisect subdivision search of changesets
heads show branch heads heads show branch heads
help show help for a given topic or a help overview
identify identify the working directory or specified revision identify identify the working directory or specified revision
import import an ordered set of patches
incoming show new changesets found in source
init create a new repository in the given directory
log show revision history of entire repository or files log show revision history of entire repository or files
manifest output the current or given revision of the project manifest
merge merge another revision into working directory Working directory management:
outgoing show changesets not found in the destination
paths show aliases for remote repositories add add the specified files on the next commit
phase set or show the current phase name addremove add all new files, delete all missing files
pull pull changes from the specified source files list tracked files
push push changes to the specified destination forget forget the specified files on the next commit
recover roll back an interrupted transaction
remove remove the specified files on the next commit remove remove the specified files on the next commit
rename rename files; equivalent of copy + remove rename rename files; equivalent of copy + remove
resolve redo merges or set/view the merge status of files resolve redo merges or set/view the merge status of files
revert restore files to their checkout state revert restore files to their checkout state
root print the root (top) of the current working directory root print the root (top) of the current working directory
serve start stand-alone webserver
status show changed files in the working directory status show changed files in the working directory
summary summarize working directory state summary summarize working directory state
tag add one or more tags for the current or given revision
tags list repository tags
unbundle apply one or more bundle files
update update working directory (or switch revisions) update update working directory (or switch revisions)
Change import/export:
archive create an unversioned archive of a repository revision
bundle create a bundle file
export dump the header and diffs for one or more changesets
import import an ordered set of patches
unbundle apply one or more bundle files
Repository maintenance:
manifest output the current or given revision of the project manifest
recover roll back an interrupted transaction
verify verify the integrity of the repository verify verify the integrity of the repository
Help:
config show combined config settings from all hgrc files
help show help for a given topic or a help overview
version output version and copyright information version output version and copyright information
additional help topics: additional help topics:
bundlespec Bundle File Formats bundlespec Bundle File Formats
color Colorizing Outputs color Colorizing Outputs
config Configuration Files config Configuration Files
dates Date Formats dates Date Formats

tests/test-help.t

the extension is unknown. the extension is unknown.
#if no-extraextensions #if no-extraextensions
$ hg help $ hg help
Mercurial Distributed SCM Mercurial Distributed SCM
list of commands: list of commands:
add add the specified files on the next commit Repository creation:
addremove add all new files, delete all missing files
annotate show changeset information by line for each file clone make a copy of an existing repository
archive create an unversioned archive of a repository revision init create a new repository in the given directory
Remote repository management:
incoming show new changesets found in source
outgoing show changesets not found in the destination
paths show aliases for remote repositories
pull pull changes from the specified source
push push changes to the specified destination
serve start stand-alone webserver
Change creation:
commit commit the specified files or all outstanding changes
Change manipulation:
backout reverse effect of earlier changeset backout reverse effect of earlier changeset
bisect subdivision search of changesets graft copy changes from other branches onto the current branch
merge merge another revision into working directory
Change organization:
bookmarks create a new bookmark or list existing bookmarks bookmarks create a new bookmark or list existing bookmarks
branch set or show the current branch name branch set or show the current branch name
branches list repository named branches branches list repository named branches
bundle create a bundle file phase set or show the current phase name
tag add one or more tags for the current or given revision
tags list repository tags
File content management:
annotate show changeset information by line for each file
cat output the current or given revision of files cat output the current or given revision of files
clone make a copy of an existing repository
commit commit the specified files or all outstanding changes
config show combined config settings from all hgrc files
copy mark files as copied for the next commit copy mark files as copied for the next commit
diff diff repository (or selected files) diff diff repository (or selected files)
export dump the header and diffs for one or more changesets
files list tracked files
forget forget the specified files on the next commit
graft copy changes from other branches onto the current branch
grep search revision history for a pattern in specified files grep search revision history for a pattern in specified files
Change navigation:
bisect subdivision search of changesets
heads show branch heads heads show branch heads
help show help for a given topic or a help overview
identify identify the working directory or specified revision identify identify the working directory or specified revision
import import an ordered set of patches
incoming show new changesets found in source
init create a new repository in the given directory
log show revision history of entire repository or files log show revision history of entire repository or files
manifest output the current or given revision of the project manifest
merge merge another revision into working directory Working directory management:
outgoing show changesets not found in the destination
paths show aliases for remote repositories add add the specified files on the next commit
phase set or show the current phase name addremove add all new files, delete all missing files
pull pull changes from the specified source files list tracked files
push push changes to the specified destination forget forget the specified files on the next commit
recover roll back an interrupted transaction
remove remove the specified files on the next commit remove remove the specified files on the next commit
rename rename files; equivalent of copy + remove rename rename files; equivalent of copy + remove
resolve redo merges or set/view the merge status of files resolve redo merges or set/view the merge status of files
revert restore files to their checkout state revert restore files to their checkout state
root print the root (top) of the current working directory root print the root (top) of the current working directory
serve start stand-alone webserver
status show changed files in the working directory status show changed files in the working directory
summary summarize working directory state summary summarize working directory state
tag add one or more tags for the current or given revision
tags list repository tags
unbundle apply one or more bundle files
update update working directory (or switch revisions) update update working directory (or switch revisions)
Change import/export:
archive create an unversioned archive of a repository revision
bundle create a bundle file
export dump the header and diffs for one or more changesets
import import an ordered set of patches
unbundle apply one or more bundle files
Repository maintenance:
manifest output the current or given revision of the project manifest
recover roll back an interrupted transaction
verify verify the integrity of the repository verify verify the integrity of the repository
Help:
config show combined config settings from all hgrc files
help show help for a given topic or a help overview
version output version and copyright information version output version and copyright information
additional help topics: additional help topics:
bundlespec Bundle File Formats bundlespec Bundle File Formats
color Colorizing Outputs color Colorizing Outputs
config Configuration Files config Configuration Files
dates Date Formats dates Date Formats
scripting Using Mercurial from scripts and automation scripting Using Mercurial from scripts and automation
subrepos Subrepositories subrepos Subrepositories
templating Template Usage templating Template Usage
urls URL Paths urls URL Paths
(use 'hg help -v' to show built-in aliases and global options) (use 'hg help -v' to show built-in aliases and global options)
$ hg -q help $ hg -q help
add add the specified files on the next commit Repository creation:
addremove add all new files, delete all missing files
annotate show changeset information by line for each file clone make a copy of an existing repository
archive create an unversioned archive of a repository revision init create a new repository in the given directory
Remote repository management:
incoming show new changesets found in source
outgoing show changesets not found in the destination
paths show aliases for remote repositories
pull pull changes from the specified source
push push changes to the specified destination
serve start stand-alone webserver
Change creation:
commit commit the specified files or all outstanding changes
Change manipulation:
backout reverse effect of earlier changeset backout reverse effect of earlier changeset
bisect subdivision search of changesets graft copy changes from other branches onto the current branch
merge merge another revision into working directory
Change organization:
bookmarks create a new bookmark or list existing bookmarks bookmarks create a new bookmark or list existing bookmarks
branch set or show the current branch name branch set or show the current branch name
branches list repository named branches branches list repository named branches
bundle create a bundle file phase set or show the current phase name
tag add one or more tags for the current or given revision
tags list repository tags
File content management:
annotate show changeset information by line for each file
cat output the current or given revision of files cat output the current or given revision of files
clone make a copy of an existing repository
commit commit the specified files or all outstanding changes
config show combined config settings from all hgrc files
copy mark files as copied for the next commit copy mark files as copied for the next commit
diff diff repository (or selected files) diff diff repository (or selected files)
export dump the header and diffs for one or more changesets
files list tracked files
forget forget the specified files on the next commit
graft copy changes from other branches onto the current branch
grep search revision history for a pattern in specified files grep search revision history for a pattern in specified files
Change navigation:
bisect subdivision search of changesets
heads show branch heads heads show branch heads
help show help for a given topic or a help overview
identify identify the working directory or specified revision identify identify the working directory or specified revision
import import an ordered set of patches
incoming show new changesets found in source
init create a new repository in the given directory
log show revision history of entire repository or files log show revision history of entire repository or files
manifest output the current or given revision of the project manifest
merge merge another revision into working directory Working directory management:
outgoing show changesets not found in the destination
paths show aliases for remote repositories add add the specified files on the next commit
phase set or show the current phase name addremove add all new files, delete all missing files
pull pull changes from the specified source files list tracked files
push push changes to the specified destination forget forget the specified files on the next commit
recover roll back an interrupted transaction
remove remove the specified files on the next commit remove remove the specified files on the next commit
rename rename files; equivalent of copy + remove rename rename files; equivalent of copy + remove
resolve redo merges or set/view the merge status of files resolve redo merges or set/view the merge status of files
revert restore files to their checkout state revert restore files to their checkout state
root print the root (top) of the current working directory root print the root (top) of the current working directory
serve start stand-alone webserver
status show changed files in the working directory status show changed files in the working directory
summary summarize working directory state summary summarize working directory state
tag add one or more tags for the current or given revision
tags list repository tags
unbundle apply one or more bundle files
update update working directory (or switch revisions) update update working directory (or switch revisions)
Change import/export:
archive create an unversioned archive of a repository revision
bundle create a bundle file
export dump the header and diffs for one or more changesets
import import an ordered set of patches
unbundle apply one or more bundle files
Repository maintenance:
manifest output the current or given revision of the project manifest
recover roll back an interrupted transaction
verify verify the integrity of the repository verify verify the integrity of the repository
Help:
config show combined config settings from all hgrc files
help show help for a given topic or a help overview
version output version and copyright information version output version and copyright information
additional help topics: additional help topics:
bundlespec Bundle File Formats bundlespec Bundle File Formats
color Colorizing Outputs color Colorizing Outputs
config Configuration Files config Configuration Files
dates Date Formats dates Date Formats
#if no-extraextensions #if no-extraextensions
$ hg help $ hg help
Mercurial Distributed SCM Mercurial Distributed SCM
list of commands: list of commands:
add add the specified files on the next commit Repository creation:
addremove add all new files, delete all missing files
annotate show changeset information by line for each file clone make a copy of an existing repository
archive create an unversioned archive of a repository revision init create a new repository in the given directory
Remote repository management:
incoming show new changesets found in source
outgoing show changesets not found in the destination
paths show aliases for remote repositories
pull pull changes from the specified source
push push changes to the specified destination
serve start stand-alone webserver
Change creation:
commit commit the specified files or all outstanding changes
Change manipulation:
backout reverse effect of earlier changeset backout reverse effect of earlier changeset
bisect subdivision search of changesets graft copy changes from other branches onto the current branch
merge merge another revision into working directory
Change organization:
bookmarks create a new bookmark or list existing bookmarks bookmarks create a new bookmark or list existing bookmarks
branch set or show the current branch name branch set or show the current branch name
branches list repository named branches branches list repository named branches
bundle create a bundle file phase set or show the current phase name
tag add one or more tags for the current or given revision
tags list repository tags
File content management:
annotate show changeset information by line for each file
cat output the current or given revision of files cat output the current or given revision of files
clone make a copy of an existing repository
commit commit the specified files or all outstanding changes
config show combined config settings from all hgrc files
copy mark files as copied for the next commit copy mark files as copied for the next commit
diff diff repository (or selected files) diff diff repository (or selected files)
export dump the header and diffs for one or more changesets
files list tracked files
forget forget the specified files on the next commit
graft copy changes from other branches onto the current branch
grep search revision history for a pattern in specified files grep search revision history for a pattern in specified files
Change navigation:
bisect subdivision search of changesets
heads show branch heads heads show branch heads
help show help for a given topic or a help overview
identify identify the working directory or specified revision identify identify the working directory or specified revision
import import an ordered set of patches
incoming show new changesets found in source
init create a new repository in the given directory
log show revision history of entire repository or files log show revision history of entire repository or files
manifest output the current or given revision of the project manifest
merge merge another revision into working directory Working directory management:
outgoing show changesets not found in the destination
paths show aliases for remote repositories add add the specified files on the next commit
phase set or show the current phase name addremove add all new files, delete all missing files
pull pull changes from the specified source files list tracked files
push push changes to the specified destination forget forget the specified files on the next commit
recover roll back an interrupted transaction
remove remove the specified files on the next commit remove remove the specified files on the next commit
rename rename files; equivalent of copy + remove rename rename files; equivalent of copy + remove
resolve redo merges or set/view the merge status of files resolve redo merges or set/view the merge status of files
revert restore files to their checkout state revert restore files to their checkout state
root print the root (top) of the current working directory root print the root (top) of the current working directory
serve start stand-alone webserver
status show changed files in the working directory status show changed files in the working directory
summary summarize working directory state summary summarize working directory state
tag add one or more tags for the current or given revision
tags list repository tags
unbundle apply one or more bundle files
update update working directory (or switch revisions) update update working directory (or switch revisions)
Change import/export:
archive create an unversioned archive of a repository revision
bundle create a bundle file
export dump the header and diffs for one or more changesets
import import an ordered set of patches
unbundle apply one or more bundle files
Repository maintenance:
manifest output the current or given revision of the project manifest
recover roll back an interrupted transaction
verify verify the integrity of the repository verify verify the integrity of the repository
Help:
config show combined config settings from all hgrc files
help show help for a given topic or a help overview
version output version and copyright information version output version and copyright information
enabled extensions: enabled extensions:
helpext (no help text available) helpext (no help text available)
additional help topics: additional help topics:

tests/test-mq.t

changes will be tolerated and preserved. If incompatible options such as changes will be tolerated and preserved. If incompatible options such as
-f/--force or --exact are passed, this setting is ignored. -f/--force or --exact are passed, this setting is ignored.
This extension used to provide a strip command. This command now lives in the This extension used to provide a strip command. This command now lives in the
strip extension. strip extension.
list of commands: list of commands:
qapplied print the patches already applied Repository creation:
qclone clone main and patch repository at same time qclone clone main and patch repository at same time
Change creation:
qnew create a new patch
qrefresh update the current patch
Change manipulation:
qfold fold the named patches into the current patch
Change organization:
qapplied print the patches already applied
qdelete remove patches from queue qdelete remove patches from queue
qdiff diff of the current patch and subsequent modifications
qfinish move applied patches into repository history qfinish move applied patches into repository history
qfold fold the named patches into the current patch
qgoto push or pop patches until named patch is at top of stack qgoto push or pop patches until named patch is at top of stack
qguard set or print guards for a patch qguard set or print guards for a patch
qheader print the header of the topmost or specified patch qheader print the header of the topmost or specified patch
qimport import a patch or existing changeset
qnew create a new patch
qnext print the name of the next pushable patch qnext print the name of the next pushable patch
qpop pop the current patch off the stack qpop pop the current patch off the stack
qprev print the name of the preceding applied patch qprev print the name of the preceding applied patch
qpush push the next patch onto the stack qpush push the next patch onto the stack
qqueue manage multiple patch queues qqueue manage multiple patch queues
qrefresh update the current patch
qrename rename a patch qrename rename a patch
qselect set or print guarded patches to push qselect set or print guarded patches to push
qseries print the entire series file qseries print the entire series file
qtop print the name of the current patch qtop print the name of the current patch
qunapplied print the patches not yet applied qunapplied print the patches not yet applied
File content management:
qdiff diff of the current patch and subsequent modifications
Change import/export:
qimport import a patch or existing changeset
(use 'hg help -v mq' to show built-in aliases and global options) (use 'hg help -v mq' to show built-in aliases and global options)
$ hg init a $ hg init a
$ cd a $ cd a
$ echo a > a $ echo a > a
$ hg ci -Ama $ hg ci -Ama
adding a adding a