Penguin
Recent Changes
Annotated edit history of rlog(1) version 1, including all changes. View license author blame.
Rev Author # Line
1 perry 1 RLOG
2 !!!RLOG
3 NAME
4 SYNOPSIS
5 DESCRIPTION
6 EXAMPLES
7 ENVIRONMENT
8 DIAGNOSTICS
9 IDENTIFICATION
10 SEE ALSO
11 BUGS
12 ----
13 !!NAME
14
15
16 rlog - print log messages and other information about RCS files
17 !!SYNOPSIS
18
19
20 __rlog__ [[ ''options'' ] ''file'' ...
21 !!DESCRIPTION
22
23
24 __rlog__ prints information about RCS
25 files.
26
27
28 Pathnames matching an RCS suffix denote
29 RCS files; all others denote working files.
30 Names are paired as explained in ci(1).
31
32
33 __rlog__ prints the following information for each
34 RCS file: RCS pathname,
35 working pathname, head (i.e., the number of the latest
36 revision on the trunk), default branch, access list, locks,
37 symbolic names, suffix, total number of revisions, number of
38 revisions selected for printing, and descriptive text. This
39 is followed by entries for the selected revisions in reverse
40 chronological order for each branch. For each revision,
41 __rlog__ prints revision number, author, date/time,
42 state, number of lines added/deleted (with respect to the
43 previous revision), locker of the revision (if any), and log
44 message. All times are displayed in Coordinated Universal
45 Time ( UTC ) by default; this can be
46 overridden with __-z__. Without options, __rlog__
47 prints complete information. The options below restrict this
48 output.
49
50
51 __-L__
52
53
54 Ignore RCS files that have no locks set. This
55 is convenient in combination with __-h__, __-l__, and
56 __-R__.
57
58
59 __-R__
60
61
62 Print only the name of the RCS file. This is
63 convenient for translating a working pathname into an
64 RCS pathname.
65
66
67 __-h__
68
69
70 Print only the RCS pathname, working
71 pathname, head, default branch, access list, locks, symbolic
72 names, and suffix.
73
74
75 __-t__
76
77
78 Print the same as __-h__, plus the descriptive
79 text.
80
81
82 __-N__
83
84
85 Do not print the symbolic names.
86
87
88 __-b__
89
90
91 Print information about the revisions on the default branch,
92 normally the highest branch on the trunk.
93
94
95 __-d__''dates''
96
97
98 Print information about revisions with a checkin date/time
99 in the ranges given by the semicolon-separated list of
100 ''dates''. A range of the form
101 ''d1''____''d2'' or
102 ''d2''____''d1'' selects the revisions that
103 were deposited between ''d1'' and ''d2'' exclusive. A
104 range of the form ____''d'' or ''d''____
105 selects all revisions earlier than ''d''. A range of the
106 form ''d''____ or ____''d'' selects all
107 revisions dated later than ''d''. If ____ or
108 ____ is followed by __=__ then the ranges are
109 inclusive, not exclusive. A range of the form ''d''
110 selects the single, latest revision dated ''d'' or
111 earlier. The date/time strings ''d'', ''d1'', and
112 ''d2'' are in the free format explained in co(1).
113 Quoting is normally necessary, especially for ____
114 and ____. Note that the separator is a
115 semicolon.
116
117
118 __-l__[[''lockers'']
119
120
121 Print information about locked revisions only. In addition,
122 if the comma-separated list ''lockers'' of login names is
123 given, ignore all locks other than those held by the
124 ''lockers''. For example, __rlog -L -R -lwft RCS/*__
125 prints the name of RCS files locked by the
126 user __wft__.
127
128
129 __-r__[[''revisions'']
130
131
132 prints information about revisions given in the
133 comma-separated list ''revisions'' of revisions and
134 ranges. A range ''rev1''__:__''rev2'' means
135 revisions ''rev1'' to ''rev2'' on the same branch,
136 __:__''rev'' means revisions from the beginning of the
137 branch up to and including ''rev'', and
138 ''rev''__:__ means revisions starting with ''rev''
139 to the end of the branch containing ''rev''. An argument
140 that is a branch means all revisions on that branch. A range
141 of branches means all revisions on the branches in that
142 range. A branch followed by a __.__ means the latest
143 revision in that branch. A bare __-r__ with no
144 ''revisions'' means the latest revision on the default
145 branch, normally the trunk.
146
147
148 __-s__''states''
149
150
151 prints information about revisions whose state attributes
152 match one of the states given in the comma-separated list
153 ''states''.
154
155
156 __-w__[[''logins'']
157
158
159 prints information about revisions checked in by users with
160 login names appearing in the comma-separated list
161 ''logins''. If ''logins'' is omitted, the user's login
162 is assumed.
163
164
165 __-T__
166
167
168 This option has no effect; it is present for compatibility
169 with other RCS commands.
170
171
172 __-V__
173
174
175 Print RCS 's version number.
176
177
178 __-V__''n''
179
180
181 Emulate RCS version ''n'' when generating
182 logs. See co(1) for more.
183
184
185 __-x__''suffixes''
186
187
188 Use ''suffixes'' to characterize RCS
189 files. See ci(1) for details.
190
191
192 __rlog__ prints the intersection of the revisions
193 selected with the options __-d__, __-l__, __-s__,
194 and __-w__, intersected with the union of the revisions
195 selected by __-b__ and __-r__.
196
197
198 __-z__''zone''
199
200
201 specifies the date output format, and specifies the default
202 time zone for ''date'' in the __-d__''dates''
203 option. The ''zone'' should be empty, a numeric
204 UTC offset, or the special string __LT__
205 for local time. The default is an empty ''zone'', which
206 uses the traditional RCS format of
207 UTC without any time zone indication and with
208 slashes separating the parts of the date; otherwise, times
209 are output in ISO 8601 format with time zone
210 indication. For example, if local time is January 11, 1990,
211 8pm Pacific Standard Time, eight hours west of
212 UTC , then the time is output as
213 follows:
214
215
216 ''option time output
217 ''__-z 1990/01/12 04:00:00__ '' (default)
218 ''__-zLT 1990-01-11 20:00:00-08
219 -z+05:30 1990-01-12 09:30:00+05:30
220 __
221 !!EXAMPLES
222
223
224 rlog -L -R RCS/*
225 rlog -L -h RCS/*
226 rlog -L -l RCS/*
227 rlog RCS/*
228 The first command prints the names of all RCS files in the subdirectory __RCS__ that have locks. The second command prints the headers of those files, and the third prints the headers plus the log messages of the locked revisions. The last command prints complete information.
229 !!ENVIRONMENT
230
231
232 __RCSINIT__
233
234
235 options prepended to the argument list, separated by spaces.
236 See ci(1) for details.
237 !!DIAGNOSTICS
238
239
240 The exit status is zero if and only if all operations were
241 successful.
242 !!IDENTIFICATION
243
244
245 Author: Walter F. Tichy.
246 Manual Page Revision: 5.9; Release Date: 1995/06/16.
247 Copyright 1982, 1988, 1989 Walter F. Tichy.
248 Copyright 1990, 1991, 1992, 1993, 1994, 1995 Paul
249 Eggert.
250 !!SEE ALSO
251
252
253 ci(1), co(1), ident(1), rcs(1), rcsdiff(1), rcsintro(1),
254 rcsmerge(1), rcsfile(5)
255 Walter F. Tichy, RCS --A System for Version
256 Control, ''Software--Practice ''
257 __15__, 7 (July 1985), 637-654.
258 !!BUGS
259
260
261 The separator for revision ranges in the __-r__ option
262 used to be __-__ instead of __:__, but this leads to
263 confusion when symbolic names contain __-__. For
264 backwards compatibility __rlog -r__ still supports the
265 old __-__ separator, but it warns about this obsolete
266 use.
267 ----
This page is a man page (or other imported legacy content). We are unable to automatically determine the license status of this page.