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 ...
44 67075c36 2005-01-14 devnull .SH DESCRIPTION
45 67075c36 2005-01-14 devnull The master source tree for Plan 9 from User Space is maintained
46 67075c36 2005-01-14 devnull using the source control system CVS
47 67075c36 2005-01-14 devnull as a poor substitute for Plan 9's
48 67075c36 2005-01-14 devnull \fIreplica\fR(8) and dump file system.
50 67075c36 2005-01-14 devnull The first argument to
52 67075c36 2005-01-14 devnull is a command, which determines the form of the rest of the command line.
56 67075c36 2005-01-14 devnull command authenticates to the remote server and records your password in
57 67075c36 2005-01-14 devnull .BR $HOME/.cvspass .
58 67075c36 2005-01-14 devnull Use an empty password: when prompted, type a newline.
61 67075c36 2005-01-14 devnull .B checkout
62 67075c36 2005-01-14 devnull command downloads a copy of the tree into the directory
63 67075c36 2005-01-14 devnull .BR plan9 ,
64 67075c36 2005-01-14 devnull which it will create.
65 67075c36 2005-01-14 devnull The argument
67 67075c36 2005-01-14 devnull is both the name of the created directory and the name used to
68 67075c36 2005-01-14 devnull tell the server which tree you want.
69 67075c36 2005-01-14 devnull If you want to use a different name locally, rename the directory
70 67075c36 2005-01-14 devnull after running the command.
72 67075c36 2005-01-14 devnull From directories within the
74 67075c36 2005-01-14 devnull tree, the awkward
76 67075c36 2005-01-14 devnull is no longer necessary.
79 67075c36 2005-01-14 devnull .I update
80 67075c36 2005-01-14 devnull incorporates recent changes from the CVS tree
81 67075c36 2005-01-14 devnull into the local copy.
82 67075c36 2005-01-14 devnull If the changes cannot be merged because of locally-made changes
83 67075c36 2005-01-14 devnull that are in the way,
85 67075c36 2005-01-14 devnull will leave a note in the file showing the differences between the local
86 67075c36 2005-01-14 devnull and remote file.
92 67075c36 2005-01-14 devnull .I update
94 67075c36 2005-01-14 devnull it to update subdirectories as well.
97 67075c36 2005-01-14 devnull flag causes
99 67075c36 2005-01-14 devnull .I update
100 67075c36 2005-01-14 devnull to remove directories that have been emptied.
103 67075c36 2005-01-14 devnull .I status
104 67075c36 2005-01-14 devnull displays the version number (also called a revision number)
105 67075c36 2005-01-14 devnull for the local copy of the named files,
106 67075c36 2005-01-14 devnull as well as the number of the most recent version on the server.
107 67075c36 2005-01-14 devnull Version numbers are of the form
108 67075c36 2005-01-14 devnull .RI 1. n \fR,
111 67075c36 2005-01-14 devnull is a sequence number starting at 1.
115 67075c36 2005-01-14 devnull runs Unix's
116 67075c36 2005-01-14 devnull .IR diff (1)
117 67075c36 2005-01-14 devnull to compare files in the local tree with the corresponding files in
118 67075c36 2005-01-14 devnull the CVS tree.
119 67075c36 2005-01-14 devnull By default it compares against the version that was most recently
120 67075c36 2005-01-14 devnull incorporated into the local tree.
123 67075c36 2005-01-14 devnull flag specifies an alternate version to compare against.
124 67075c36 2005-01-14 devnull The special revision
126 67075c36 2005-01-14 devnull refers to the most recent version on the server.
129 67075c36 2005-01-14 devnull flag instructs
132 67075c36 2005-01-14 devnull to use the version as of the given date.
133 67075c36 2005-01-14 devnull Almost any imaginable date format is acceptable:
134 67075c36 2005-01-14 devnull .BR 20050110 ,
135 67075c36 2005-01-14 devnull .BR 1/10/2005 ,
137 67075c36 2005-01-14 devnull .BR 10' ,
138 67075c36 2005-01-14 devnull .BR yesterday ,
139 67075c36 2005-01-14 devnull .B 'last
140 67075c36 2005-01-14 devnull .BR week ',
143 67075c36 2005-01-14 devnull .BR ago' ,
145 67075c36 2005-01-14 devnull .B fortnight
146 67075c36 2005-01-14 devnull .BR ago ',
147 67075c36 2005-01-14 devnull and so on.
152 67075c36 2005-01-14 devnull options are given,
153 67075c36 2005-01-14 devnull those two versions are compared, and the local copy is ignored.
155 67075c36 2005-01-14 devnull If you download a tar file from the web
156 67075c36 2005-01-14 devnull instead of checking out the tree with CVS,
157 67075c36 2005-01-14 devnull you can still use the
158 67075c36 2005-01-14 devnull .I update
161 67075c36 2005-01-14 devnull commands to stay up-to-date and to see what has changed.
162 67075c36 2005-01-14 devnull You will need to run the
164 67075c36 2005-01-14 devnull .I login
165 67075c36 2005-01-14 devnull command first to create your
166 67075c36 2005-01-14 devnull .B .cvspass
168 67075c36 2005-01-14 devnull .SH EXAMPLES
169 67075c36 2005-01-14 devnull Incorporate any changes made to the CVS tree since
170 67075c36 2005-01-14 devnull the last check out or update:
173 67075c36 2005-01-14 devnull cd $PLAN9
174 67075c36 2005-01-14 devnull cvs up -dP
178 adc93f60 2005-01-14 devnull .I libdraw
179 67075c36 2005-01-14 devnull against its source from January 1, 2005:
182 67075c36 2005-01-14 devnull cd $PLAN9/src/libdraw
183 67075c36 2005-01-14 devnull cvs diff -D20050101
186 67075c36 2005-01-14 devnull Check the entire tree for changes made locally:
189 67075c36 2005-01-14 devnull cd $PLAN9
190 67075c36 2005-01-14 devnull cvs diff
193 67075c36 2005-01-14 devnull Check the entire tree for changes between the local version and
194 67075c36 2005-01-14 devnull the most recent in the CVS tree.
195 67075c36 2005-01-14 devnull This does not indicate which changes are local ones
196 67075c36 2005-01-14 devnull and which are changes to the CVS tree that have not yet been
197 67075c36 2005-01-14 devnull incorporated into the local tree.
200 67075c36 2005-01-14 devnull cd $PLAN9
201 67075c36 2005-01-14 devnull cvs diff -r HEAD
203 67075c36 2005-01-14 devnull .SH FILES
206 67075c36 2005-01-14 devnull directory containing CVS metadata for parent
208 67075c36 2005-01-14 devnull .B .cvsignore
209 67075c36 2005-01-14 devnull list of files and wildcards to exclude from CVS operations in this directory
210 67075c36 2005-01-14 devnull .SH SEE ALSO
212 67075c36 2005-01-14 devnull \fIcvs\fR(1).
215 67075c36 2005-01-14 devnull .HR http://www.cvshome.org
216 67075c36 2005-01-14 devnull .SH BUGS
217 67075c36 2005-01-14 devnull The CVS server is a read-only public copy of a private tree.
218 67075c36 2005-01-14 devnull The dates on versions reflect the date the changes were made in the
219 67075c36 2005-01-14 devnull private tree, not the date the change was made public.
221 1574caa0 2005-01-14 devnull On Mac OS X,
223 1574caa0 2005-01-14 devnull will complain during a checkout that some files in
224 1574caa0 2005-01-14 devnull .B $PLAN9/troff/font/devutf
225 1574caa0 2005-01-14 devnull are ``in the way.''
226 1574caa0 2005-01-14 devnull This is due to the Mac case-insensitive file system
227 1574caa0 2005-01-14 devnull and the fact that troff has some (not often used)
228 1574caa0 2005-01-14 devnull files that differ only in case.