Help: timeline
The "timeline" command:
Usage: fossil timeline ?WHEN? ?CHECKIN|DATETIME? ?OPTIONS?
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 checkout'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.