|
 |
|
| |
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 section Common command 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.
-
-rrevisions
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.
-
-wlogins
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'.
|
|
|
