cg-log(1) Manual Page
NAME
cg - log - make a log of changes in a git branch
SYNOPSIS
cg-log [-c] [-f] [-m] [-s] [-uUSERNAME] [-r FROM_ID[:TO_ID]] 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 to 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.
- -m
- End the log listing at the merge base of the -r arguments (defaulting to master 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 (~).
- -uUSERNAME
- List only commits where author or committer contains USERNAME. The search for USERNAME is case-insensitive.
- -h, —help
- Print usage help.
ENVIRONMENT VARIABLES
- PAGER
- The pager to display log information in, defaults to less.
- PAGER_FLAGS
- Flags to pass to the pager. By default R and S is added to the LESS environment variable 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
COPYRIGHT
Copyright © Petr Baudis, 2005. Copyright © David Woodhouse, 2005.
SEE ALSO
cg-log command is part of cogito(7), a toolkit for managing git(7) trees.