3 67075c36 2005-01-14 devnull cvs \- introduction using plan9port CVS repository
4 67075c36 2005-01-14 devnull .SH SYNOPSIS
7 d944f764 2007-11-05 rsc .B :pserver:anoncvs@cvs.pdos.csail.mit.edu:/cvs login
11 d944f764 2007-11-05 rsc .B :pserver:anoncvs@cvs.pdos.csail.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 d944f764 2007-11-05 rsc .B http://cvs.pdos.csail.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.
52 d944f764 2007-11-05 rsc (It is maintained simultaneously using Mercurial; see
55 67075c36 2005-01-14 devnull The first argument to
57 67075c36 2005-01-14 devnull is a command, which determines the form of the rest of the command line.
61 67075c36 2005-01-14 devnull command authenticates to the remote server and records your password in
62 67075c36 2005-01-14 devnull .BR $HOME/.cvspass .
63 67075c36 2005-01-14 devnull Use an empty password: when prompted, type a newline.
66 67075c36 2005-01-14 devnull .B checkout
67 67075c36 2005-01-14 devnull command downloads a copy of the tree into the directory
68 67075c36 2005-01-14 devnull .BR plan9 ,
69 67075c36 2005-01-14 devnull which it will create.
70 67075c36 2005-01-14 devnull The argument
72 67075c36 2005-01-14 devnull is both the name of the created directory and the name used to
73 67075c36 2005-01-14 devnull tell the server which tree you want.
74 67075c36 2005-01-14 devnull If you want to use a different name locally, rename the directory
75 67075c36 2005-01-14 devnull after running the command.
77 67075c36 2005-01-14 devnull From directories within the
79 67075c36 2005-01-14 devnull tree, the awkward
81 67075c36 2005-01-14 devnull is no longer necessary.
84 67075c36 2005-01-14 devnull .I update
85 67075c36 2005-01-14 devnull incorporates recent changes from the CVS tree
86 67075c36 2005-01-14 devnull into the local copy.
87 67075c36 2005-01-14 devnull If the changes cannot be merged because of locally-made changes
88 67075c36 2005-01-14 devnull that are in the way,
90 67075c36 2005-01-14 devnull will leave a note in the file showing the differences between the local
91 67075c36 2005-01-14 devnull and remote file.
97 67075c36 2005-01-14 devnull .I update
99 67075c36 2005-01-14 devnull it to update subdirectories as well.
102 67075c36 2005-01-14 devnull flag causes
104 67075c36 2005-01-14 devnull .I update
105 67075c36 2005-01-14 devnull to remove directories that have been emptied.
108 67075c36 2005-01-14 devnull .I status
109 67075c36 2005-01-14 devnull displays the version number (also called a revision number)
110 67075c36 2005-01-14 devnull for the local copy of the named files,
111 67075c36 2005-01-14 devnull as well as the number of the most recent version on the server.
112 67075c36 2005-01-14 devnull Version numbers are of the form
113 67075c36 2005-01-14 devnull .RI 1. n \fR,
116 67075c36 2005-01-14 devnull is a sequence number starting at 1.
120 67075c36 2005-01-14 devnull runs Unix's
121 67075c36 2005-01-14 devnull .IR diff (1)
122 67075c36 2005-01-14 devnull to compare files in the local tree with the corresponding files in
123 67075c36 2005-01-14 devnull the CVS tree.
124 67075c36 2005-01-14 devnull By default it compares against the version that was most recently
125 67075c36 2005-01-14 devnull incorporated into the local tree.
128 67075c36 2005-01-14 devnull flag specifies an alternate version to compare against.
129 67075c36 2005-01-14 devnull The special revision
131 67075c36 2005-01-14 devnull refers to the most recent version on the server.
134 67075c36 2005-01-14 devnull flag instructs
137 67075c36 2005-01-14 devnull to use the version as of the given date.
138 67075c36 2005-01-14 devnull Almost any imaginable date format is acceptable:
139 67075c36 2005-01-14 devnull .BR 20050110 ,
140 67075c36 2005-01-14 devnull .BR 1/10/2005 ,
142 67075c36 2005-01-14 devnull .BR 10' ,
143 67075c36 2005-01-14 devnull .BR yesterday ,
144 67075c36 2005-01-14 devnull .B 'last
145 67075c36 2005-01-14 devnull .BR week ',
148 67075c36 2005-01-14 devnull .BR ago' ,
150 67075c36 2005-01-14 devnull .B fortnight
151 c230471b 2005-01-14 devnull .BR ago' ,
152 67075c36 2005-01-14 devnull and so on.
157 67075c36 2005-01-14 devnull options are given,
158 67075c36 2005-01-14 devnull those two versions are compared, and the local copy is ignored.
162 b7f251fb 2005-01-14 devnull passes the
166 b7f251fb 2005-01-14 devnull options to the Unix
167 b7f251fb 2005-01-14 devnull .IR diff .
169 67075c36 2005-01-14 devnull If you download a tar file from the web
170 67075c36 2005-01-14 devnull instead of checking out the tree with CVS,
171 67075c36 2005-01-14 devnull you can still use the
172 67075c36 2005-01-14 devnull .I update
175 67075c36 2005-01-14 devnull commands to stay up-to-date and to see what has changed.
176 67075c36 2005-01-14 devnull You will need to run the
178 67075c36 2005-01-14 devnull .I login
179 67075c36 2005-01-14 devnull command first to create your
180 67075c36 2005-01-14 devnull .B .cvspass
183 8ce709af 2005-01-18 devnull The CVS tree can be inspected on the web at
184 d944f764 2007-11-05 rsc .HR http://cvs.pdos.csail.mit.edu/cvs/plan9/ "" .
185 67075c36 2005-01-14 devnull .SH EXAMPLES
186 67075c36 2005-01-14 devnull Incorporate any changes made to the CVS tree since
187 67075c36 2005-01-14 devnull the last check out or update:
190 67075c36 2005-01-14 devnull cd $PLAN9
191 67075c36 2005-01-14 devnull cvs up -dP
195 adc93f60 2005-01-14 devnull .I libdraw
196 67075c36 2005-01-14 devnull against its source from January 1, 2005:
199 67075c36 2005-01-14 devnull cd $PLAN9/src/libdraw
200 67075c36 2005-01-14 devnull cvs diff -D20050101
203 67075c36 2005-01-14 devnull Check the entire tree for changes made locally:
206 67075c36 2005-01-14 devnull cd $PLAN9
207 67075c36 2005-01-14 devnull cvs diff
210 67075c36 2005-01-14 devnull Check the entire tree for changes between the local version and
211 67075c36 2005-01-14 devnull the most recent in the CVS tree.
212 67075c36 2005-01-14 devnull This does not indicate which changes are local ones
213 67075c36 2005-01-14 devnull and which are changes to the CVS tree that have not yet been
214 67075c36 2005-01-14 devnull incorporated into the local tree.
217 67075c36 2005-01-14 devnull cd $PLAN9
218 67075c36 2005-01-14 devnull cvs diff -r HEAD
223 4197125d 2005-03-18 devnull less chatty by setting the global
225 4197125d 2005-03-18 devnull flag implicitly on every CVS command:
227 4197125d 2005-03-18 devnull cd $HOME
228 4197125d 2005-03-18 devnull echo 'cvs -q' > .cvsrc
230 67075c36 2005-01-14 devnull .SH FILES
233 67075c36 2005-01-14 devnull directory containing CVS metadata for parent
235 67075c36 2005-01-14 devnull .B .cvsignore
236 67075c36 2005-01-14 devnull list of files and wildcards to exclude from CVS operations in this directory
237 67075c36 2005-01-14 devnull .SH SEE ALSO
241 638f5c0d 2005-01-14 devnull \fIcvs\fR(1),
242 8ce709af 2005-01-18 devnull .HR http://www.cvshome.org/
244 d944f764 2007-11-05 rsc .HR http://cvs.pdos.csail.mit.edu/cvs/plan9/
245 67075c36 2005-01-14 devnull .SH BUGS
246 67075c36 2005-01-14 devnull The CVS server is a read-only public copy of a private tree.
247 67075c36 2005-01-14 devnull The dates on versions reflect the date the changes were made in the
248 67075c36 2005-01-14 devnull private tree, not the date the change was made public.
250 1574caa0 2005-01-14 devnull On Mac OS X,
252 1574caa0 2005-01-14 devnull will complain during a checkout that some files in
253 1574caa0 2005-01-14 devnull .B $PLAN9/troff/font/devutf
254 1574caa0 2005-01-14 devnull are ``in the way.''
255 1574caa0 2005-01-14 devnull This is due to the Mac case-insensitive file system
256 a79e8ab4 2006-02-14 devnull and the fact that troff has some (rarely used)
257 fe1a0270 2005-01-16 devnull files whose names differ only in case.