A.14.1 log options
By default, log
prints all information that is
available. All other options restrict the output. Note that the revision
selection options (-d
, -r
, -s
, and -w
) have no
effect, other than possibly causing a search for files in Attic directories,
when used in conjunction with the options that restrict the output to only
log
header fields (-b
, -h
, -R
, and -t
)
unless the -S
option is also specified.
-b
- Print information about the revisions on the default
branch, normally the highest branch on the trunk.
-d
dates- Print information about revisions with a checkin
date/time in the range given by the
semicolon-separated list of dates. The date formats
accepted are those accepted by the -D option to
many other cvs commands (see Common options).
Dates can be combined into ranges as follows:
- d1
<
d2- d2
>
d1 - Select the revisions that were deposited between
d1 and d2.
<
d- d
>
- Select all revisions dated d or earlier.
- d
<
>
d - Select all revisions dated d or later.
- d
- Select the single, latest revision dated d or
earlier.
The > or < characters may be followed by
= to indicate an inclusive range rather than an
exclusive one.
Note that the separator is a semicolon (;).
-h
- Print only the name of the rcs file, name
of the file in the working directory, head,
default branch, access list, locks, symbolic names, and
suffix.
-l
- Local; run only in current working directory. (Default
is to run recursively).
-N
- Do not print the list of tags for this file. This
option can be very useful when your site uses a lot of
tags, so rather than "more"'ing over 3 pages of tag
information, the log information is presented without
tags at all.
-R
- Print only the name of the rcs file.
-r
revisions- Print information about revisions given in the
comma-separated list revisions of revisions and
ranges. The following table explains the available
range formats:
- rev1
:
rev2 - Revisions rev1 to rev2 (which must be on
the same branch).
- rev1
::
rev2 - The same, but excluding rev1.
:
rev::
rev- Revisions from the beginning of the branch up to
and including rev.
- rev
:
- Revisions starting with rev to the end of the
branch containing rev.
- rev
::
- Revisions starting just after rev to the end of the
branch containing rev.
- branch
- An argument that is a branch means all revisions on
that branch.
- branch1
:
branch2- branch1
::
branch2 - A range of branches means all revisions
on the branches in that range.
- branch
.
- The latest revision in branch.
A bare -r with no revisions means the latest
revision on the default branch, normally the trunk.
There can be no space between the -r option and
its argument.
-S
- Suppress the header if no revisions are selected.
-s
states- Print information about revisions whose state
attributes match one of the states given in the
comma-separated list states. Individual states may
be any text string, though cvs commonly only uses two
states, Exp and dead. See admin options
for more information.
-t
- Print the same as -h, plus the descriptive text.
-w
logins- Print information about revisions checked in by users
with login names appearing in the comma-separated list
logins. If logins is omitted, the user's
login is assumed. There can be no space between the
-w option and its argument.
log
prints the intersection of the revisions
selected with the options -d, -s, and
-w, intersected with the union of the revisions
selected by -b and -r.