- publishing free software manuals
Version Management with CVS - the CVS manual
by Per Cederqvist et al.
Paperback (6"x9"), 216 pages, 8 figures
ISBN 0954161718
RRP £19.95 ($29.95)

Get a printed copy>>>

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 A.5 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 section A.6.1 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’.

ISBN 0954161718Version Management with CVS - the CVS manualSee the print edition