Mercurial > hello

Help: fold

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.

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

aliases: squash

fold multiple revisions into a single one

With --from, folds all the revisions linearly between the given revisions and the parent of the working directory.

With --exact, folds only the specified revisions while ignoring the parent of the working directory. In this case, the given revisions must form a linear unbroken chain.

Some examples:

  • Fold the current revision with its parent: 
    hg fold --from .^
  • Fold all draft revisions with working directory parent: 
    hg fold --from 'draft()'

    See 'hg help phases' for more about draft revisions and 'hg help revsets' for more about the 'draft()' keyword

  • Fold revisions between 3 and 6 with the working directory parent: 
    hg fold --from 3::6
  • Fold revisions 3 and 4: 
    hg fold "3 + 4" --exact
  • Only fold revisions linearly between foo and @: 
    hg fold foo::@ --exact

options ([+] can be repeated):

-r --rev REV [+] revision to fold
--exact only fold specified revisions
--from fold revisions linearly to working copy parent
-n --note TEXT store a note on fold
-m --message TEXT use text as commit message
-l --logfile FILE read commit message from file
-d --date DATE record the specified date as commit date
-u --user USER record the specified user as committer
-D --current-date record the current date as commit date
-U --current-user record the current user as committer

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)