Return to rlog.1 CVS log

Up to [CSRG BSD Unix] / 43BSDTahoe / new / rcs / man

Annotation of 43BSDTahoe/new/rcs/man/rlog.1, revision 1.1

1.1     ! root        1: .TH RLOG 1L "" "Purdue University"
        !             2: .SH NAME
        !             3: rlog \- print log messages and other information about RCS files
        !             4: .SH SYNOPSIS
        !             5: .B rlog
        !             6: [ options ]
        !             7: file ...
        !             8: .SH DESCRIPTION
        !             9: .I Rlog
        !            10: prints information about RCS files.
        !            11: Files ending in `,v' are RCS files, all others are working files. If
        !            12: a working file is given, \fIrlog\fR tries to find the corresponding
        !            13: RCS file first in directory ./RCS and then in the current directory,
        !            14: as explained in
        !            15: .IR co (1L).
        !            16: .PP
        !            17: \fIRlog\fR prints the following information for each
        !            18: RCS file: RCS file name, working file name, head (i.e., the number
        !            19: of the latest revision on the trunk), default branch, access list, locks,
        !            20: symbolic names, suffix, total number of revisions, 
        !            21: number of revisions selected for printing, and 
        !            22: descriptive text. This is followed by entries for the selected revisions in
        !            23: reverse chronological order for each branch. For each revision,
        !            24: \fIrlog\fR prints revision number, author, date/time, state, number of
        !            25: lines added/deleted (with respect to the previous revision),
        !            26: locker of the revision (if any), and log message.
        !            27: Without options, \fIrlog\fR prints complete information.
        !            28: The options below restrict this output.
        !            29: .TP 10
        !            30: .B \-L
        !            31: ignores RCS files that have no locks set; convenient in combination with
        !            32: \fB\-R\fR, \fB\-h\fR, or \fB\-l\fR.
        !            33: .TP 10
        !            34: .B \-R
        !            35: only prints the name of the RCS file; convenient for translating a
        !            36: working file name into an RCS file name.
        !            37: .TP 10
        !            38: .B \-h
        !            39: prints only RCS file name, working file name, head, 
        !            40: default branch, access list, locks,
        !            41: symbolic names, and suffix.
        !            42: .TP 10
        !            43: .B \-t
        !            44: prints the same as \fB\-h\fR, plus the descriptive text.
        !            45: .TP 10
        !            46: .B \-b
        !            47: prints information about the revisions on the default branch (normally
        !            48: the highest branch on the trunk).
        !            49: .TP 10
        !            50: .BI \-d "dates"
        !            51: prints information about revisions with a checkin date/time in the ranges given by
        !            52: the semicolon-separated list of \fIdates\fR.
        !            53: A range of the form \fId1<d2\fR or \fId2>d1\fR
        !            54: selects the revisions that were deposited between
        !            55: \fId1\fR and \fId2\fR, (inclusive).
        !            56: A range of the form \fI<d\fR or \fId>\fR selects
        !            57: all revisions dated
        !            58: \fId\fR or earlier.
        !            59: A range of the form \fId<\fR or \fI>d\fR selects
        !            60: all revisions dated \fId\fR or later.
        !            61: A range of the form \fId\fR selects the single, latest revision dated \fId\fR or
        !            62: earlier.
        !            63: The date/time strings \fId, d1, \fRand \fId2\fR
        !            64: are in the free format explained in
        !            65: .IR co (1L). 
        !            66: Quoting is normally necessary, especially for \fI<\fR and \fI>\fR. Note that the separator is
        !            67: a semicolon.
        !            68: .TP 10
        !            69: .B \-l\fR[\fIlockers\fR]
        !            70: prints information about locked revisions.
        !            71: If the comma-separated list \fIlockers\fR of login names is given,
        !            72: only the revisions locked by the given login names are printed.
        !            73: If the list is omitted, all locked revisions are printed.
        !            74: .TP 10
        !            75: .BI \-r "revisions"
        !            76: prints information about revisions given in the comma-separated list
        !            77: \fIrevisions\fR of revisions and ranges. A range \fIrev1-rev2\fR means revisions
        !            78: \fIrev1\fR to \fIrev2\fR on the same branch, \fI-rev\fR means revisions
        !            79: from the beginning of the branch up to and including \fIrev\fR,
        !            80: and \fIrev-\fR means revisions starting with \fIrev\fR to the end of the
        !            81: branch containing \fIrev\fR. An argument that is a branch means all
        !            82: revisions on that branch. A range of branches means all revisions
        !            83: on the branches in that range.
        !            84: .TP 10
        !            85: .BI \-s "states"
        !            86: prints information about revisions whose state attributes match one of the
        !            87: states given in the comma-separated list \fIstates\fR.
        !            88: .TP 10
        !            89: .B \-w\fR[\fIlogins\fR]
        !            90: prints information about revisions checked in by users with 
        !            91: login names appearing in the comma-separated list \fIlogins\fR.
        !            92: If \fIlogins\fR is omitted, the user's login is assumed.
        !            93: .PP
        !            94: \fIRlog\fR prints the intersection of the revisions selected with
        !            95: the options \fB\-d\fR, \fB\-l\fR, \fB\-s\fR, \fB\-w\fR, intersected
        !            96: with the union of the revisions selected by \fB\-b\fR and \fB\-r\fR.
        !            97: .SH EXAMPLES
        !            98: .nf
        !            99: .sp
        !           100:         rlog  \-L  \-R  RCS/*,v
        !           101:         rlog  \-L  \-h  RCS/*,v
        !           102:         rlog  \-L  \-l  RCS/*,v
        !           103:         rlog  RCS/*,v
        !           104: .sp
        !           105: .fi
        !           106: The first command prints the names of all RCS files in the subdirectory `RCS'
        !           107: which have locks. The second command prints the headers of those files,
        !           108: and the third prints the headers plus the log messages of the locked revisions.
        !           109: The last command prints complete information.
        !           110: .SH DIAGNOSTICS
        !           111: The exit status always refers to the last RCS file operated upon,
        !           112: and is 0 if the operation was successful, 1 otherwise.
        !           113: .SH IDENTIFICATION
        !           114: .de VL
        !           115: \\$2
        !           116: ..
        !           117: Author: Walter F. Tichy,
        !           118: Purdue University, West Lafayette, IN, 47907.
        !           119: .sp 0
        !           120: Revision Number:
        !           121: .VL $Revision: 1.2 $
        !           122: ; Release Date:
        !           123: .VL $Date: 87/03/17 10:22:45 $
        !           124: \&.
        !           125: .sp 0
        !           126: Copyright \(co 1982 by Walter F. Tichy.
        !           127: .SH SEE ALSO
        !           128: ci(1L), co(1L), ident(1L), rcs(1L), rcsdiff(1L), rcsintro(1L), rcsmerge(1L),
        !           129: rcsfile(5L)
        !           130: .br
        !           131: Walter F. Tichy, "Design, Implementation, and Evaluation of a Revision Control
        !           132: System," in \fIProceedings of the 6th International Conference on Software
        !           133: Engineering\fR, IEEE, Tokyo, Sept. 1982.

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.