Annotation of src/usr.bin/cvs/cvs.1, Revision 1.2
1.1 jfb 1: .\" $OpenBSD: pmdb.1,v 1.15 2003/08/02 17:40:51 mickey Exp $
2: .\"
3: .\" Copyright (c) 2004 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 CVS 1
28: .Os
29: .Sh NAME
30: .Nm cvs
31: .Nd OpenCVS Concurrent Versioning System client/server
32: .Sh SYNOPSIS
33: .Nm
34: .Op Fl flQqv
35: .Op Fl d Ar root
36: .Op Fl e Ar editor
37: .Ar command Op Ar ...
38: .Sh DESCRIPTION
39: The
40: .Nm
41: program acts as both client and server for the use of and administration of
42: a CVS source repository.
43: CVS is used to maintain version information on files that are kept in a
44: repository.
45: Although it is more commonly used to track changes in source code, there
46: are no real limitations to the type of files that you can store in a
47: repository.
48: .Pp
49: The following options are supported:
50: .Bl -tag -width Ds
51: .It Fl d Ar root
52: Use
53: .Ar root
54: as the path to the root directory of the CVS repository.
55: The value must specify an absolute path.
56: .It Fl e Ar editor
57: Use the program
58: .Ar editor
59: whenever editing log information.
60: This option overrides the environment variables CVSEDITOR, VISUAL and EDITOR.
61: .It Fl f
62: Do not read the contents of the user's .cvsrc file on startup.
63: .It Fl l
64: Suppress logging of history information.
65: .It Fl Q
66: Be extra quiet.
67: Only error messages will be displayed.
68: .It Fl q
69: Be quiet about reporting.
70: .It Fl v
71: Display version information and exit.
72: .El
73: .Sh COMMANDS
74: .Bl -tag -width Ds
75: .Ic add
76: .Ar file Op ...
77: Before a file is known to CVS, it must be added to the repository using
78: this command.
79: Adding a file does not actually publish the contents of the
80: file, so you must commit the first revision in order to let other users
81: see the file with the
82: .Ic update
83: command.
84: .Pp
85: .Ic commit
86: .Op Fl m Ar msg
87: The
88: .Ic commit
89: command is used to send local changes back to the server and update the
90: repository's information to reflect the changes.
91: .Pp
92: .Ic update
93: .Op Fl dP
94: .El
95: .Sh FILES
96: .Bl -tag -width Ds
97: .It Pa $HOME/.cvsrc
98: File containing a list of implicit options to pass to certain commands.
99: This file is read on startup unless the
100: .Fl f
101: option is specified.
102: .It Pa $CVSROOT/CVSROOT
103: Directory containing repository administrative files.
104: .It Pa $CVSROOT/CVSROOT/loginfo
105: File containing associations between modules and handlers for
106: post-commit logging.
107: .El
108: .Sh ENVIRONMENT
109: .Bl -tag -width CVS_CLIENT_LOG
110: .It Ev CVSROOT
111: When set, this variable should contain the string pointing to the root
112: directory of the CVS repository.
113: The contents of this variable are ignored when the
114: .Fl d
115: option is given or if `Root' files exist in the checked-out copy.
116: .It Ev CVS_RSH
117: Name of the program to use when connecting to the server through a remote
118: shell.
119: The default is to use the
120: .Xr ssh 1
121: program.
122: .It Ev CVS_SERVER
123: If set, gives the name of the program to invoke as a
124: .Nm
125: server when using remote shell.
126: The default is to use `cvs'.
127: .It Ev CVSEDITOR
128: Name of the editor to use when editing commit messages.
129: Checked before EDITOR and VISUAL.
130: .It Ev EDITOR
131: .It Ev VISUAL
132: .It Ev CVS_CLIENT_LOG
133: This variable enables logging of all communications between the client and
134: server when running in non-local mode.
135: If set, this environment variable must contain a base path from which two
136: paths will be generated by appending ".in" to the value for the server's
137: input and ".out" for the server's output.
138: .El
139: .Sh SEE ALSO
140: .Xr rcs 1 ,
141: .Xr diff 1 ,
142: .Xr patch 1 ,
143: .Xr cvsd 8
1.2 ! jfb 144: .Sh CAVEATS
! 145: This CVS implementation does not fully conform to the GNU CVS version.
! 146: In many cases, this was done explicitly because GNU CVS has inconsistencies
! 147: or ambiguous behaviour.
1.1 jfb 148: .Sh HISTORY
149: The OpenCVS project is a BSD-licensed rewrite of the original
150: Concurrent Versioning System written by Jean-Francois Brousseau.
151: The original CVS code was written in large parts by Dick Grune,
152: Brian Berliner and Jeff Polk.
1.2 ! jfb 153: .Sh AUTHORS
! 154: .An Jean-Francois Brousseau
! 155: .An Vincent Labrecque