Return to rlog.1 CVS log

Up to [CSRG BSD Unix] / 43BSD / contrib / rcs / man

Annotation of 43BSD/contrib/rcs/man/rlog.1, revision 1.1

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

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