mercurial: comparison mercurial/commands.py

equal deleted inserted replaced

-:9c6473d2038b
+:c303d65d2e34
 # Commands start here, listed alphabetically
 @command('^add',
 walkopts + subrepoopts + dryrunopts,
 _('[OPTION]... [FILE]...'),
+helpcategory=command.CATEGORY_WORKING_DIRECTORY,
 inferrepo=True)
 def add(ui, repo, *pats, **opts):
 """add the specified files on the next commit
 Schedule files to be version controlled and added to the
 return rejected and 1 or 0
 @command('addremove',
 similarityopts + subrepoopts + walkopts + dryrunopts,
 _('[OPTION]... [FILE]...'),
+helpcategory=command.CATEGORY_WORKING_DIRECTORY,
 inferrepo=True)
 def addremove(ui, repo, *pats, **opts):
 """add all new files, delete all missing files
 Add all new files and remove all missing files from the
 ('c', 'changeset', None, _('list the changeset')),
 ('l', 'line-number', None, _('show line number at the first appearance')),
 ('', 'skip', [], _('revision to not display (EXPERIMENTAL)'), _('REV')),
 ] + diffwsopts + walkopts + formatteropts,
 _('[-r REV] [-f] [-a] [-u] [-d] [-n] [-c] [-l] FILE...'),
+helpcategory=command.CATEGORY_FILE_CONTENTS,
 inferrepo=True)
 def annotate(ui, repo, *pats, **opts):
 """show changeset information by line for each file
 List changes in files, showing the revision id responsible for
 ('p', 'prefix', '', _('directory prefix for files in archive'),
 _('PREFIX')),
 ('r', 'rev', '', _('revision to distribute'), _('REV')),
 ('t', 'type', '', _('type of distribution to create'), _('TYPE')),
 ] + subrepoopts + walkopts,
-_('[OPTION]... DEST'))
+_('[OPTION]... DEST'),
+helpcategory=command.CATEGORY_IMPORT_EXPORT)
 def archive(ui, repo, dest, **opts):
 '''create an unversioned archive of a repository revision
 By default, the revision used is the parent of the working
 directory; use -r/--rev to specify a different revision.
 ('', 'parent', '',
 _('parent to choose when backing out merge (DEPRECATED)'), _('REV')),
 ('r', 'rev', '', _('revision to backout'), _('REV')),
 ('e', 'edit', False, _('invoke editor on commit messages')),
 ] + mergetoolopts + walkopts + commitopts + commitopts2,
-_('[OPTION]... [-r] REV'))
+_('[OPTION]... [-r] REV'),
+helpcategory=command.CATEGORY_CHANGE_MANAGEMENT)
 def backout(ui, repo, node=None, rev=None, **opts):
 '''reverse effect of earlier changeset
 Prepare a new changeset with the effect of REV undone in the
 current working directory. If no conflicts were encountered,
 ('b', 'bad', False, _('mark changeset bad')),
 ('s', 'skip', False, _('skip testing changeset')),
 ('e', 'extend', False, _('extend the bisect range')),
 ('c', 'command', '', _('use command to check changeset state'), _('CMD')),
 ('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,
 reset=None, good=None, bad=None, skip=None, extend=None,
 noupdate=None):
 """subdivision search of changesets
 ('d', 'delete', False, _('delete a given bookmark')),
 ('m', 'rename', '', _('rename a given bookmark'), _('OLD')),
 ('i', 'inactive', False, _('mark a bookmark inactive')),
 ('l', 'list', False, _('list existing bookmarks')),
 ] + formatteropts,
-_('hg bookmarks [OPTIONS]... [NAME]...'))
+_('hg bookmarks [OPTIONS]... [NAME]...'),
+helpcategory=command.CATEGORY_CHANGE_ORGANIZATION)
 def bookmark(ui, repo, *names, **opts):
 '''create a new bookmark or list existing bookmarks
 Bookmarks are labels on changesets to help track lines of development.
 Bookmarks are unversioned and can be moved, renamed and deleted.
 [('f', 'force', None,
 _('set branch name even if it shadows an existing branch')),
 ('C', 'clean', None, _('reset branch name to parent branch name')),
 ('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):
 """set or show the current branch name
 .. note::
 [('a', 'active', False,
 _('show only branches that have unmerged heads (DEPRECATED)')),
 ('c', 'closed', False, _('show normal and closed branches')),
 ] + formatteropts,
 _('[-c]'),
+helpcategory=command.CATEGORY_CHANGE_ORGANIZATION,
 intents={INTENT_READONLY})
 def branches(ui, repo, active=False, closed=False, **opts):
 """list repository named branches
 List the repository's named branches, indicating which ones are
 _('a base changeset assumed to be available at the destination'),
 _('REV')),
 ('a', 'all', None, _('bundle all changesets in the repository')),
 ('t', 'type', 'bzip2', _('bundle compression type to use'), _('TYPE')),
 ] + 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):
 """create a bundle file
 Generate a bundle file containing data to be transferred to another
 repository.
 _('print output to file with formatted name'), _('FORMAT')),
 ('r', 'rev', '', _('print the given revision'), _('REV')),
 ('', 'decode', None, _('apply any matching decode filter')),
 ] + walkopts + formatteropts,
 _('[OPTION]... FILE...'),
+helpcategory=command.CATEGORY_FILE_CONTENTS,
 inferrepo=True,
 intents={INTENT_READONLY})
 def cat(ui, repo, file1, *pats, **opts):
 """output the current or given revision of files
 _('an alias to --stream (DEPRECATED)')),
 ('', 'stream', None,
 _('clone with minimal data processing')),
 ] + remoteopts,
 _('[OPTION]... SOURCE [DEST]'),
+helpcategory=command.CATEGORY_REPO_CREATION,
 norepo=True)
 def clone(ui, source, dest=None, **opts):
 """make a copy of an existing repository
 Create a copy of an existing repository in a new directory.
 ('s', 'secret', None, _('use the secret phase for committing')),
 ('e', 'edit', None, _('invoke editor on commit messages')),
 ('i', 'interactive', None, _('use interactive mode')),
 ] + walkopts + commitopts + commitopts2 + subrepoopts,
 _('[OPTION]... [FILE]...'),
+helpcategory=command.CATEGORY_COMMITTING,
 inferrepo=True)
 def commit(ui, repo, *pats, **opts):
 """commit the specified files or all outstanding changes
 Commit changes to the given files into the repository. Unlike a
 [('u', 'untrusted', None, _('show untrusted configuration options')),
 ('e', 'edit', None, _('edit user config')),
 ('l', 'local', None, _('edit repository config')),
 ('g', 'global', None, _('edit global config'))] + formatteropts,
 _('[-u] [NAME]...'),
+helpcategory=command.CATEGORY_HELP,
 optionalrepo=True,
 intents={INTENT_READONLY})
 def config(ui, repo, *values, **opts):
 """show combined config settings from all hgrc files
 @command('copy|cp',
 [('A', 'after', None, _('record a copy that has already occurred')),
 ('f', 'force', None, _('forcibly copy over an existing managed file')),
 ] + walkopts + dryrunopts,
-_('[OPTION]... [SOURCE]... DEST'))
+_('[OPTION]... [SOURCE]... DEST'),
+helpcategory=command.CATEGORY_FILE_CONTENTS)
 def copy(ui, repo, *pats, **opts):
 """mark files as copied for the next commit
 Mark dest as having copies of source files. If dest is a
 directory, copies are put in that directory. If dest is a file,
 """
 opts = pycompat.byteskwargs(opts)
 with repo.wlock(False):
 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):
 """list all available commands and options"""
 for cmd, vals in sorted(table.iteritems()):
 cmd = cmd.split('|')[0].strip('^')
 opts = ', '.join([i[1] for i in vals[1]])
 ui.write('%s: %s\n' % (cmd, opts))
 @command('debugcomplete',
 [('o', 'options', None, _('show the command options'))],
 _('[-o] CMD'),
+helpcategory=command.CATEGORY_HELP,
 norepo=True)
 def debugcomplete(ui, cmd='', **opts):
 """returns the completion list associated with the given command"""
 if opts.get(r'options'):
 @command('^diff',
 [('r', 'rev', [], _('revision'), _('REV')),
 ('c', 'change', '', _('change made by revision'), _('REV'))
 ] + diffopts + diffopts2 + walkopts + subrepoopts,
 _('[OPTION]... ([-c REV] | [-r REV1 [-r REV2]]) [FILE]...'),
+helpcategory=command.CATEGORY_FILE_CONTENTS,
 inferrepo=True,
 intents={INTENT_READONLY})
 def diff(ui, repo, *pats, **opts):
 """diff repository (or selected files)
 _('print output to file with formatted name'), _('FORMAT')),
 ('', 'switch-parent', None, _('diff against the second parent')),
 ('r', 'rev', [], _('revisions to export'), _('REV')),
 ] + diffopts + formatteropts,
 _('[OPTION]... [-o OUTFILESPEC] [-r] [REV]...'),
+helpcategory=command.CATEGORY_IMPORT_EXPORT,
 intents={INTENT_READONLY})
 def export(ui, repo, *changesets, **opts):
 """dump the header and diffs for one or more changesets
 Print the changeset header and diffs for one or more revisions.
 @command('files',
 [('r', 'rev', '', _('search the repository as it is in REV'), _('REV')),
 ('0', 'print0', None, _('end filenames with NUL, for use with xargs')),
 ] + walkopts + formatteropts + subrepoopts,
 _('[OPTION]... [FILE]...'),
+helpcategory=command.CATEGORY_WORKING_DIRECTORY,
 intents={INTENT_READONLY})
 def files(ui, repo, *pats, **opts):
 """list tracked files
 Print files under Mercurial control in the working directory or
 @command(
 '^forget',
 [('i', 'interactive', None, _('use interactive mode')),
 ] + walkopts + dryrunopts,
-_('[OPTION]... FILE...'), inferrepo=True)
+_('[OPTION]... FILE...'),
+helpcategory=command.CATEGORY_WORKING_DIRECTORY,
+inferrepo=True)
 def forget(ui, repo, *pats, **opts):
 """forget the specified files on the next commit
 Mark the specified files so they will no longer be tracked
 after the next commit.
 ('D', 'currentdate', False,
 _('record the current date as commit date')),
 ('U', 'currentuser', False,
 _('record the current user as committer'), _('DATE'))]
 + commitopts2 + mergetoolopts  + dryrunopts,
-_('[OPTION]... [-r REV]... REV...'))
+_('[OPTION]... [-r REV]... REV...'),
+helpcategory=command.CATEGORY_CHANGE_MANAGEMENT)
 def graft(ui, repo, *revs, **opts):
 '''copy changes from other branches onto the current branch
 This command uses Mercurial's merge logic to copy individual
 changes from other branches without merging branches in the
 _('include all files in the changeset while grepping (EXPERIMENTAL)')),
 ('u', 'user', None, _('list the author (long with -v)')),
 ('d', 'date', None, _('list the date (short with -q)')),
 ] + formatteropts + walkopts,
 _('[OPTION]... PATTERN [FILE]...'),
+helpcategory=command.CATEGORY_FILE_CONTENTS,
 inferrepo=True,
 intents={INTENT_READONLY})
 def grep(ui, repo, pattern, *pats, **opts):
 """search revision history for a pattern in specified files
 ('t', 'topo', False, _('show topological heads only')),
 ('a', 'active', False, _('show active branchheads only (DEPRECATED)')),
 ('c', 'closed', False, _('show normal and closed branch heads')),
 ] + templateopts,
 _('[-ct] [-r STARTREV] [REV]...'),
+helpcategory=command.CATEGORY_CHANGE_NAVIGATION,
 intents={INTENT_READONLY})
 def heads(ui, repo, *branchrevs, **opts):
 """show branch heads
 With no arguments, show all open branch heads in the repository.
 ('c', 'command', None, _('show only help for commands')),
 ('k', 'keyword', None, _('show topics matching keyword')),
 ('s', 'system', [], _('show help for specific platform(s)')),
 ],
 _('[-ecks] [TOPIC]'),
+helpcategory=command.CATEGORY_HELP,
 norepo=True,
 intents={INTENT_READONLY})
 def help_(ui, name=None, **opts):
 """show help for a given topic or a help overview
 ('b', 'branch', None, _('show branch')),
 ('t', 'tags', None, _('show tags')),
 ('B', 'bookmarks', None, _('show bookmarks')),
 ] + remoteopts + formatteropts,
 _('[-nibtB] [-r REV] [SOURCE]'),
+helpcategory=command.CATEGORY_CHANGE_NAVIGATION,
 optionalrepo=True,
 intents={INTENT_READONLY})
 def identify(ui, repo, source=None, rev=None,
 num=None, id=None, branch=None, tags=None, bookmarks=None, **opts):
 """identify the working directory or specified revision
 ('', 'prefix', '',
 _('apply patch to subdirectory'), _('DIR')),
 ('', 'import-branch', None,
 _('use any branch information in patch (implied by --exact)'))] +
 commitopts + commitopts2 + similarityopts,
-_('[OPTION]... PATCH...'))
+_('[OPTION]... PATCH...'),
+helpcategory=command.CATEGORY_IMPORT_EXPORT)
 def import_(ui, repo, patch1=None, *patches, **opts):
 """import an ordered set of patches
 Import a list of patches and commit them individually (unless
 --no-commit is specified).
 ('r', 'rev', [], _('a remote changeset intended to be added'), _('REV')),
 ('B', 'bookmarks', False, _("compare bookmarks")),
 ('b', 'branch', [],
 _('a specific branch you would like to pull'), _('BRANCH')),
 ] + 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):
 """show new changesets found in source
 Show new changesets found in the specified path/URL or the default
 pull location. These are the changesets that would have been pulled
 finally:
 del repo._subtoppath
 @command('^init', remoteopts, _('[-e CMD] [--remotecmd CMD] [DEST]'),
+helpcategory=command.CATEGORY_REPO_CREATION,
 norepo=True)
 def init(ui, dest=".", **opts):
 """create a new repository in the given directory
 Initialize a new repository in the given directory. If the given
 @command('locate',
 [('r', 'rev', '', _('search the repository as it is in REV'), _('REV')),
 ('0', 'print0', None, _('end filenames with NUL, for use with xargs')),
 ('f', 'fullpath', None, _('print complete paths from the filesystem root')),
 ] + walkopts,
-_('[OPTION]... [PATTERN]...'))
+_('[OPTION]... [PATTERN]...'),
+helpcategory=command.CATEGORY_WORKING_DIRECTORY)
 def locate(ui, repo, *pats, **opts):
 """locate files matching specific patterns (DEPRECATED)
 Print files under Mercurial control in the working directory whose
 names match the given patterns.
 _('show changesets within the given named branch'), _('BRANCH')),
 ('P', 'prune', [],
 _('do not display revision or any of its ancestors'), _('REV')),
 ] + logopts + walkopts,
 _('[OPTION]... [FILE]'),
+helpcategory=command.CATEGORY_CHANGE_NAVIGATION,
 inferrepo=True,
 intents={INTENT_READONLY})
 def log(ui, repo, *pats, **opts):
 """show revision history of entire repository or files
 @command('manifest',
 [('r', 'rev', '', _('revision to display'), _('REV')),
 ('', 'all', False, _("list files from all revisions"))]
 + formatteropts,
 _('[-r REV]'),
+helpcategory=command.CATEGORY_MAINTENANCE,
 intents={INTENT_READONLY})
 def manifest(ui, repo, node=None, rev=None, **opts):
 """output the current or given revision of the project manifest
 Print a list of version controlled files for the given revision.
 ('r', 'rev', '', _('revision to merge'), _('REV')),
 ('P', 'preview', None,
 _('review revisions to merge (no merge is performed)')),
 ('', 'abort', None, _('abort the ongoing merge')),
 ] + mergetoolopts,
-_('[-P] [[-r] REV]'))
+_('[-P] [[-r] REV]'),
+helpcategory=command.CATEGORY_CHANGE_MANAGEMENT)
 def merge(ui, repo, node=None, **opts):
 """merge another revision into working directory
 The current working directory is updated with all changes made in
 the requested revision since the last common predecessor revision.
 ('n', 'newest-first', None, _('show newest record first')),
 ('B', 'bookmarks', False, _('compare bookmarks')),
 ('b', 'branch', [], _('a specific branch you would like to push'),
 _('BRANCH')),
 ] + 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):
 """show changesets not found in the destination
 Show changesets not found in the specified destination repository
 or the default push location. These are the changesets that would
 @command('parents',
 [('r', 'rev', '', _('show parents of the specified revision'), _('REV')),
 ] + templateopts,
 _('[-r REV] [FILE]'),
+helpcategory=command.CATEGORY_CHANGE_NAVIGATION,
 inferrepo=True)
 def parents(ui, repo, file_=None, **opts):
 """show the parents of the working directory or revision (DEPRECATED)
 Print the working directory's parent revisions. If a revision is
 for n in p:
 if n != nullid:
 displayer.show(repo[n])
 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):
 """show aliases for remote repositories
 Show definition of symbolic path name NAME. If no name is given,
 show definition of all available names.
 ('d', 'draft', False, _('set changeset phase to draft')),
 ('s', 'secret', False, _('set changeset phase to secret')),
 ('f', 'force', False, _('allow to move boundary backward')),
 ('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):
 """set or show the current phase name
 With no argument, show the phase name of the current revision(s).
 ('r', 'rev', [], _('a remote changeset intended to be added'), _('REV')),
 ('B', 'bookmark', [], _("bookmark to pull"), _('BOOKMARK')),
 ('b', 'branch', [], _('a specific branch you would like to pull'),
 _('BRANCH')),
 ] + 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):
 """pull changes from the specified source
 Pull changes from a remote repository to a local one.
 ('b', 'branch', [],
 _('a specific branch you would like to push'), _('BRANCH')),
 ('', 'new-branch', False, _('allow pushing a new branch')),
 ('', 'pushvars', [], _('variables that can be sent to server (ADVANCED)')),
 ] + 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):
 """push changes to the specified destination
 Push changesets from the local repository to the specified
 destination.
 elif not result and pushop.bkresult:
 result = 2
 return result
-@command('recover', [])
+@command('recover', [], helpcategory=command.CATEGORY_MAINTENANCE)
 def recover(ui, repo):
 """roll back an interrupted transaction
 Recover from an interrupted commit or pull.
 [('A', 'after', None, _('record delete for missing files')),
 ('f', 'force', None,
 _('forget added files, delete modified files')),
 ] + subrepoopts + walkopts + dryrunopts,
 _('[OPTION]... FILE...'),
+helpcategory=command.CATEGORY_WORKING_DIRECTORY,
 inferrepo=True)
 def remove(ui, repo, *pats, **opts):
 """remove the specified files on the next commit
 Schedule the indicated files for removal from the current branch.
 @command('rename|move|mv',
 [('A', 'after', None, _('record a rename that has already occurred')),
 ('f', 'force', None, _('forcibly copy over an existing managed file')),
 ] + walkopts + dryrunopts,
-_('[OPTION]... SOURCE... DEST'))
+_('[OPTION]... SOURCE... DEST'),
+helpcategory=command.CATEGORY_WORKING_DIRECTORY)
 def rename(ui, repo, *pats, **opts):
 """rename files; equivalent of copy + remove
 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
 ('u', 'unmark', None, _('mark files as unresolved')),
 ('n', 'no-status', None, _('hide status prefix')),
 ('', 're-merge', None, _('re-merge files'))]
 + mergetoolopts + walkopts + formatteropts,
 _('[OPTION]... [FILE]...'),
+helpcategory=command.CATEGORY_WORKING_DIRECTORY,
 inferrepo=True)
 def resolve(ui, repo, *pats, **opts):
 """redo merges or set/view the merge status of files
 Merges with unresolved conflicts are often the result of
 ('d', 'date', '', _('tipmost revision matching date'), _('DATE')),
 ('r', 'rev', '', _('revert to the specified revision'), _('REV')),
 ('C', 'no-backup', None, _('do not save backup copies of files')),
 ('i', 'interactive', None, _('interactively select the changes')),
 ] + walkopts + dryrunopts,
-_('[OPTION]... [-r REV] [NAME]...'))
+_('[OPTION]... [-r REV] [NAME]...'),
+helpcategory=command.CATEGORY_WORKING_DIRECTORY)
 def revert(ui, repo, *pats, **opts):
 """restore files to their checkout state
 .. note::
 raise error.Abort(msg, hint=hint)
 return cmdutil.revert(ui, repo, ctx, (parent, p2), *pats,
 **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):
 """roll back the last transaction (DANGEROUS) (DEPRECATED)
 Please use :hg:`commit --amend` instead of rollback to correct
 mistakes in the last commit.
 raise error.Abort(_('rollback is disabled because it is unsafe'),
 hint=('see `hg help -v rollback` for information'))
 return repo.rollback(dryrun=opts.get(r'dry_run'),
 force=opts.get(r'force'))
-@command('root', [], intents={INTENT_READONLY})
+@command(
+'root', [], intents={INTENT_READONLY},
+helpcategory=command.CATEGORY_WORKING_DIRECTORY)
 def root(ui, repo):
 """print the root (top) of the current working directory
 Print the root directory of the current repository.
 ('6', 'ipv6', None, _('use IPv6 in addition to IPv4')),
 ('', 'certificate', '', _('SSL certificate file'), _('FILE')),
 ('', 'print-url', None, _('start and print only the URL'))]
 + subrepoopts,
 _('[OPTION]...'),
+helpcategory=command.CATEGORY_REMOTE_REPO_MANAGEMENT,
 optionalrepo=True)
 def serve(ui, repo, **opts):
 """start stand-alone webserver
 Start a local HTTP repository browser and pull server. You can use
 ('0', 'print0', None, _('end filenames with NUL, for use with xargs')),
 ('', 'rev', [], _('show difference from revision'), _('REV')),
 ('', 'change', '', _('list the changed files of a revision'), _('REV')),
 ] + walkopts + subrepoopts + formatteropts,
 _('[OPTION]... [FILE]...'),
+helpcategory=command.CATEGORY_WORKING_DIRECTORY,
 inferrepo=True,
 intents={INTENT_READONLY})
 def status(ui, repo, *pats, **opts):
 """show changed files in the working directory
 fm.end()
 @command('^summary|sum',
 [('', 'remote', None, _('check for push and pull'))],
 '[--remote]',
+helpcategory=command.CATEGORY_WORKING_DIRECTORY,
 intents={INTENT_READONLY})
 def summary(ui, repo, **opts):
 """summarize working directory state
 This generates a brief summary of the working directory state,
 ('', 'remove', None, _('remove a tag')),
 # -l/--local is already there, commitopts cannot be used
 ('e', 'edit', None, _('invoke editor on commit messages')),
 ('m', 'message', '', _('use text as commit message'), _('TEXT')),
 ] + 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):
 """add one or more tags for the current or given revision
 Name a particular revision using <name>.
 raise error.Abort(_("cannot tag null revision"))
 tagsmod.tag(repo, names, node, message, opts.get('local'),
 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):
 """list repository tags
 This lists both regular and local tags. When the -v/--verbose
 switch is used, a third column "local" is printed for local tags.
 @command('tip',
 [('p', 'patch', None, _('show patch')),
 ('g', 'git', None, _('use git extended diff format')),
 ] + templateopts,
-_('[-p] [-g]'))
+_('[-p] [-g]'),
+helpcategory=command.CATEGORY_CHANGE_NAVIGATION)
 def tip(ui, repo, **opts):
 """show the tip revision (DEPRECATED)
 The tip revision (usually just called the tip) is the changeset
 most recently added to the repository (and therefore the most
 displayer.close()
 @command('unbundle',
 [('u', 'update', None,
 _('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):
 """apply one or more bundle files
 Apply one or more bundle files generated by :hg:`bundle`.
 ('c', 'check', None, _('require clean working directory')),
 ('m', 'merge', None, _('merge uncommitted changes')),
 ('d', 'date', '', _('tipmost revision matching date'), _('DATE')),
 ('r', 'rev', '', _('revision'), _('REV'))
 ] + 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):
 """update working directory (or switch revisions)
 Update the repository's working directory to the specified
 changeset. If no changeset is specified, update to the tip of the
 if ctx.obsolete():
 obsfatemsg = obsutil._getfilteredreason(repo, ctxstr, ctx)
 ui.warn("(%s)\n" % obsfatemsg)
 return ret
-@command('verify', [])
+@command('verify', [], helpcategory=command.CATEGORY_MAINTENANCE)
 def verify(ui, repo):
 """verify the integrity of the repository
 Verify the integrity of the current repository.
 Returns 0 on success, 1 if errors are encountered.
 """
 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):
 """output version and copyright information
 .. container:: verbose

changeset 40293	c303d65d2e34
parent 40117	dd23eb81a3a3
child 40295	fa88170c10bb