13 rlog \- print log messages and other information about RCS files
16 .RI [ " options " ] " file " .\|.\|.
19 prints information about \*r files.
21 Pathnames matching an \*r suffix denote \*r files;
22 all others denote working files.
23 Names are paired as explained in
27 prints the following information for each
28 \*r file: \*r pathname, working pathname, head (i.e., the number
29 of the latest revision on the trunk), default branch, access list, locks,
30 symbolic names, suffix, total number of revisions,
31 number of revisions selected for printing, and
32 descriptive text. This is followed by entries for the selected revisions in
33 reverse chronological order for each branch. For each revision,
35 prints revision number, author, date/time, state, number of
36 lines added/deleted (with respect to the previous revision),
37 locker of the revision (if any), and log message.
38 All times are displayed in Coordinated Universal Time (\*u) by default;
39 this can be overridden with
43 prints complete information.
44 The options below restrict this output.
45 .nr n \w'\f3\-V\fP\f2n\fP'+2n-1/1n
47 .if \n(.g .if r an-tag-sep .ds n \w'\f3\-V\fP\f2n\fP'u+\n[an-tag-sep]u
50 Ignore \*r files that have no locks set.
51 This is convenient in combination with
58 Print only the name of the \*r file.
59 This is convenient for translating a
60 working pathname into an \*r pathname.
63 Print only the working pathname and tip-revision.
64 The optional string is prepended to the outputline.
67 Print only the \*r pathname, working pathname, head,
68 default branch, access list, locks,
69 symbolic names, and suffix.
74 plus the descriptive text.
77 Do not print the symbolic names.
80 Print information about the revisions on the default branch, normally
81 the highest branch on the trunk.
84 Print information about revisions with a checkin date/time in the ranges given by
85 the semicolon-separated list of
91 selects the revisions that were deposited between
101 all revisions earlier than
108 all revisions dated later than
116 then the ranges are inclusive, not exclusive.
119 selects the single, latest revision dated
122 The date/time strings
127 are in the free format explained in
129 Quoting is normally necessary, especially for
133 Note that the separator is
136 .BR \-l [\f2lockers\fP]
137 Print information about locked revisions only.
138 In addition, if the comma-separated list
140 of login names is given,
141 ignore all locks other than those held by the
144 .B "rlog\ \-L\ \-R\ \-lwft\ RCS/*"
145 prints the name of \*r files locked by the user
148 .BR \-r [\f2revisions\fP]
149 prints information about revisions given in the comma-separated list
151 of revisions and ranges.
160 means revisions from the beginning of the branch up to and including
164 means revisions starting with
166 to the end of the branch containing
168 An argument that is a branch means all
169 revisions on that branch.
170 A range of branches means all revisions
171 on the branches in that range.
172 A branch followed by a
174 means the latest revision in that branch.
179 means the latest revision on the default branch, normally the trunk.
182 prints information about revisions whose state attributes match one of the
183 states given in the comma-separated list
186 .BR \-w [\f2logins\fP]
187 prints information about revisions checked in by users with
188 login names appearing in the comma-separated list
192 is omitted, the user's login is assumed.
195 This option has no effect;
196 it is present for compatibility with other \*r commands.
199 Print \*r's version number.
204 when generating logs.
212 to characterize \*r files.
218 prints the intersection of the revisions selected with
226 with the union of the revisions selected by
232 specifies the date output format,
233 and specifies the default time zone for
240 should be empty, a numeric \*u offset, or the special string
243 The default is an empty
245 which uses the traditional \*r format of \*u without any time zone indication
246 and with slashes separating the parts of the date;
247 otherwise, times are output in \*i 8601 format with time zone indication.
248 For example, if local time is January 11, 1990, 8pm Pacific Standard Time,
249 eight hours west of \*u,
250 then the time is output as follows:
255 .ta \w'\f3\-z+05:30\fP 'u +\w'\f31990-01-11 09:30:00+05:30\fP 'u
257 \f2option\fP \f2time output\fP
258 \f3\-z\fP \f31990/01/12 04:00:00\fP \f2(default)\fP
259 \f3\-zLT\fP \f31990-01-11 20:00:00\-08\fP
260 \f3\-z+05:30\fP \f31990-01-12 09:30:00+05:30\fP
267 .B " rlog \-L \-R RCS/*"
268 .B " rlog \-L \-h RCS/*"
269 .B " rlog \-L \-l RCS/*"
273 The first command prints the names of all \*r files in the subdirectory
275 that have locks. The second command prints the headers of those files,
276 and the third prints the headers plus the log messages of the locked revisions.
277 The last command prints complete information.
281 options prepended to the argument list, separated by spaces.
286 The exit status is zero if and only if all operations were successful.
288 Author: Walter F. Tichy.
290 Manual Page Revision: \*(Rv; Release Date: \*(Dt.
292 Copyright \(co 1982, 1988, 1989 Walter F. Tichy.
294 Copyright \(co 1990, 1991, 1992, 1993, 1994, 1995 Paul Eggert.
296 ci(1), co(1), ident(1), rcs(1), rcsdiff(1), rcsintro(1), rcsmerge(1),
300 \*r\*-A System for Version Control,
301 .I "Software\*-Practice & Experience"
303 7 (July 1985), 637-654.
305 The separator for revision ranges in the
311 but this leads to confusion when symbolic names contain
313 For backwards compatibility
315 still supports the old
317 separator, but it warns about this obsolete use.