Synopsis: log [options] [files…]
Requires: repository, working directory.
Changes: nothing.
Display log information for files. log used to call the rcs utility rlog. Although this is no longer true in the current sources, this history determines the format of the output and the options, which are not quite in the style of the other cvs commands.
The output includes the location of the rcs file, the head revision (the latest revision on the trunk), all symbolic names (tags) and some other things. For each revision, the revision number, the author, the number of lines added/deleted and the log message are printed. All times are displayed in Coordinated Universal Time (UTC). (Other parts of cvs print times in the local timezone).
Warning: log uses -R in a way that conflicts with the normal use inside cvs (通用命令选项).
By default, log prints all information that is available. All other options restrict the output.
Print information about the revisions on the default branch, normally the highest branch on the trunk.
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 (通用命令选项). Dates can be combined into ranges as follows:
Select the revisions that were deposited between d1 and d2.
Select all revisions dated d or earlier.
Select all revisions dated d or later.
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 (;).
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.
Local; run only in current working directory. (Default is to run recursively).
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.
Print only the name of the rcs file.
Print information about revisions given in the comma-separated list revisions of revisions and ranges. The following table explains the available range formats:
Revisions rev1 to rev2 (which must be on the same branch).
The same, but excluding rev1.
Revisions from the beginning of the branch up to and including rev.
Revisions starting with rev to the end of the branch containing rev.
Revisions starting just after rev to the end of the branch containing rev.
An argument that is a branch means all revisions on that branch.
A range of branches means all revisions on the branches in that range.
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.
Suppress the header if no revisions are selected.
Print information about revisions whose state attributes match one of the states given in the comma-separated list states.
Print the same as -h, plus the descriptive text.
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.
Contributed examples are gratefully accepted.