Commands

On this page

Commands#

Documentation of Mercurial 7.2.4.

Repository creation

  • clone: make a copy of an existing repository

  • 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

  • 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

  • branch: set or show the current branch name

  • branches: list repository named branches

  • 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

  • copy: mark files as copied for the next commit

  • diff: diff repository (or selected files)

  • grep: search for a pattern in specified files

Change navigation

  • bisect: subdivision search of changesets

  • heads: show branch heads

  • identify: identify the working directory or specified revision

  • log: show revision history of entire repository or files

Working directory management

  • add: add the specified files on the next commit

  • addremove: add all new files, delete all missing files

  • files: list tracked files

  • forget: forget the specified files on the next commit

  • purge: removes files not tracked by Mercurial

  • remove: remove the specified files on the next commit

  • rename: rename files; equivalent of copy + remove

  • resolve: redo merges or set/view the merge status of files

  • revert: restore files to their checkout state

  • root: print the root (top) of the current working directory

  • shelve: save and set aside changes from the working directory

  • status: show changed files in the working directory

  • summary: summarize working directory state

  • unshelve: restore a shelved change to the working directory

  • 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

  • admin::verify: verify the integrity of the repository

  • manifest: output the current or given revision of the project manifest

  • recover: roll back an interrupted transaction

  • 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

Deprecated and other commands

  • abort: abort an unfinished operation (EXPERIMENTAL)

  • admin::chainsaw-update: pull and update to a given revision, no matter what, (EXPERIMENTAL)

  • admin::narrow-client: Narrow-related client administration utils. (EXPERIMENTAL)

  • admin::narrow-server: Narrow-related server administration utils. (EXPERIMENTAL)

  • continue: resumes an interrupted operation (EXPERIMENTAL)

  • locate: locate files matching specific patterns (DEPRECATED)

  • parents: show the parents of the working directory or revision (DEPRECATED)

  • rollback: roll back the last transaction (DANGEROUS) (DEPRECATED)

  • tip: show the tip revision (DEPRECATED)

Global options#

These options are accepted by all the commands.

-R

--repository REPO

repository root directory or name of overlay bundle file

--cwd DIR

change working directory

-y

--noninteractive

do not prompt, automatically pick the first choice for all prompts

-q

--quiet

suppress output

-v

--verbose

enable additional output

--color TYPE

when to colorize (boolean, always, auto, never, or debug)

--config CONFIG [+]

set/override config option (use 'section.name=value')

--config-file HGRC [+]

load config file to set/override config options

--debug

enable debugging output

--debugger

start debugger

--encoding ENCODE

set the charset encoding (default: UTF-8)

--encodingmode MODE

set the charset encoding mode (default: strict)

--traceback

always print a traceback on exception

--time

time how long the command takes

--profile

print command execution profile

--version

output version information and exit

-h

--help

display help and exit

--hidden

consider hidden changesets

--pager TYPE

when to paginate (boolean, always, auto, or never) (default: auto)

Options marked [+] can be repeated.

On this page