cg-log - make a log of changes in a git branch

cg-log [-c] [-f] [-m] [-s] [-uUSERNAME] [-d DATE] [-r FROM_ID[..TO_ID]] [--summary] FILE...

Display log information for files or a range of commits. The output will automatically be displayed in a pager unless it is piped to a program.

Arguments not interpreted as options will be interpreted as filenames; cg-log then displays only changes in those files.

-c

Colorize the output. The used colors are listed below together with information about which log output (summary, full or both) they apply to:

•

author: cyan (both)

•

committer: magenta (full)

•

header: green (full)

•

files: blue (full)

•

signoff: yellow (full)

•

commit_id: blue (summary)

•

date: green (summary)

•

trim_mark: magenta (summary)

-f

List affected files. (No effect when passed along -s.)

-r FROM_ID[..TO_ID]

Limit the log information to a set of revisions using either -r FROM_ID[..TO_ID] or -r FROM_ID -r TO_ID. In both cases the option expects IDs which resolve to commits and will include the specified IDs. If TO_ID is omitted all commits from FROM_ID to the initial commit is shown. If no revisions is specified, the log information starting from HEAD will be shown.

-d DATE

Limit the log information to revisions newer than given DATE, and on second time further restrain it to revisions older than given date. Therefore, -d "2 days ago" -d "yesterday" will show all the commits from the day before yesterday.

-m

End the log listing at the merge base of the -r arguments (defaulting to HEAD and origin).

-s

Show a one line summary for each log entry. The summary contains information about the commit date, the author, the first line of the commit log and the commit ID. Long author names and commit IDs are trimmed and marked with an ending tilde (~).

--summary

Generate the changes summary, listing the commit titles grouped by their author. This is also known as a "shortlog", suitable e.g. for contribution summaries of announcements.

-uUSERNAME

List only commits where author or committer contains USERNAME. The search for USERNAME is case-insensitive.

-h, --help

Print usage help.

PAGER

The pager to display log information in, defaults to less.

PAGER_FLAGS

Flags to pass to the pager.

CG_LESS

This is what the $LESS environment variable value will be set to before invoking $PAGER. It defaults to $LESS concatenated with the R and S flags to allow displaying of colorized output and to avoid long lines from wrapping when using -s.

To show a log of changes between two releases tagged as releasetag-0.9 and releasetag-0.10 do:

$ cg-log -r releasetag-0.9..releasetag-0.10

Similarily, to see which commits are in branch A but not yet in branch B,

$ cg-log -r B..A

(meaning "all the commits needed along the way from B to A").

The : is equivalent to .. in revisions range specification (to make things more comfortable to SVN users). See cogito(7) for more details about revision specification.

Copyright © Petr Baudis, 2005. Copyright © David Woodhouse, 2005.

cg-log command is part of cogito(7), a toolkit for managing git(7) trees.