5 .Id $FreeBSD: src/gnu/usr.bin/rcs/rlog/rlog.1,v 1.8 1999/08/27 23:36:59 peter Exp $
6 .Id $DragonFly: src/gnu/usr.bin/rcs/rlog/rlog.1,v 1.2 2003/06/17 04:25:48 dillon Exp $
14 rlog \- print log messages and other information about RCS files
17 .RI [ " options " ] " file " .\|.\|.
20 prints information about \*r files.
22 Pathnames matching an \*r suffix denote \*r files;
23 all others denote working files.
24 Names are paired as explained in
28 prints the following information for each
29 \*r file: \*r pathname, working pathname, head (i.e., the number
30 of the latest revision on the trunk), default branch, access list, locks,
31 symbolic names, suffix, total number of revisions,
32 number of revisions selected for printing, and
33 descriptive text. This is followed by entries for the selected revisions in
34 reverse chronological order for each branch. For each revision,
36 prints revision number, author, date/time, state, number of
37 lines added/deleted (with respect to the previous revision),
38 locker of the revision (if any), and log message.
39 All times are displayed in Coordinated Universal Time (\*u) by default;
40 this can be overridden with
44 prints complete information.
45 The options below restrict this output.
46 .nr n \w'\f3\-V\fP\f2n\fP'+2n-1/1n
48 .if \n(.g .if r an-tag-sep .ds n \w'\f3\-V\fP\f2n\fP'u+\n[an-tag-sep]u
51 Ignore \*r files that have no locks set.
52 This is convenient in combination with
59 Print only the name of the \*r file.
60 This is convenient for translating a
61 working pathname into an \*r pathname.
64 Print only the working pathname and tip-revision.
65 The optional string is prepended to the outputline.
68 Print only the \*r pathname, working pathname, head,
69 default branch, access list, locks,
70 symbolic names, and suffix.
75 plus the descriptive text.
78 Do not print the symbolic names.
81 Print information about the revisions on the default branch, normally
82 the highest branch on the trunk.
85 Print information about revisions with a checkin date/time in the ranges given by
86 the semicolon-separated list of
92 selects the revisions that were deposited between
102 all revisions earlier than
109 all revisions dated later than
117 then the ranges are inclusive, not exclusive.
120 selects the single, latest revision dated
123 The date/time strings
128 are in the free format explained in
130 Quoting is normally necessary, especially for
134 Note that the separator is
137 .BR \-l [\f2lockers\fP]
138 Print information about locked revisions only.
139 In addition, if the comma-separated list
141 of login names is given,
142 ignore all locks other than those held by the
145 .B "rlog\ \-L\ \-R\ \-lwft\ RCS/*"
146 prints the name of \*r files locked by the user
149 .BR \-r [\f2revisions\fP]
150 prints information about revisions given in the comma-separated list
152 of revisions and ranges.
161 means revisions from the beginning of the branch up to and including
165 means revisions starting with
167 to the end of the branch containing
169 An argument that is a branch means all
170 revisions on that branch.
171 A range of branches means all revisions
172 on the branches in that range.
173 A branch followed by a
175 means the latest revision in that branch.
180 means the latest revision on the default branch, normally the trunk.
183 prints information about revisions whose state attributes match one of the
184 states given in the comma-separated list
187 .BR \-w [\f2logins\fP]
188 prints information about revisions checked in by users with
189 login names appearing in the comma-separated list
193 is omitted, the user's login is assumed.
196 This option has no effect;
197 it is present for compatibility with other \*r commands.
200 Print \*r's version number.
205 when generating logs.
213 to characterize \*r files.
219 prints the intersection of the revisions selected with
227 with the union of the revisions selected by
233 specifies the date output format,
234 and specifies the default time zone for
241 should be empty, a numeric \*u offset, or the special string
244 The default is an empty
246 which uses the traditional \*r format of \*u without any time zone indication
247 and with slashes separating the parts of the date;
248 otherwise, times are output in \*i 8601 format with time zone indication.
249 For example, if local time is January 11, 1990, 8pm Pacific Standard Time,
250 eight hours west of \*u,
251 then the time is output as follows:
256 .ta \w'\f3\-z+05:30\fP 'u +\w'\f31990-01-11 09:30:00+05:30\fP 'u
258 \f2option\fP \f2time output\fP
259 \f3\-z\fP \f31990/01/12 04:00:00\fP \f2(default)\fP
260 \f3\-zLT\fP \f31990-01-11 20:00:00\-08\fP
261 \f3\-z+05:30\fP \f31990-01-12 09:30:00+05:30\fP
268 .B " rlog \-L \-R RCS/*"
269 .B " rlog \-L \-h RCS/*"
270 .B " rlog \-L \-l RCS/*"
274 The first command prints the names of all \*r files in the subdirectory
276 that have locks. The second command prints the headers of those files,
277 and the third prints the headers plus the log messages of the locked revisions.
278 The last command prints complete information.
282 options prepended to the argument list, separated by spaces.
287 The exit status is zero if and only if all operations were successful.
289 Author: Walter F. Tichy.
291 Manual Page Revision: \*(Rv; Release Date: \*(Dt.
293 Copyright \(co 1982, 1988, 1989 Walter F. Tichy.
295 Copyright \(co 1990, 1991, 1992, 1993, 1994, 1995 Paul Eggert.
297 ci(1), co(1), ident(1), rcs(1), rcsdiff(1), rcsintro(1), rcsmerge(1),
301 \*r\*-A System for Version Control,
302 .I "Software\*-Practice & Experience"
304 7 (July 1985), 637-654.
306 The separator for revision ranges in the
312 but this leads to confusion when symbolic names contain
314 For backwards compatibility
316 still supports the old
318 separator, but it warns about this obsolete use.