| blob | 1f5e7223d3f179d207a47718e801cdba76c50e7e |
1 .\" $NetBSD: rlog.1,v 1.4 1996/10/15 07:00:49 veego Exp $
2 .\"
3 .de Id
4 .ds Rv \\$3
5 .ds Dt \\$4
6 ..
7 .\" Id: rlog.1,v 5.9 1995/06/16 06:19:24 eggert Exp
8 .ds i \&\s-1ISO\s0
9 .ds r \&\s-1RCS\s0
10 .ds u \&\s-1UTC\s0
11 .if n .ds - \%--
12 .if t .ds - \(em
13 .TH RLOG 1 \*(Dt GNU
14 .SH NAME
15 rlog \- print log messages and other information about RCS files
16 .SH SYNOPSIS
17 .B rlog
18 .RI [ " options " ] " file " .\|.\|.
19 .SH DESCRIPTION
20 .B rlog
21 prints information about \*r files.
22 .PP
23 Pathnames matching an \*r suffix denote \*r files;
24 all others denote working files.
25 Names are paired as explained in
26 .BR ci (1).
27 .PP
28 .B rlog
29 prints the following information for each
30 \*r file: \*r pathname, working pathname, head (i.e., the number
31 of the latest revision on the trunk), default branch, access list, locks,
32 symbolic names, suffix, total number of revisions,
33 number of revisions selected for printing, and
34 descriptive text. This is followed by entries for the selected revisions in
35 reverse chronological order for each branch. For each revision,
36 .B rlog
37 prints revision number, author, date/time, state, number of
38 lines added/deleted (with respect to the previous revision),
39 locker of the revision (if any), and log message.
40 All times are displayed in Coordinated Universal Time (\*u) by default;
41 this can be overridden with
42 .BR \-z .
43 Without options,
44 .B rlog
45 prints complete information.
46 The options below restrict this output.
47 .nr n \w'\f3\-V\fP\f2n\fP'+2n-1/1n
48 .ds n \nn
49 .if \n(.g .if r an-tag-sep .ds n \w'\f3\-V\fP\f2n\fP'u+\n[an-tag-sep]u
50 .TP \*n
51 .B \-L
52 Ignore \*r files that have no locks set.
53 This is convenient in combination with
54 .BR \-h ,
55 .BR \-l ,
56 and
57 .BR \-R .
58 .TP
59 .B \-R
60 Print only the name of the \*r file.
61 This is convenient for translating a
62 working pathname into an \*r pathname.
63 .TP
64 .B \-h
65 Print only the \*r pathname, working pathname, head,
66 default branch, access list, locks,
67 symbolic names, and suffix.
68 .TP
69 .B \-t
70 Print the same as
71 .BR \-h ,
72 plus the descriptive text.
73 .TP
74 .B \-N
75 Do not print the symbolic names.
76 .TP
77 .B \-b
78 Print information about the revisions on the default branch, normally
79 the highest branch on the trunk.
80 .TP
81 .BI \-d "dates"
82 Print information about revisions with a checkin date/time in the ranges given by
83 the semicolon-separated list of
84 .IR dates .
85 A range of the form
86 .IB d1 \*[Lt] d2
87 or
88 .IB d2 \*[Gt] d1
89 selects the revisions that were deposited between
90 .I d1
91 and
92 .I d2
93 exclusive.
94 A range of the form
95 .BI \*[Lt] d
96 or
97 .IB d \*[Gt]
98 selects
99 all revisions earlier than
100 .IR d .
101 A range of the form
102 .IB d \*[Lt]
103 or
104 .BI \*[Gt] d
105 selects
106 all revisions dated later than
107 .IR d .
108 If
109 .B \*[Lt]
110 or
111 .B \*[Gt]
112 is followed by
113 .B =
114 then the ranges are inclusive, not exclusive.
115 A range of the form
116 .I d
117 selects the single, latest revision dated
118 .I d
119 or earlier.
120 The date/time strings
121 .IR d ,
122 .IR d1 ,
123 and
124 .I d2
125 are in the free format explained in
126 .BR co (1).
127 Quoting is normally necessary, especially for
128 .B \*[Lt]
129 and
130 .BR \*[Gt] .
131 Note that the separator is
132 a semicolon.
133 .TP
134 .BR \-l [\f2lockers\fP]
135 Print information about locked revisions only.
136 In addition, if the comma-separated list
137 .I lockers
138 of login names is given,
139 ignore all locks other than those held by the
140 .IR lockers .
141 For example,
142 .B "rlog\ \-L\ \-R\ \-lwft\ RCS/*"
143 prints the name of \*r files locked by the user
144 .BR wft .
145 .TP
146 .BR \-r [\f2revisions\fP]
147 prints information about revisions given in the comma-separated list
148 .I revisions
149 of revisions and ranges.
150 A range
151 .IB rev1 : rev2
152 means revisions
153 .I rev1
154 to
155 .I rev2
156 on the same branch,
157 .BI : rev
158 means revisions from the beginning of the branch up to and including
159 .IR rev ,
160 and
161 .IB rev :
162 means revisions starting with
163 .I rev
164 to the end of the branch containing
165 .IR rev .
166 An argument that is a branch means all
167 revisions on that branch.
168 A range of branches means all revisions
169 on the branches in that range.
170 A branch followed by a
171 .B .\&
172 means the latest revision in that branch.
173 A bare
174 .B \-r
175 with no
176 .I revisions
177 means the latest revision on the default branch, normally the trunk.
178 .TP
179 .BI \-s states
180 prints information about revisions whose state attributes match one of the
181 states given in the comma-separated list
182 .IR states .
183 .TP
184 .BR \-w [\f2logins\fP]
185 prints information about revisions checked in by users with
186 login names appearing in the comma-separated list
187 .IR logins .
188 If
189 .I logins
190 is omitted, the user's login is assumed.
191 .TP
192 .B \-T
193 This option has no effect;
194 it is present for compatibility with other \*r commands.
195 .TP
196 .BI \-V
197 Print \*r's version number.
198 .TP
199 .BI \-V n
200 Emulate \*r version
201 .I n
202 when generating logs.
203 See
204 .BR co (1)
205 for more.
206 .TP
207 .BI \-x "suffixes"
208 Use
209 .I suffixes
210 to characterize \*r files.
211 See
212 .BR ci (1)
213 for details.
214 .PP
215 .B rlog
216 prints the intersection of the revisions selected with
217 the options
218 .BR \-d ,
219 .BR \-l ,
220 .BR \-s ,
221 and
222 .BR \-w ,
223 intersected
224 with the union of the revisions selected by
225 .B \-b
226 and
227 .BR \-r .
228 .TP
229 .BI \-z zone
230 specifies the date output format,
231 and specifies the default time zone for
232 .I date
233 in the
234 .BI \-d dates
235 option.
236 The
237 .I zone
238 should be empty, a numeric \*u offset, or the special string
239 .B LT
240 for local time.
241 The default is an empty
242 .IR zone ,
243 which uses the traditional \*r format of \*u without any time zone indication
244 and with slashes separating the parts of the date;
245 otherwise, times are output in \*i 8601 format with time zone indication.
246 For example, if local time is January 11, 1990, 8pm Pacific Standard Time,
247 eight hours west of \*u,
248 then the time is output as follows:
249 .RS
250 .LP
251 .RS
252 .nf
253 .ta \w'\f3\-z+05:30\fP 'u +\w'\f31990-01-11 09:30:00+05:30\fP 'u
254 .ne 4
255 \f2option\fP \f2time output\fP
256 \f3\-z\fP \f31990/01/12 04:00:00\fP \f2(default)\fP
257 \f3\-zLT\fP \f31990-01-11 20:00:00\-08\fP
258 \f3\-z+05:30\fP \f31990-01-12 09:30:00+05:30\fP
259 .ta 4n +4n +4n +4n
260 .fi
261 .RE
262 .SH EXAMPLES
263 .LP
264 .nf
265 .B " rlog \-L \-R RCS/*"
266 .B " rlog \-L \-h RCS/*"
267 .B " rlog \-L \-l RCS/*"
268 .B " rlog RCS/*"
269 .fi
270 .LP
271 The first command prints the names of all \*r files in the subdirectory
272 .B RCS
273 that have locks. The second command prints the headers of those files,
274 and the third prints the headers plus the log messages of the locked revisions.
275 The last command prints complete information.
276 .SH ENVIRONMENT
277 .TP
278 .B \s-1RCSINIT\s0
279 options prepended to the argument list, separated by spaces.
280 See
281 .BR ci (1)
282 for details.
283 .SH DIAGNOSTICS
284 The exit status is zero if and only if all operations were successful.
285 .SH IDENTIFICATION
286 Author: Walter F. Tichy.
287 .br
288 Manual Page Revision: \*(Rv; Release Date: \*(Dt.
289 .br
290 Copyright \(co 1982, 1988, 1989 Walter F. Tichy.
291 .br
292 Copyright \(co 1990, 1991, 1992, 1993, 1994, 1995 Paul Eggert.
293 .SH "SEE ALSO"
294 ci(1), co(1), ident(1), rcs(1), rcsdiff(1), rcsintro(1), rcsmerge(1),
295 rcsfile(5)
296 .br
297 Walter F. Tichy,
298 \*r\*-A System for Version Control,
299 .I "Software\*-Practice \*[Am] Experience"
300 .BR 15 ,
301 7 (July 1985), 637-654.
302 .SH BUGS
303 The separator for revision ranges in the
304 .B \-r
305 option used to be
306 .B \-
307 instead of
308 .BR : ,
309 but this leads to confusion when symbolic names contain
310 .BR \- .
311 For backwards compatibility
312 .B "rlog \-r"
313 still supports the old
314 .B \-
315 separator, but it warns about this obsolete use.
316 .br