1.\" $OpenBSD: rlog.1,v 1.23 2007/09/09 17:18:53 ray Exp $ 2.\" 3.\" Copyright (c) 2005 Xavier Santolaria <xsa@openbsd.org> 4.\" All rights reserved. 5.\" 6.\" Permission to use, copy, modify, and distribute this software for any 7.\" purpose with or without fee is hereby granted, provided that the above 8.\" copyright notice and this permission notice appear in all copies. 9.\" 10.\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES 11.\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF 12.\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR 13.\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES 14.\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN 15.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF 16.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. 17.Dd $Mdocdate: September 9 2007 $ 18.Dt RLOG 1 19.Os 20.Sh NAME 21.Nm rlog 22.Nd display information about RCS files 23.Sh SYNOPSIS 24.Nm 25.Op Fl bhLNRtV 26.Op Fl d Ns Ar dates 27.Op Fl l Ns Op Ar lockers 28.Op Fl r Ns Op Ar revs 29.Op Fl s Ns Ar states 30.Op Fl w Ns Op Ar logins 31.Op Fl x Ns Ar suffixes 32.Op Fl z Ns Ar tz 33.Ar 34.Sh DESCRIPTION 35The 36.Nm 37program displays information about RCS files. 38.Pp 39A file's complete RCS history can be displayed 40(the default if no options are specified) 41or a subset of its history log can be requested, 42depending on which options are specified. 43RCS keywords are displayed using the 44.Xr ident 1 45utility. 46.Pp 47The following options are supported: 48.Bl -tag -width Ds 49.It Fl b 50Print information about revisions of the default branch only. 51.It Fl d Ns Ar dates 52Specify revisions with dates matching the specification. 53The specification might be as follows: 54.Bl -tag -width Ds 55.It date1<date2 or date2>date1 56Select all revisions between 57.Ar date1 58and 59.Ar date2 . 60.It <date or date> 61Select all revisions before 62.Ar date . 63.It >date or date< 64Select all revisions after 65.Ar date . 66.It date 67Select the latest revision before or equal to 68.Ar date . 69.El 70.Pp 71The 72.Sq \*(Gt 73and 74.Sq \*(Lt 75characters can be followed by the 76.Sq = 77character to imply an inclusive specification. 78Several specifications can be used by separating them with the 79.Sq \&; 80character. 81.Pp 82See also the 83.Fl z 84option, below. 85.It Fl h 86Print the RCS header, 87describing a file's branch, lock details, symbolic names, etc. 88.It Fl L 89Ignore RCS files with no locks set. 90.It Fl l Ns Op Ar lockers 91Print information about locked revisions only. 92If a comma-separated list of login names is specified, 93ignore all locks other than those held in the list. 94.It Fl N 95Do not print symbolic names. 96.It Fl R 97Print name of RCS file only. 98.It Fl r Ns Op Ar revs 99Specify revision(s) to list: 100.Bl -tag -width Ds 101.It rev1,rev2,... 102A list of revisions is specified by separating names or numbers 103of revisions by the 104.Sq \&, 105character. 106.It rev1:rev2 107List all revisions between 108.Ar rev1 109and 110.Ar rev2 111(they must be on the same branch). 112.It :rev 113List all revisions since the beginning of the branch until 114.Ar rev 115included. 116.It rev: 117List all revisions of the branch beginning with 118.Ar rev . 119.It branch 120List all revisions of a branch. 121.It branch. 122List the latest revision of the branch 123.Ar branch . 124.It branch1:branch2 125List all revisions of branches between 126.Ar branch1 127and 128.Ar branch2 . 129.El 130.Pp 131Without argument, the 132.Fl r 133option means the latest revision of the default branch. 134.It Fl s Ns Ar states 135Print information about revisions whose state matches one of the 136specified 137.Ar states . 138Multiple states may be specified as a comma-separated list. 139.It Fl t 140Print header and description only. 141.It Fl V 142Print RCS's version number. 143.It Fl w Ns Op Ar logins 144Print information about revisions checked in by users specified 145in a comma-separated list. 146If 147.Ar logins 148is omitted, the user's login is assumed. 149.It Fl x Ns Ar suffixes 150Specifies the suffixes for RCS files. 151Suffixes should be separated by the 152.Sq / 153character. 154.It Fl z Ns Ar tz 155Specify the date output format. 156The 157.Ar tz 158argument should be a numeric UTC offset 159(e.g. +02:45 would specify an offset of 2 hours 45 minutes). 160.Sq LT 161may instead be used to specify local time. 162If no argument is given, a default format is used. 163This option is also used to set the default time zone for 164dates used in the 165.Fl d 166option. 167.El 168.Pp 169.Ex -std rlog 170.Sh ENVIRONMENT 171.Bl -tag -width RCSINIT 172.It Ev RCSINIT 173If set, this variable should contain a list of space-delimited options that 174are prepended to the argument list. 175.El 176.Sh EXAMPLES 177Print complete information about files: 178.Pp 179.Dl $ rlog RCS/* 180.Pp 181Print the names of RCS files with locks set: 182.Pp 183.Dl $ rlog -L -R RCS/* 184.Sh SEE ALSO 185.Xr ci 1 , 186.Xr co 1 , 187.Xr ident 1 , 188.Xr rcs 1 , 189.Xr rcsclean 1 , 190.Xr rcsdiff 1 , 191.Xr rcsmerge 1 192.Sh STANDARDS 193The flags 194.Op Fl qT 195have no effect and are provided 196for compatibility only. 197