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