Annotation of src/usr.bin/rcs/rcs.1, Revision 1.4
1.4 ! joris 1: .\" $OpenBSD: rcs.1,v 1.3 2005/10/08 22:16:34 jmc Exp $
1.1 deraadt 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
1.4 ! joris 34: .Op Fl abehiLmMUV
1.1 deraadt 35: .Op Fl a Ar users
36: .Op Fl b Op Ar rev
37: .Op Fl e Op Ar users
1.4 ! joris 38: .Op Fl m Ar rev:log
1.1 deraadt 39: .Ar file Op Ar ...
40: .Sh DESCRIPTION
41: The
42: .Nm
43: program is used to create RCS files or manipulate the contents of existing
44: files.
45: .Pp
46: The following options are supported:
47: .Bl -tag -width "-e usersXX"
48: .It Fl a Ar users
49: Add the usernames specified in the comma-separated list
50: .Ar users
51: to the access list of the RCS files.
52: .It Fl e Op Ar users
53: Remove the usernames specified in the comma-separated list
54: .Ar users
55: from the access list of the RCS files.
56: If
57: .Ar users
58: is not specified, all users are removed from the access list.
1.4 ! joris 59: .It Fl m Ar rev:msg
! 60: Replace revision
! 61: .Ar rev
! 62: its log message with
! 63: .Ar msg .
1.1 deraadt 64: .It Fl h
65: Display the program's usage and exit.
66: .It Fl i
67: Create the RCS files specified as arguments.
68: Files created this way contain no revision.
69: .It Fl L
70: Enable strict locking on the RCS files.
71: See
72: .Xr rcsfile 5
73: for more details on locking.
74: .It Fl M
75: Disable mail warnings when breaking a user's lock.
76: Normally,
77: .Nm
78: will send a mail to the lock owner when his lock is removed by a call
79: to
80: .Nm
81: .Fl u .
82: This option is currently ignored.
83: .It Fl U
84: Disable strict locking on the RCS files.
85: See
86: .Xr rcsfile 5
87: for more details on locking.
88: .It Fl V
89: Print the program's version string and exit.
90: .El
91: .Sh ENVIRONMENT
92: .Bl -tag -width RCSINIT
93: .It Ev RCSINIT
94: If set, this variable should contain a list of space-delimited options that
95: are prepended to the argument list.
96: .El
97: .Sh SEE ALSO
98: .Xr ci 1 ,
99: .Xr co 1 ,
1.3 jmc 100: .Xr ident 1 ,
1.1 deraadt 101: .Xr rcsclean 1 ,
102: .Xr rcsdiff 1 ,
103: .Xr rcsfile 5