hg prune [OPTION]... [-r] REV...

aliases: obsolete

mark changesets as obsolete or succeeded by another changeset

Pruning changesets marks them obsolete, hiding them from the history log, provided they have no descendants. Otherwise, all such descendants that aren't themselves obsolete become "unstable". Use 'hg evolve' to handle this situation.

When you prune the parent of your working copy, Mercurial updates the working copy to a non-obsolete parent.

You can use "-s/--successor" to tell Mercurial that a newer version (successor) of the pruned changeset exists. Mercurial records successor revisions in obsolescence markers.

If you prune a single revision and specify multiple revisions in "-s/--successor", you are recording a "split" and must acknowledge it by passing "--split". Similarly, when you prune multiple changesets with a single successor, you must pass the "--fold" option.

If you want to supersede multiple revisions at the same time, use the "--pair" option to pair the pruned precursor and successor changesets. This is commonly useful for resolving history divergence, or when someone else edits history without obsolescence enabled.

"hg prune A::B -s C::D --pair" will mark all revisions in the A::B range as superseded by the revisions in C::D. Both revsets need to have the same number of changesets.

options ([+] can be repeated):

-n --new VALUE [+] successor changeset (DEPRECATED)
-s --successor REV [+] successor changeset
-r --rev REV [+] revisions to prune
-k --keep does not modify working copy during prune
-n --note TEXT store a note on prune
--pair record a pairing, such as a rebase or divergence resolution (pairing multiple precursors to multiple successors)
--biject alias to --pair (DEPRECATED)
--fold record a fold (multiple precursors, one successor)
--split record a split (one precursor, multiple successors)
-B --bookmark BOOKMARK [+] remove revs only reachable from given bookmark
-d --date DATE record the specified date in metadata
-u --user USER record the specified user in metadata

global options ([+] can be repeated):

-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')
--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)

mercurial