Blob


1 .TH CVS 1
2 .SH NAME
3 cvs \- introduction using plan9port CVS repository
4 .SH SYNOPSIS
5 .B cvs
6 .B -d
7 .B :pserver:anoncvs@cvs.pdos.lcs.mit.edu:/cvs login
8 .PP
9 .B cvs
10 .B -d
11 .B :pserver:anoncvs@cvs.pdos.lcs.mit.edu:/cvs checkout plan9
12 .PP
13 .B cvs
14 .B update
15 [
16 .B -dP
17 ]
18 [
19 .I path ...
20 ]
21 .PP
22 .B cvs
23 .B status
24 [
25 .I path ...
26 ]
27 .PP
28 .B cvs
29 .B diff
30 [
31 .B -D
32 .I date
33 ]
34 [
35 .B -r
36 .I revision
37 ]
38 [
39 .B -cu
40 ]
41 [
42 .I path ...
43 ]
44 .PP
45 .B web
46 .B http://cvs.pdos.lcs.mit.edu/cvs/plan9/
47 .SH DESCRIPTION
48 The master source tree for Plan 9 from User Space is maintained
49 using the source control system CVS
50 as a poor substitute for Plan 9's
51 \fIreplica\fR(8) and dump file system.
52 .PP
53 The first argument to
54 .I cvs
55 is a command, which determines the form of the rest of the command line.
56 .PP
57 The
58 .B login
59 command authenticates to the remote server and records your password in
60 .BR $HOME/.cvspass .
61 Use an empty password: when prompted, type a newline.
62 .PP
63 The
64 .B checkout
65 command downloads a copy of the tree into the directory
66 .BR plan9 ,
67 which it will create.
68 The argument
69 .B plan9
70 is both the name of the created directory and the name used to
71 tell the server which tree you want.
72 If you want to use a different name locally, rename the directory
73 after running the command.
74 .PP
75 From directories within the
76 .B plan9
77 tree, the awkward
78 .B -d
79 is no longer necessary.
80 .PP
81 .I Cvs
82 .I update
83 incorporates recent changes from the CVS tree
84 into the local copy.
85 If the changes cannot be merged because of locally-made changes
86 that are in the way,
87 .I cvs
88 will leave a note in the file showing the differences between the local
89 and remote file.
90 .PP
91 The
92 .B -d
93 flag to
94 .I cvs
95 .I update
96 causes
97 it to update subdirectories as well.
98 The
99 .B -P
100 flag causes
101 .I cvs
102 .I update
103 to remove directories that have been emptied.
104 .PP
105 .I Cvs
106 .I status
107 displays the version number (also called a revision number)
108 for the local copy of the named files,
109 as well as the number of the most recent version on the server.
110 Version numbers are of the form
111 .RI 1. n \fR,
112 where
113 .I n
114 is a sequence number starting at 1.
115 .PP
116 .I Cvs
117 .I diff
118 runs Unix's
119 .IR diff (1)
120 to compare files in the local tree with the corresponding files in
121 the CVS tree.
122 By default it compares against the version that was most recently
123 incorporated into the local tree.
124 The
125 .B -r
126 flag specifies an alternate version to compare against.
127 The special revision
128 .B HEAD
129 refers to the most recent version on the server.
130 The
131 .B -D
132 flag instructs
133 .I cvs
134 .I diff
135 to use the version as of the given date.
136 Almost any imaginable date format is acceptable:
137 .BR 20050110 ,
138 .BR 1/10/2005 ,
139 .B 'Jan
140 .BR 10' ,
141 .BR yesterday ,
142 .B 'last
143 .BR week ',
144 .B 'two
145 .B days
146 .BR ago' ,
147 .B 'a
148 .B fortnight
149 .BR ago' ,
150 and so on.
151 If two
152 .B -r
153 or
154 .B -D
155 options are given,
156 those two versions are compared, and the local copy is ignored.
157 .PP
158 .I Cvs
159 .I diff
160 passes the
161 .B -u
162 or
163 .B -c
164 options to the Unix
165 .IR diff .
166 .PP
167 If you download a tar file from the web
168 instead of checking out the tree with CVS,
169 you can still use the
170 .I update
171 and
172 .I diff
173 commands to stay up-to-date and to see what has changed.
174 You will need to run the
175 .I cvs
176 .I login
177 command first to create your
178 .B .cvspass
179 file.
180 .PP
181 The CVS tree can be inspected on the web at
182 .HR http://cvs.pdos.lcs.mit.edu/cvs/plan9/ "" .
183 .SH EXAMPLES
184 Incorporate any changes made to the CVS tree since
185 the last check out or update:
186 .IP
187 .EX
188 cd $PLAN9
189 cvs up -dP
190 .EE
191 .PP
192 Compare
193 .I libdraw
194 against its source from January 1, 2005:
195 .IP
196 .EX
197 cd $PLAN9/src/libdraw
198 cvs diff -D20050101
199 .EE
200 .PP
201 Check the entire tree for changes made locally:
202 .IP
203 .EX
204 cd $PLAN9
205 cvs diff
206 .EE
207 .PP
208 Check the entire tree for changes between the local version and
209 the most recent in the CVS tree.
210 This does not indicate which changes are local ones
211 and which are changes to the CVS tree that have not yet been
212 incorporated into the local tree.
213 .IP
214 .EX
215 cd $PLAN9
216 cvs diff -r HEAD
217 .EE
218 .SH FILES
219 .TP
220 .B CVS
221 directory containing CVS metadata for parent
222 .TP
223 .B .cvsignore
224 list of files and wildcards to exclude from CVS operations in this directory
225 .SH SEE ALSO
226 Unix's
227 \fIcvs\fR(1),
228 .HR http://www.cvshome.org/
229 .PP
230 .HR http://cvs.pdos.lcs.mit.edu/cvs/plan9/
231 .SH BUGS
232 The CVS server is a read-only public copy of a private tree.
233 The dates on versions reflect the date the changes were made in the
234 private tree, not the date the change was made public.
235 .PP
236 On Mac OS X,
237 .I cvs
238 will complain during a checkout that some files in
239 .B $PLAN9/troff/font/devutf
240 are ``in the way.''
241 This is due to the Mac case-insensitive file system
242 and the fact that troff has some (not often used)
243 files whose names differ only in case.