3 67075c36 2005-01-14 devnull cvs \- introduction using plan9port CVS repository
4 67075c36 2005-01-14 devnull .SH SYNOPSIS
7 67075c36 2005-01-14 devnull .B :pserver:anoncvs@cvs.pdos.lcs.mit.edu:/cvs login
11 67075c36 2005-01-14 devnull .B :pserver:anoncvs@cvs.pdos.lcs.mit.edu:/cvs checkout plan9
14 67075c36 2005-01-14 devnull .B update
19 67075c36 2005-01-14 devnull .I path ...
23 67075c36 2005-01-14 devnull .B status
25 67075c36 2005-01-14 devnull .I path ...
36 67075c36 2005-01-14 devnull .I revision
42 67075c36 2005-01-14 devnull .I path ...
46 8ce709af 2005-01-18 devnull .B http://cvs.pdos.lcs.mit.edu/cvs/plan9/
47 67075c36 2005-01-14 devnull .SH DESCRIPTION
48 67075c36 2005-01-14 devnull The master source tree for Plan 9 from User Space is maintained
49 67075c36 2005-01-14 devnull using the source control system CVS
50 67075c36 2005-01-14 devnull as a poor substitute for Plan 9's
51 67075c36 2005-01-14 devnull \fIreplica\fR(8) and dump file system.
53 67075c36 2005-01-14 devnull The first argument to
55 67075c36 2005-01-14 devnull is a command, which determines the form of the rest of the command line.
59 67075c36 2005-01-14 devnull command authenticates to the remote server and records your password in
60 67075c36 2005-01-14 devnull .BR $HOME/.cvspass .
61 67075c36 2005-01-14 devnull Use an empty password: when prompted, type a newline.
64 67075c36 2005-01-14 devnull .B checkout
65 67075c36 2005-01-14 devnull command downloads a copy of the tree into the directory
66 67075c36 2005-01-14 devnull .BR plan9 ,
67 67075c36 2005-01-14 devnull which it will create.
68 67075c36 2005-01-14 devnull The argument
70 67075c36 2005-01-14 devnull is both the name of the created directory and the name used to
71 67075c36 2005-01-14 devnull tell the server which tree you want.
72 67075c36 2005-01-14 devnull If you want to use a different name locally, rename the directory
73 67075c36 2005-01-14 devnull after running the command.
75 67075c36 2005-01-14 devnull From directories within the
77 67075c36 2005-01-14 devnull tree, the awkward
79 67075c36 2005-01-14 devnull is no longer necessary.
82 67075c36 2005-01-14 devnull .I update
83 67075c36 2005-01-14 devnull incorporates recent changes from the CVS tree
84 67075c36 2005-01-14 devnull into the local copy.
85 67075c36 2005-01-14 devnull If the changes cannot be merged because of locally-made changes
86 67075c36 2005-01-14 devnull that are in the way,
88 67075c36 2005-01-14 devnull will leave a note in the file showing the differences between the local
89 67075c36 2005-01-14 devnull and remote file.
95 67075c36 2005-01-14 devnull .I update
97 67075c36 2005-01-14 devnull it to update subdirectories as well.
100 67075c36 2005-01-14 devnull flag causes
102 67075c36 2005-01-14 devnull .I update
103 67075c36 2005-01-14 devnull to remove directories that have been emptied.
106 67075c36 2005-01-14 devnull .I status
107 67075c36 2005-01-14 devnull displays the version number (also called a revision number)
108 67075c36 2005-01-14 devnull for the local copy of the named files,
109 67075c36 2005-01-14 devnull as well as the number of the most recent version on the server.
110 67075c36 2005-01-14 devnull Version numbers are of the form
111 67075c36 2005-01-14 devnull .RI 1. n \fR,
114 67075c36 2005-01-14 devnull is a sequence number starting at 1.
118 67075c36 2005-01-14 devnull runs Unix's
119 67075c36 2005-01-14 devnull .IR diff (1)
120 67075c36 2005-01-14 devnull to compare files in the local tree with the corresponding files in
121 67075c36 2005-01-14 devnull the CVS tree.
122 67075c36 2005-01-14 devnull By default it compares against the version that was most recently
123 67075c36 2005-01-14 devnull incorporated into the local tree.
126 67075c36 2005-01-14 devnull flag specifies an alternate version to compare against.
127 67075c36 2005-01-14 devnull The special revision
129 67075c36 2005-01-14 devnull refers to the most recent version on the server.
132 67075c36 2005-01-14 devnull flag instructs
135 67075c36 2005-01-14 devnull to use the version as of the given date.
136 67075c36 2005-01-14 devnull Almost any imaginable date format is acceptable:
137 67075c36 2005-01-14 devnull .BR 20050110 ,
138 67075c36 2005-01-14 devnull .BR 1/10/2005 ,
140 67075c36 2005-01-14 devnull .BR 10' ,
141 67075c36 2005-01-14 devnull .BR yesterday ,
142 67075c36 2005-01-14 devnull .B 'last
143 67075c36 2005-01-14 devnull .BR week ',
146 67075c36 2005-01-14 devnull .BR ago' ,
148 67075c36 2005-01-14 devnull .B fortnight
149 c230471b 2005-01-14 devnull .BR ago' ,
150 67075c36 2005-01-14 devnull and so on.
155 67075c36 2005-01-14 devnull options are given,
156 67075c36 2005-01-14 devnull those two versions are compared, and the local copy is ignored.
160 b7f251fb 2005-01-14 devnull passes the
164 b7f251fb 2005-01-14 devnull options to the Unix
165 b7f251fb 2005-01-14 devnull .IR diff .
167 67075c36 2005-01-14 devnull If you download a tar file from the web
168 67075c36 2005-01-14 devnull instead of checking out the tree with CVS,
169 67075c36 2005-01-14 devnull you can still use the
170 67075c36 2005-01-14 devnull .I update
173 67075c36 2005-01-14 devnull commands to stay up-to-date and to see what has changed.
174 67075c36 2005-01-14 devnull You will need to run the
176 67075c36 2005-01-14 devnull .I login
177 67075c36 2005-01-14 devnull command first to create your
178 67075c36 2005-01-14 devnull .B .cvspass
181 8ce709af 2005-01-18 devnull The CVS tree can be inspected on the web at
182 8ce709af 2005-01-18 devnull .HR http://cvs.pdos.lcs.mit.edu/cvs/plan9/ "" .
183 67075c36 2005-01-14 devnull .SH EXAMPLES
184 67075c36 2005-01-14 devnull Incorporate any changes made to the CVS tree since
185 67075c36 2005-01-14 devnull the last check out or update:
188 67075c36 2005-01-14 devnull cd $PLAN9
189 67075c36 2005-01-14 devnull cvs up -dP
193 adc93f60 2005-01-14 devnull .I libdraw
194 67075c36 2005-01-14 devnull against its source from January 1, 2005:
197 67075c36 2005-01-14 devnull cd $PLAN9/src/libdraw
198 67075c36 2005-01-14 devnull cvs diff -D20050101
201 67075c36 2005-01-14 devnull Check the entire tree for changes made locally:
204 67075c36 2005-01-14 devnull cd $PLAN9
205 67075c36 2005-01-14 devnull cvs diff
208 67075c36 2005-01-14 devnull Check the entire tree for changes between the local version and
209 67075c36 2005-01-14 devnull the most recent in the CVS tree.
210 67075c36 2005-01-14 devnull This does not indicate which changes are local ones
211 67075c36 2005-01-14 devnull and which are changes to the CVS tree that have not yet been
212 67075c36 2005-01-14 devnull incorporated into the local tree.
215 67075c36 2005-01-14 devnull cd $PLAN9
216 67075c36 2005-01-14 devnull cvs diff -r HEAD
221 4197125d 2005-03-18 devnull less chatty by setting the global
223 4197125d 2005-03-18 devnull flag implicitly on every CVS command:
225 4197125d 2005-03-18 devnull cd $HOME
226 4197125d 2005-03-18 devnull echo 'cvs -q' > .cvsrc
228 67075c36 2005-01-14 devnull .SH FILES
231 67075c36 2005-01-14 devnull directory containing CVS metadata for parent
233 67075c36 2005-01-14 devnull .B .cvsignore
234 67075c36 2005-01-14 devnull list of files and wildcards to exclude from CVS operations in this directory
235 67075c36 2005-01-14 devnull .SH SEE ALSO
237 638f5c0d 2005-01-14 devnull \fIcvs\fR(1),
238 8ce709af 2005-01-18 devnull .HR http://www.cvshome.org/
240 8ce709af 2005-01-18 devnull .HR http://cvs.pdos.lcs.mit.edu/cvs/plan9/
241 67075c36 2005-01-14 devnull .SH BUGS
242 67075c36 2005-01-14 devnull The CVS server is a read-only public copy of a private tree.
243 67075c36 2005-01-14 devnull The dates on versions reflect the date the changes were made in the
244 67075c36 2005-01-14 devnull private tree, not the date the change was made public.
246 1574caa0 2005-01-14 devnull On Mac OS X,
248 1574caa0 2005-01-14 devnull will complain during a checkout that some files in
249 1574caa0 2005-01-14 devnull .B $PLAN9/troff/font/devutf
250 1574caa0 2005-01-14 devnull are ``in the way.''
251 1574caa0 2005-01-14 devnull This is due to the Mac case-insensitive file system
252 1574caa0 2005-01-14 devnull and the fact that troff has some (not often used)
253 fe1a0270 2005-01-16 devnull files whose names differ only in case.
