Return to rlog.1 CVS log

Up to [local] / src / usr.bin / rcs

Annotation of src/usr.bin/rcs/rlog.1, Revision 1.10

1.10    ! xsa         1: .\"     $OpenBSD: rlog.1,v 1.9 2005/11/30 08:53:29 xsa Exp $
1.1       xsa         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 October 12, 2005
                     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: .Bk -words
1.8       xsa        26: .Op Fl bhLNqRTtV
1.7       xsa        27: .Op Fl d Ns Ar dates
                     28: .Op Fl l Ns Op Ar lockers
                     29: .Op Fl s Ns Ar states
                     30: .Op Fl w Ns Op Ar logins
1.6       xsa        31: .Op Fl x Ns Ar suffixes
1.9       xsa        32: .Op Fl z Ns Ar tz
1.1       xsa        33: .Ar file ...
                     34: .Ek
                     35: .Sh DESCRIPTION
                     36: The
                     37: .Nm
                     38: program displays information about RCS files.
                     39: .Pp
                     40: The following options are supported:
                     41: .Bl -tag -width Ds
1.8       xsa        42: .It Fl b
                     43: Print information about revisions of the default branch only.
1.7       xsa        44: .It Fl d Ns Ar dates
                     45: Specify revisions with dates matching the specification.
                     46: The specification might be as follows:
                     47: .Bl -tag -width Ds
                     48: .It D1>D2 or D2>D1
                     49: Select all revisions between
                     50: .Ar \&D1
                     51: and
                     52: .Ar D2 .
                     53: .It <D or D>
                     54: Select all revisions before
                     55: .Ar D .
                     56: .It >D or D<
                     57: Select all revisions after
                     58: .Ar D .
                     59: .It D
                     60: Select the latest revision before or equal to
                     61: .Ar D .
                     62: .El
                     63: .Pp
                     64: The
                     65: .Sq \*(Gt
                     66: and
                     67: .Sq \*(Lt
                     68: characters can be followed by the
                     69: .Sq =
                     70: character to imply an inclusive specification.
                     71: Several specifications can be used by separating them with the
                     72: .Sq \&;
                     73: character.
1.1       xsa        74: .It Fl h
                     75: Print header.
1.4       xsa        76: .It Fl L
                     77: Ignore RCS files with no locks set.
1.7       xsa        78: .It Fl l Ns Op Ar lockers
                     79: Print information about locked revisions only.
                     80: If a comma-separated list of login names is specified,
                     81: ignore all locks other than those held in the list.
1.1       xsa        82: .It Fl N
                     83: Do not print symbolic names.
                     84: .It Fl q
                     85: Be quiet about reporting.
                     86: .It Fl R
                     87: Print name of RCS file only.
1.7       xsa        88: .It Fl s Ns Ar states
                     89: Print information about revisions whose state matches one of the
                     90: specified
                     91: .Ar states .
                     92: Multiple states may be specified as a comma-separated list.
1.3       xsa        93: .It Fl T
                     94: No effect.
                     95: For compatibility.
1.1       xsa        96: .It Fl t
                     97: Print header and description only.
                     98: .It Fl V
                     99: Print RCS's version number.
1.7       xsa       100: .It Fl w Ns Op Ar logins
                    101: Print information about revisions checked in by users specified
                    102: in a comma-separated list.
                    103: If
                    104: .Ar logins
                    105: is omitted, the user's login is assumed.
1.6       xsa       106: .It Fl x Ns Ar suffixes
                    107: Specifies the suffixes for RCS files.
                    108: Suffixes should be separated by the
                    109: .Sq /
                    110: character.
1.9       xsa       111: .It Fl z Ns Ar tz
1.10    ! xsa       112: Specify the date output format, and the default time zone for
1.9       xsa       113: .Ar dates
                    114: used in the
                    115: .Fl d
                    116: option.
1.1       xsa       117: .El
                    118: .Sh ENVIRONMENT
                    119: .Bl -tag -width RCSINIT
                    120: .It Ev RCSINIT
                    121: If set, this variable should contain a list of space-delimited options that
                    122: are prepended to the argument list.
                    123: .El
1.5       xsa       124: .Sh EXAMPLES
                    125: Print complete information about files:
                    126: .Pp
                    127: .Dl $ rlog RCS/*
                    128: .Pp
                    129: Print the names of RCS files with locks set:
                    130: .Pp
                    131: .Dl $ rlog -L -R RCS/*
1.1       xsa       132: .Sh SEE ALSO
                    133: .Xr ci 1 ,
                    134: .Xr co 1 ,
                    135: .Xr ident 1 ,
                    136: .Xr rcs 1 ,
                    137: .Xr rcsclean 1 ,
1.2       xsa       138: .Xr rcsdiff 1 ,
                    139: .Xr rcsmerge 1