NAME 

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

SYNOPSIS 

cg-log [-D DATE] [-r FROM_ID[..TO_ID]] [-s] [--summary] [OTHER_OPTIONS] FILE...

DESCRIPTION 

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.

OPTIONS 

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).
-M, --no-merges
Don't display merge commits in the log.
-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
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 summary.
--long-help
Print user manual. The same as found in cg-log(1).

ENVIRONMENT VARIABLES 

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.

EXAMPLE USAGE 

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 in branch B,
$ cg-log -r B..A
(meaning "all the commits which newly appear along the way from B to A").

NOTES 

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 

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

SEE ALSO 

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