Mercurial > hg > octave-shane
Help: churn
hg churn [-d DATE] [-r REV] [--aliases FILE] [FILE]
histogram of changes to the repository
This command will display a histogram representing the number of changed lines or revisions, grouped according to the given template. The default template will group changes by author. The --dateformat option may be used to group the results by date instead.
Statistics are based on the number of changed lines, or alternatively the number of matching revisions if the --changesets option is specified.
Examples:
# display count of changed lines for every committer hg churn -T "{author|email}"
# display daily activity graph hg churn -f "%H" -s -c
# display activity of developers by month hg churn -f "%Y-%m" -s -c
# display count of lines changed in every year hg churn -f "%Y" -s
# display count of lines changed in a time range hg churn -d "2020-04 to 2020-09"
It is possible to map alternate email addresses to a main address by providing a file using the following format:
<alias email> = <actual email>
Such a file may be specified with the --aliases option, otherwise a .hgchurn file will be looked for in the working directory root. Aliases will be split from the rightmost "=".
options ([+] can be repeated):
-r | --rev REV [+] | count rate for the specified revision or revset |
-d | --date DATE | count rate for revisions matching date spec |
-t | --oldtemplate TEMPLATE | template to group changesets (DEPRECATED) |
-T | --template TEMPLATE | template to group changesets (default: {author|email}) |
-f | --dateformat FORMAT | strftime-compatible format for grouping by date |
-c | --changesets | count rate by number of changesets |
-s | --sort | sort by key (default: sort by count) |
--diffstat | display added/removed lines separately | |
--aliases FILE | file with email aliases | |
-I | --include PATTERN [+] | include names matching the given patterns |
-X | --exclude PATTERN [+] | exclude names matching the given patterns |
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) |