.\"	$OpenBSD: rlog.1,v 1.13 2006/03/06 14:47:20 jmc Exp $
.\"
.\" Copyright (c) 2005 Xavier Santolaria <xsa@openbsd.org>
.\" All rights reserved.
.\"
.\" Permission to use, copy, modify, and distribute this software for any
.\" purpose with or without fee is hereby granted, provided that the above
.\" copyright notice and this permission notice appear in all copies.
.\"
.\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
.\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
.\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
.\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
.\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
.Dd October 12, 2005
.Dt RLOG 1
.Os
.Sh NAME
.Nm rlog
.Nd display information about RCS files
.Sh SYNOPSIS
.Nm
.Bk -words
.Op Fl bhLNqRtV
.Op Fl d Ns Ar dates
.Op Fl l Ns Op Ar lockers
.Op Fl r Ns Op Ar revs
.Op Fl s Ns Ar states
.Op Fl w Ns Op Ar logins
.Op Fl x Ns Ar suffixes
.Op Fl z Ns Ar tz
.Ar file ...
.Ek
.Sh DESCRIPTION
The
.Nm
program displays information about RCS files.
.Pp
The following options are supported:
.Bl -tag -width Ds
.It Fl b
Print information about revisions of the default branch only.
.It Fl d Ns Ar dates
Specify revisions with dates matching the specification.
The specification might be as follows:
.Bl -tag -width Ds
.It D1>D2 or D2>D1
Select all revisions between
.Ar \&D1
and
.Ar D2 .
.It <D or D>
Select all revisions before
.Ar D .
.It >D or D<
Select all revisions after
.Ar D .
.It D
Select the latest revision before or equal to
.Ar D .
.El
.Pp
The
.Sq \*(Gt
and
.Sq \*(Lt
characters can be followed by the
.Sq =
character to imply an inclusive specification.
Several specifications can be used by separating them with the
.Sq \&;
character.
.It Fl h
Print header.
.It Fl L
Ignore RCS files with no locks set.
.It Fl l Ns Op Ar lockers
Print information about locked revisions only.
If a comma-separated list of login names is specified,
ignore all locks other than those held in the list.
.It Fl N
Do not print symbolic names.
.It Fl q
Be quiet about reporting.
.It Fl R
Print name of RCS file only.
.It Fl r Ns Op Ar revs
Specify revision(s) to list:
.Bl -tag -width Ds
.It REV1,REV2,...,
A list of revisions is specified by separating names or numbers
of revisions by the
.Sq \&,
character.
.It REV1:REV2
List all revisions between
.Ar REV1
and
.Ar REV2
(they must be on the same branch).
.It :REV
List all revisions since the beginning of the branch until
.Ar REV
included.
.It REV:
List all revisions of the branch beginning with
.Ar REV .
.It BRANCH
List all revisions of a branch.
.It BRANCH.
List the latest revision of the branch
.Ar BRANCH .
.It BRANCH1:BRANCH2
List all revisions of branches between
.Ar BRANCH1
and
.Ar BRANCH2 .
.El
.Pp
Without argument, the
.Fl r
option means the latest revision of the default branch.
.It Fl s Ns Ar states
Print information about revisions whose state matches one of the
specified
.Ar states .
Multiple states may be specified as a comma-separated list.
.It Fl t
Print header and description only.
.It Fl V
Print RCS's version number.
.It Fl w Ns Op Ar logins
Print information about revisions checked in by users specified
in a comma-separated list.
If
.Ar logins
is omitted, the user's login is assumed.
.It Fl x Ns Ar suffixes
Specifies the suffixes for RCS files.
Suffixes should be separated by the
.Sq /
character.
.It Fl z Ns Ar tz
Specify the date output format, and the default time zone for
.Ar dates
used in the
.Fl d
option.
.El
.Sh ENVIRONMENT
.Bl -tag -width RCSINIT
.It Ev RCSINIT
If set, this variable should contain a list of space-delimited options that
are prepended to the argument list.
.El
.Sh EXAMPLES
Print complete information about files:
.Pp
.Dl $ rlog RCS/*
.Pp
Print the names of RCS files with locks set:
.Pp
.Dl $ rlog -L -R RCS/*
.Sh SEE ALSO
.Xr ci 1 ,
.Xr co 1 ,
.Xr ident 1 ,
.Xr rcs 1 ,
.Xr rcsclean 1 ,
.Xr rcsdiff 1 ,
.Xr rcsmerge 1
.Sh STANDARDS
The flag
.Op Fl T
has no effect and is provided
for compatibility only.