diff options
Diffstat (limited to 'gnu/usr.bin/rcs/rlog/rlog.1')
-rw-r--r-- | gnu/usr.bin/rcs/rlog/rlog.1 | 318 |
1 files changed, 0 insertions, 318 deletions
diff --git a/gnu/usr.bin/rcs/rlog/rlog.1 b/gnu/usr.bin/rcs/rlog/rlog.1 deleted file mode 100644 index 26bf08a..0000000 --- a/gnu/usr.bin/rcs/rlog/rlog.1 +++ /dev/null @@ -1,318 +0,0 @@ -.de Id -.ds Rv \\$3 -.ds Dt \\$4 -.. -.Id $FreeBSD$ -.ds i \&\s-1ISO\s0 -.ds r \&\s-1RCS\s0 -.ds u \&\s-1UTC\s0 -.if n .ds - \%-- -.if t .ds - \(em -.TH RLOG 1 \*(Dt GNU -.SH NAME -rlog \- print log messages and other information about RCS files -.SH SYNOPSIS -.B rlog -.RI [ " options " ] " file " .\|.\|. -.SH DESCRIPTION -.B rlog -prints information about \*r files. -.PP -Pathnames matching an \*r suffix denote \*r files; -all others denote working files. -Names are paired as explained in -.BR ci (1). -.PP -.B rlog -prints the following information for each -\*r file: \*r pathname, working pathname, head (i.e., the number -of the latest revision on the trunk), default branch, access list, locks, -symbolic names, suffix, total number of revisions, -number of revisions selected for printing, and -descriptive text. This is followed by entries for the selected revisions in -reverse chronological order for each branch. For each revision, -.B rlog -prints revision number, author, date/time, state, number of -lines added/deleted (with respect to the previous revision), -locker of the revision (if any), and log message. -All times are displayed in Coordinated Universal Time (\*u) by default; -this can be overridden with -.BR \-z . -Without options, -.B rlog -prints complete information. -The options below restrict this output. -.nr n \w'\f3\-V\fP\f2n\fP'+2n-1/1n -.ds n \nn -.if \n(.g .if r an-tag-sep .ds n \w'\f3\-V\fP\f2n\fP'u+\n[an-tag-sep]u -.TP \*n -.B \-L -Ignore \*r files that have no locks set. -This is convenient in combination with -.BR \-h , -.BR \-l , -and -.BR \-R . -.TP -.B \-R -Print only the name of the \*r file. -This is convenient for translating a -working pathname into an \*r pathname. -.TP -.BI \-v "[string]" -Print only the working pathname and tip-revision. -The optional string is prepended to the outputline. -.TP -.B \-h -Print only the \*r pathname, working pathname, head, -default branch, access list, locks, -symbolic names, and suffix. -.TP -.B \-t -Print the same as -.BR \-h , -plus the descriptive text. -.TP -.B \-N -Do not print the symbolic names. -.TP -.B \-b -Print information about the revisions on the default branch, normally -the highest branch on the trunk. -.TP -.BI \-d "dates" -Print information about revisions with a checkin date/time in the ranges given by -the semicolon-separated list of -.IR dates . -A range of the form -.IB d1 < d2 -or -.IB d2 > d1 -selects the revisions that were deposited between -.I d1 -and -.I d2 -exclusive. -A range of the form -.BI < d -or -.IB d > -selects -all revisions earlier than -.IR d . -A range of the form -.IB d < -or -.BI > d -selects -all revisions dated later than -.IR d . -If -.B < -or -.B > -is followed by -.B = -then the ranges are inclusive, not exclusive. -A range of the form -.I d -selects the single, latest revision dated -.I d -or earlier. -The date/time strings -.IR d , -.IR d1 , -and -.I d2 -are in the free format explained in -.BR co (1). -Quoting is normally necessary, especially for -.B < -and -.BR > . -Note that the separator is -a semicolon. -.TP -.BR \-l [\f2lockers\fP] -Print information about locked revisions only. -In addition, if the comma-separated list -.I lockers -of login names is given, -ignore all locks other than those held by the -.IR lockers . -For example, -.B "rlog\ \-L\ \-R\ \-lwft\ RCS/*" -prints the name of \*r files locked by the user -.BR wft . -.TP -.BR \-r [\f2revisions\fP] -prints information about revisions given in the comma-separated list -.I revisions -of revisions and ranges. -A range -.IB rev1 : rev2 -means revisions -.I rev1 -to -.I rev2 -on the same branch, -.BI : rev -means revisions from the beginning of the branch up to and including -.IR rev , -and -.IB rev : -means revisions starting with -.I rev -to the end of the branch containing -.IR rev . -An argument that is a branch means all -revisions on that branch. -A range of branches means all revisions -on the branches in that range. -A branch followed by a -.B .\& -means the latest revision in that branch. -A bare -.B \-r -with no -.I revisions -means the latest revision on the default branch, normally the trunk. -.TP -.BI \-s states -prints information about revisions whose state attributes match one of the -states given in the comma-separated list -.IR states . -.TP -.BR \-w [\f2logins\fP] -prints information about revisions checked in by users with -login names appearing in the comma-separated list -.IR logins . -If -.I logins -is omitted, the user's login is assumed. -.TP -.B \-T -This option has no effect; -it is present for compatibility with other \*r commands. -.TP -.BI \-V -Print \*r's version number. -.TP -.BI \-V n -Emulate \*r version -.I n -when generating logs. -See -.BR co (1) -for more. -.TP -.BI \-x "suffixes" -Use -.I suffixes -to characterize \*r files. -See -.BR ci (1) -for details. -.PP -.B rlog -prints the intersection of the revisions selected with -the options -.BR \-d , -.BR \-l , -.BR \-s , -and -.BR \-w , -intersected -with the union of the revisions selected by -.B \-b -and -.BR \-r . -.TP -.BI \-z zone -specifies the date output format, -and specifies the default time zone for -.I date -in the -.BI \-d dates -option. -The -.I zone -should be empty, a numeric \*u offset, or the special string -.B LT -for local time. -The default is an empty -.IR zone , -which uses the traditional \*r format of \*u without any time zone indication -and with slashes separating the parts of the date; -otherwise, times are output in \*i 8601 format with time zone indication. -For example, if local time is January 11, 1990, 8pm Pacific Standard Time, -eight hours west of \*u, -then the time is output as follows: -.RS -.LP -.RS -.nf -.ta \w'\f3\-z+05:30\fP 'u +\w'\f31990-01-11 09:30:00+05:30\fP 'u -.ne 4 -\f2option\fP \f2time output\fP -\f3\-z\fP \f31990/01/12 04:00:00\fP \f2(default)\fP -\f3\-zLT\fP \f31990-01-11 20:00:00\-08\fP -\f3\-z+05:30\fP \f31990-01-12 09:30:00+05:30\fP -.ta 4n +4n +4n +4n -.fi -.RE -.SH EXAMPLES -.LP -.nf -.B " rlog \-L \-R RCS/*" -.B " rlog \-L \-h RCS/*" -.B " rlog \-L \-l RCS/*" -.B " rlog RCS/*" -.fi -.LP -The first command prints the names of all \*r files in the subdirectory -.B 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. -.SH ENVIRONMENT -.TP -.B \s-1RCSINIT\s0 -options prepended to the argument list, separated by spaces. -See -.BR ci (1) -for details. -.SH DIAGNOSTICS -The exit status is zero if and only if all operations were successful. -.SH IDENTIFICATION -Author: Walter F. Tichy. -.br -Manual Page Revision: \*(Rv; Release Date: \*(Dt. -.br -Copyright \(co 1982, 1988, 1989 Walter F. Tichy. -.br -Copyright \(co 1990, 1991, 1992, 1993, 1994, 1995 Paul Eggert. -.SH "SEE ALSO" -ci(1), co(1), ident(1), rcs(1), rcsdiff(1), rcsintro(1), rcsmerge(1), -rcsfile(5) -.br -Walter F. Tichy, -\*r\*-A System for Version Control, -.I "Software\*-Practice & Experience" -.BR 15 , -7 (July 1985), 637-654. -.SH BUGS -The separator for revision ranges in the -.B \-r -option used to be -.B \- -instead of -.BR : , -but this leads to confusion when symbolic names contain -.BR \- . -For backwards compatibility -.B "rlog \-r" -still supports the old -.B \- -separator, but it warns about this obsolete use. -.br |