Mercurial > hg-website
Help: fold
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) |