Print a summary of activity going backwards in date and time specified or from the current date and time if no arguments are given. The WHEN argument can be any unique abbreviation of one of these keywords:

before
after
descendants | children
ancestors | parents

The CHECKIN can be any unique prefix of 4 characters or more. You can also say "current" for the current version.

DATETIME may be "now" or "YYYY-MM-DDTHH:MM:SS.SSS". If in year-month-day form, it may be truncated, the "T" may be replaced by a space, and it may also name a timezone offset from UTC as "-HH:MM" (westward) or "+HH:MM" (eastward). Either no timezone suffix or "Z" means UTC.

Options:

-b|--branch BRANCH

Show only items on the branch named BRANCH

-c|--current-branch

Show only items on the current branch

-F|--format

Entry format. Values "oneline", "medium", and "full" get mapped to the full options below. Otherwise a string which can contain these placeholders:

%n

newline

%%

a raw %

%H

commit hash

%h

abbreviated commit hash

%a

author name

%d

date

%c

comment (NL, TAB replaced by space, LF deleted)

%b

branch

%t

tags

%p

phase: zero or more of *CURRENT*, *MERGE*, *FORK*, *UNPUBLISHED*, *LEAF*, *BRANCH*

--oneline

Show only short hash and comment for each entry

--medium

Medium-verbose entry formatting

--full

Extra verbose entry formatting

-n|--limit N

If N is positive, output the first N entries. If N is negative, output the first -N lines. If N is zero, no limit. Default is -20 meaning 20 lines.

--offset P

Skip P changes

-p|--path PATH

Output items affecting PATH only. PATH can be a file or a sub directory.

-R REPO_FILE

Specifies the repository db to use. Default is the current check-out's repository.

--sql

Show the SQL used to generate the timeline

-t|--type TYPE

Output items from the given types only, such as: ci = file commits only e = technical notes only f = forum posts only t = tickets only w = wiki commits only

-v|--verbose

Output the list of files changed by each commit and the type of each change (edited, deleted, etc.) after the check-in comment.

-W|--width N

Width of lines (default is to auto-detect). N must be either greater than 20 or it must be zero 0 to indicate no limit, resulting in a single line per entry.