usr.bin/rcs/man/rlog.1

   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.1 $
 122 ; Release Date:
 123 .VL $Date: 1993/03/21 09:58:05 $
 124 \&.
 125 .sp 0
 126 Copyright \(co 1982, 1988, 1989 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.