Annotation of src/usr.bin/rcs/rcs.1, Revision 1.1
1.1 ! deraadt 1: .\" $OpenBSD: rcs.1,v 1.2 2005/03/05 22:58:46 jmc Exp $
! 2: .\"
! 3: .\" Copyright (c) 2005 Jean-Francois Brousseau <jfb@openbsd.org>
! 4: .\" All rights reserved.
! 5: .\"
! 6: .\" Redistribution and use in source and binary forms, with or without
! 7: .\" modification, are permitted provided that the following conditions
! 8: .\" are met:
! 9: .\"
! 10: .\" 1. Redistributions of source code must retain the above copyright
! 11: .\" notice, this list of conditions and the following disclaimer.
! 12: .\" 2. The name of the author may not be used to endorse or promote products
! 13: .\" derived from this software without specific prior written permission.
! 14: .\"
! 15: .\" THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES,
! 16: .\" INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY
! 17: .\" AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL
! 18: .\" THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
! 19: .\" EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
! 20: .\" PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS;
! 21: .\" OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
! 22: .\" WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
! 23: .\" OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF
! 24: .\" ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
! 25: .\"
! 26: .Dd May 16, 2004
! 27: .Dt RCS 1
! 28: .Os
! 29: .Sh NAME
! 30: .Nm rcs
! 31: .Nd RCS file management program
! 32: .Sh SYNOPSIS
! 33: .Nm
! 34: .Op Fl hiLMUV
! 35: .Op Fl a Ar users
! 36: .Op Fl b Op Ar rev
! 37: .Op Fl e Op Ar users
! 38: .Ar file Op Ar ...
! 39: .Sh DESCRIPTION
! 40: The
! 41: .Nm
! 42: program is used to create RCS files or manipulate the contents of existing
! 43: files.
! 44: .Pp
! 45: The following options are supported:
! 46: .Bl -tag -width "-e usersXX"
! 47: .It Fl a Ar users
! 48: Add the usernames specified in the comma-separated list
! 49: .Ar users
! 50: to the access list of the RCS files.
! 51: .It Fl e Op Ar users
! 52: Remove the usernames specified in the comma-separated list
! 53: .Ar users
! 54: from the access list of the RCS files.
! 55: If
! 56: .Ar users
! 57: is not specified, all users are removed from the access list.
! 58: .It Fl h
! 59: Display the program's usage and exit.
! 60: .It Fl i
! 61: Create the RCS files specified as arguments.
! 62: Files created this way contain no revision.
! 63: .It Fl L
! 64: Enable strict locking on the RCS files.
! 65: See
! 66: .Xr rcsfile 5
! 67: for more details on locking.
! 68: .It Fl M
! 69: Disable mail warnings when breaking a user's lock.
! 70: Normally,
! 71: .Nm
! 72: will send a mail to the lock owner when his lock is removed by a call
! 73: to
! 74: .Nm
! 75: .Fl u .
! 76: This option is currently ignored.
! 77: .It Fl U
! 78: Disable strict locking on the RCS files.
! 79: See
! 80: .Xr rcsfile 5
! 81: for more details on locking.
! 82: .It Fl V
! 83: Print the program's version string and exit.
! 84: .El
! 85: .Sh ENVIRONMENT
! 86: .Bl -tag -width RCSINIT
! 87: .It Ev RCSINIT
! 88: If set, this variable should contain a list of space-delimited options that
! 89: are prepended to the argument list.
! 90: .El
! 91: .Sh SEE ALSO
! 92: .Xr ci 1 ,
! 93: .Xr co 1 ,
! 94: .Xr rcsclean 1 ,
! 95: .Xr rcsdiff 1 ,
! 96: .Xr rcsfile 5