19Sjkh.de Id 29Sjkh.ds Rv \\$3 39Sjkh.ds Dt \\$4 49Sjkh.. 550472Speter.Id $FreeBSD: releng/10.3/gnu/usr.bin/rcs/rlog/rlog.1 50472 1999-08-27 23:37:10Z peter $ 611894Speter.ds i \&\s-1ISO\s0 79Sjkh.ds r \&\s-1RCS\s0 811894Speter.ds u \&\s-1UTC\s0 99Sjkh.if n .ds - \%-- 109Sjkh.if t .ds - \(em 119Sjkh.TH RLOG 1 \*(Dt GNU 129Sjkh.SH NAME 139Sjkhrlog \- print log messages and other information about RCS files 149Sjkh.SH SYNOPSIS 159Sjkh.B rlog 169Sjkh.RI [ " options " ] " file " .\|.\|. 179Sjkh.SH DESCRIPTION 189Sjkh.B rlog 199Sjkhprints information about \*r files. 209Sjkh.PP 219SjkhPathnames matching an \*r suffix denote \*r files; 229Sjkhall others denote working files. 239SjkhNames are paired as explained in 249Sjkh.BR ci (1). 259Sjkh.PP 269Sjkh.B rlog 279Sjkhprints the following information for each 289Sjkh\*r file: \*r pathname, working pathname, head (i.e., the number 299Sjkhof the latest revision on the trunk), default branch, access list, locks, 309Sjkhsymbolic names, suffix, total number of revisions, 319Sjkhnumber of revisions selected for printing, and 329Sjkhdescriptive text. This is followed by entries for the selected revisions in 339Sjkhreverse chronological order for each branch. For each revision, 349Sjkh.B rlog 359Sjkhprints revision number, author, date/time, state, number of 369Sjkhlines added/deleted (with respect to the previous revision), 379Sjkhlocker of the revision (if any), and log message. 3811894SpeterAll times are displayed in Coordinated Universal Time (\*u) by default; 3911894Speterthis can be overridden with 4011894Speter.BR \-z . 419SjkhWithout options, 429Sjkh.B rlog 439Sjkhprints complete information. 449SjkhThe options below restrict this output. 4511894Speter.nr n \w'\f3\-V\fP\f2n\fP'+2n-1/1n 4611894Speter.ds n \nn 4711894Speter.if \n(.g .if r an-tag-sep .ds n \w'\f3\-V\fP\f2n\fP'u+\n[an-tag-sep]u 4811894Speter.TP \*n 499Sjkh.B \-L 509SjkhIgnore \*r files that have no locks set. 519SjkhThis is convenient in combination with 529Sjkh.BR \-h , 539Sjkh.BR \-l , 549Sjkhand 559Sjkh.BR \-R . 569Sjkh.TP 579Sjkh.B \-R 589SjkhPrint only the name of the \*r file. 599SjkhThis is convenient for translating a 609Sjkhworking pathname into an \*r pathname. 619Sjkh.TP 6221810Sjdp.BI \-v "[string]" 6321810SjdpPrint only the working pathname and tip-revision. 6421810SjdpThe optional string is prepended to the outputline. 6521810Sjdp.TP 669Sjkh.B \-h 679SjkhPrint only the \*r pathname, working pathname, head, 689Sjkhdefault branch, access list, locks, 699Sjkhsymbolic names, and suffix. 709Sjkh.TP 719Sjkh.B \-t 729SjkhPrint the same as 739Sjkh.BR \-h , 749Sjkhplus the descriptive text. 759Sjkh.TP 7611894Speter.B \-N 7711894SpeterDo not print the symbolic names. 7811894Speter.TP 799Sjkh.B \-b 809SjkhPrint information about the revisions on the default branch, normally 819Sjkhthe highest branch on the trunk. 829Sjkh.TP 839Sjkh.BI \-d "dates" 849SjkhPrint information about revisions with a checkin date/time in the ranges given by 859Sjkhthe semicolon-separated list of 869Sjkh.IR dates . 879SjkhA range of the form 889Sjkh.IB d1 < d2 899Sjkhor 909Sjkh.IB d2 > d1 919Sjkhselects the revisions that were deposited between 929Sjkh.I d1 939Sjkhand 949Sjkh.I d2 9511894Speterexclusive. 969SjkhA range of the form 979Sjkh.BI < d 989Sjkhor 999Sjkh.IB d > 1009Sjkhselects 10111894Speterall revisions earlier than 10211894Speter.IR d . 1039SjkhA range of the form 1049Sjkh.IB d < 1059Sjkhor 1069Sjkh.BI > d 1079Sjkhselects 10811894Speterall revisions dated later than 10911894Speter.IR d . 11011894SpeterIf 11111894Speter.B < 11211894Speteror 11311894Speter.B > 11411894Speteris followed by 11511894Speter.B = 11611894Speterthen the ranges are inclusive, not exclusive. 1179SjkhA range of the form 1189Sjkh.I d 1199Sjkhselects the single, latest revision dated 1209Sjkh.I d 1219Sjkhor earlier. 1229SjkhThe date/time strings 1239Sjkh.IR d , 1249Sjkh.IR d1 , 1259Sjkhand 1269Sjkh.I d2 1279Sjkhare in the free format explained in 1289Sjkh.BR co (1). 1299SjkhQuoting is normally necessary, especially for 1309Sjkh.B < 1319Sjkhand 1329Sjkh.BR > . 1339SjkhNote that the separator is 1349Sjkha semicolon. 1359Sjkh.TP 1369Sjkh.BR \-l [\f2lockers\fP] 1379SjkhPrint information about locked revisions only. 1389SjkhIn addition, if the comma-separated list 1399Sjkh.I lockers 1409Sjkhof login names is given, 1419Sjkhignore all locks other than those held by the 1429Sjkh.IR lockers . 1439SjkhFor example, 1449Sjkh.B "rlog\ \-L\ \-R\ \-lwft\ RCS/*" 1459Sjkhprints the name of \*r files locked by the user 1469Sjkh.BR wft . 1479Sjkh.TP 1489Sjkh.BR \-r [\f2revisions\fP] 1499Sjkhprints information about revisions given in the comma-separated list 1509Sjkh.I revisions 1519Sjkhof revisions and ranges. 1529SjkhA range 1539Sjkh.IB rev1 : rev2 1549Sjkhmeans revisions 1559Sjkh.I rev1 1569Sjkhto 1579Sjkh.I rev2 1589Sjkhon the same branch, 1599Sjkh.BI : rev 1609Sjkhmeans revisions from the beginning of the branch up to and including 1619Sjkh.IR rev , 1629Sjkhand 1639Sjkh.IB rev : 1649Sjkhmeans revisions starting with 1659Sjkh.I rev 1669Sjkhto the end of the branch containing 1679Sjkh.IR rev . 1689SjkhAn argument that is a branch means all 1699Sjkhrevisions on that branch. 1709SjkhA range of branches means all revisions 1719Sjkhon the branches in that range. 1729SjkhA branch followed by a 1739Sjkh.B .\& 1749Sjkhmeans the latest revision in that branch. 1759SjkhA bare 1769Sjkh.B \-r 1779Sjkhwith no 1789Sjkh.I revisions 1799Sjkhmeans the latest revision on the default branch, normally the trunk. 1809Sjkh.TP 1819Sjkh.BI \-s states 1829Sjkhprints information about revisions whose state attributes match one of the 1839Sjkhstates given in the comma-separated list 1849Sjkh.IR states . 1859Sjkh.TP 1869Sjkh.BR \-w [\f2logins\fP] 1879Sjkhprints information about revisions checked in by users with 1889Sjkhlogin names appearing in the comma-separated list 1899Sjkh.IR logins . 1909SjkhIf 1919Sjkh.I logins 1929Sjkhis omitted, the user's login is assumed. 1939Sjkh.TP 19411894Speter.B \-T 19511894SpeterThis option has no effect; 19611894Speterit is present for compatibility with other \*r commands. 19711894Speter.TP 19811894Speter.BI \-V 19911894SpeterPrint \*r's version number. 20011894Speter.TP 2019Sjkh.BI \-V n 2029SjkhEmulate \*r version 2039Sjkh.I n 2049Sjkhwhen generating logs. 2059SjkhSee 2069Sjkh.BR co (1) 2079Sjkhfor more. 2089Sjkh.TP 2099Sjkh.BI \-x "suffixes" 2109SjkhUse 2119Sjkh.I suffixes 2129Sjkhto characterize \*r files. 2139SjkhSee 2149Sjkh.BR ci (1) 2159Sjkhfor details. 2169Sjkh.PP 2179Sjkh.B rlog 2189Sjkhprints the intersection of the revisions selected with 2199Sjkhthe options 2209Sjkh.BR \-d , 2219Sjkh.BR \-l , 2229Sjkh.BR \-s , 2239Sjkhand 2249Sjkh.BR \-w , 2259Sjkhintersected 2269Sjkhwith the union of the revisions selected by 2279Sjkh.B \-b 2289Sjkhand 2299Sjkh.BR \-r . 23011894Speter.TP 23111894Speter.BI \-z zone 23211894Speterspecifies the date output format, 23311894Speterand specifies the default time zone for 23411894Speter.I date 23511894Speterin the 23611894Speter.BI \-d dates 23711894Speteroption. 23811894SpeterThe 23911894Speter.I zone 24011894Spetershould be empty, a numeric \*u offset, or the special string 24111894Speter.B LT 24211894Speterfor local time. 24311894SpeterThe default is an empty 24411894Speter.IR zone , 24511894Speterwhich uses the traditional \*r format of \*u without any time zone indication 24611894Speterand with slashes separating the parts of the date; 24711894Speterotherwise, times are output in \*i 8601 format with time zone indication. 24811894SpeterFor example, if local time is January 11, 1990, 8pm Pacific Standard Time, 24911894Spetereight hours west of \*u, 25011894Speterthen the time is output as follows: 25111894Speter.RS 25211894Speter.LP 25311894Speter.RS 25411894Speter.nf 25511894Speter.ta \w'\f3\-z+05:30\fP 'u +\w'\f31990-01-11 09:30:00+05:30\fP 'u 25611894Speter.ne 4 25711894Speter\f2option\fP \f2time output\fP 25811894Speter\f3\-z\fP \f31990/01/12 04:00:00\fP \f2(default)\fP 25911894Speter\f3\-zLT\fP \f31990-01-11 20:00:00\-08\fP 26011894Speter\f3\-z+05:30\fP \f31990-01-12 09:30:00+05:30\fP 26111894Speter.ta 4n +4n +4n +4n 26211894Speter.fi 26311894Speter.RE 2649Sjkh.SH EXAMPLES 2659Sjkh.LP 2669Sjkh.nf 2679Sjkh.B " rlog \-L \-R RCS/*" 2689Sjkh.B " rlog \-L \-h RCS/*" 2699Sjkh.B " rlog \-L \-l RCS/*" 2709Sjkh.B " rlog RCS/*" 2719Sjkh.fi 2729Sjkh.LP 2739SjkhThe first command prints the names of all \*r files in the subdirectory 2749Sjkh.B RCS 2759Sjkhthat have locks. The second command prints the headers of those files, 2769Sjkhand the third prints the headers plus the log messages of the locked revisions. 2779SjkhThe last command prints complete information. 2789Sjkh.SH ENVIRONMENT 2799Sjkh.TP 2809Sjkh.B \s-1RCSINIT\s0 2819Sjkhoptions prepended to the argument list, separated by spaces. 2829SjkhSee 2839Sjkh.BR ci (1) 2849Sjkhfor details. 2859Sjkh.SH DIAGNOSTICS 2869SjkhThe exit status is zero if and only if all operations were successful. 2879Sjkh.SH IDENTIFICATION 2889SjkhAuthor: Walter F. Tichy. 2899Sjkh.br 29011894SpeterManual Page Revision: \*(Rv; Release Date: \*(Dt. 2919Sjkh.br 29211894SpeterCopyright \(co 1982, 1988, 1989 Walter F. Tichy. 2939Sjkh.br 29411894SpeterCopyright \(co 1990, 1991, 1992, 1993, 1994, 1995 Paul Eggert. 2959Sjkh.SH "SEE ALSO" 2969Sjkhci(1), co(1), ident(1), rcs(1), rcsdiff(1), rcsintro(1), rcsmerge(1), 2979Sjkhrcsfile(5) 2989Sjkh.br 2999SjkhWalter F. Tichy, 3009Sjkh\*r\*-A System for Version Control, 3019Sjkh.I "Software\*-Practice & Experience" 3029Sjkh.BR 15 , 3039Sjkh7 (July 1985), 637-654. 3049Sjkh.SH BUGS 3059SjkhThe separator for revision ranges in the 3069Sjkh.B \-r 3079Sjkhoption used to be 3089Sjkh.B \- 3099Sjkhinstead of 3109Sjkh.BR : , 3119Sjkhbut this leads to confusion when symbolic names contain 3129Sjkh.BR \- . 3139SjkhFor backwards compatibility 3149Sjkh.B "rlog \-r" 3159Sjkhstill supports the old 3169Sjkh.B \- 3179Sjkhseparator, but it warns about this obsolete use. 3189Sjkh.br 319