version 1.98, 1999/12/22 03:33:47 |
version 1.99, 2000/01/26 22:48:30 |
|
|
<h2><font color=#e00000>Anonymous CVS</font><hr></h2> |
<h2><font color=#e00000>Anonymous CVS</font><hr></h2> |
|
|
<h3><font color=#0000e0>What is it?</font></h3> |
<h3><font color=#0000e0>What is it?</font></h3> |
|
|
<p> |
<p> |
Anonymous CVS is a method of keeping your local copy of the OpenBSD source |
Anonymous CVS is a method of keeping your local copy of the OpenBSD source |
tree up to date with respect to changes made to current OpenBSD sources. |
tree up to date with respect to changes made to current OpenBSD sources. |
|
</p> |
|
|
<p> |
<p> |
The major advantage of Anonymous CVS over other source code update |
The major advantage of Anonymous CVS over other source code update |
techniques is that it works directly against a central source code |
techniques is that it works directly against a central source code |
|
|
commands available to control merging and updating your changes with |
commands available to control merging and updating your changes with |
other source changes and for performing diff's, change histories |
other source changes and for performing diff's, change histories |
and other queries against the central repository. |
and other queries against the central repository. |
|
</p> |
|
|
<p> |
<p> |
You can use anoncvs to access our three main source repositories: |
The OpenBSD Project currently has three main source repositories: |
<strong>src</strong>, <strong>ports</strong>, and <strong>www</strong>. |
</p> |
<p> |
|
|
<ul> |
|
<li><b>src</b> - Houses all source code for the OpenBSD Operating System. |
|
<li><b>ports</b> - Houses the <a href="./ports.html">OpenBSD Ports</a>. |
|
<li><b>www</b> - Houses all OpenBSD web pages. (Including this one). |
|
</ul> |
|
|
<h3><font color=#0000e0>CVS:</font></h3> |
<h3><font color=#0000e0>CVS:</font></h3> |
|
|
|
<p> |
<a href=why-cvs.html> |
<a href=why-cvs.html> |
CVS is the source code control system used to manage the OpenBSD source tree.</a> |
CVS is the source code control system used to manage the OpenBSD source tree.</a> |
It implements a central repository for all officially released source code |
It implements a central repository for all officially released source code |
and changes, while permitting developers to maintain local copies of the |
and changes, while permitting developers to maintain local copies of the |
source code with their working changes. Developers with "write access" |
source code with their working changes. Developers with "<b>write access</b>" |
can commit changes directly to the OpenBSD source tree, while "Anonymous |
can commit changes directly to the OpenBSD source tree, while "Anonymous |
CVS" users have "read access" and can keep their local copies of the source |
CVS" users have "<b>read access</b>" and can keep their local copies of the source |
up to date and issue queries against the central depository. |
up to date and issue queries against the central depository. |
|
</p> |
|
|
<p> |
<p> |
The major strength of CVS is that it has the ability to perform intelligent |
The major strength of CVS is that it has the ability to perform intelligent |
merges of changes to the central repository with changes that you make to |
merges of changes to the central repository with changes that you make to |
|
|
perform an update, your changes are not "blown away", rather CVS makes |
perform an update, your changes are not "blown away", rather CVS makes |
best efforts to merge the changes made to the central sources with changes |
best efforts to merge the changes made to the central sources with changes |
you've made to your local copy. |
you've made to your local copy. |
|
</p> |
|
|
<p> |
<p> |
In the event that the changes can't be completely merged, CVS provides a |
In the event that the changes can't be completely merged, CVS provides a |
"soft fallback", in terms of providing you with annotated changes to your |
"soft fallback", in terms of providing you with annotated changes to your |
local copy, preserving an unmodified copy of your version and continuing |
local copy, preserving an unmodified copy of your version and continuing |
to update any other source modules you requested. |
to update any other source modules you requested. |
|
</p> |
|
|
<p> |
<p> |
People who own an OpenBSD CD may have seen the CVS/ dirs on it. |
People who own an OpenBSD CD may have seen the <i>CVS/</i> dirs on it. |
Actually there is a reason, the CD has a checkout of the OpenBSD src/ module |
Actually there is a reason, the CD has a checkout of the OpenBSD <b>src</b> module |
usable to continue updating from. Using this tree will result in a much |
usable to continue updating from. Using this tree will result in a much |
faster initial CVS update than a fresh checkout of the full OpenBSD |
faster initial CVS update than a fresh checkout of the full OpenBSD |
source tree. There are two ways of using the CD: |
source tree. There are two ways of using the CD: |
|
</p> |
|
|
<ul> |
<ul> |
<li>copy the tree off it, (assuming the CD is mounted on /mnt): |
<li>To copy the CVS tree from the CD to <i>/usr/src</i> (assuming the CD is mounted on /mnt): |
<pre> |
<pre> |
<b>#</b> cd /mnt; pax -rw CVS Makefile [a-z]* /usr/src |
# <b>cd /mnt; pax -rw CVS Makefile [a-z]* /usr/src</b> |
</pre> |
</pre> |
<li>or use a union mount with the CD below a writable directory. |
<li>Use a union mount with the CD below a writable directory. (This can be used when only compiling from the tree.) |
<pre> |
<pre> |
<b>#</b> mount -t union -o -b /mnt /usr/src |
# <b>mount -t union -o -b /mnt /usr/src</b> |
</pre> |
</pre> |
</ul> |
</ul> |
After this, /usr/src will be a nice checkout area where all cvs(1) commands |
After this, <i>/usr/src</i> will be a nice checkout area where all <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=cvs&sektion=1&format=html">cvs(1)</a> commands will work OK. |
will work OK. |
|
|
<!-- Does this need to be here now that the man page is linked? --> |
<h4>CVS COMMAND SUMMARY</h4> |
<h4>CVS COMMAND SUMMARY</h4> |
<dt> cvs [cvs args] [cvs command] [cvs command args] |
<dt> cvs [cvs args] [cvs command] [cvs command args] |
<dd> below is a listing of commonly used cvs commands. |
<dd> below is a listing of commonly used cvs commands. |
|
|
<dt>update |
<dt>update |
<DD>Bring your working directory up to date with the repository. |
<DD>Bring your working directory up to date with the repository. |
</dl> |
</dl> |
|
|
<p> |
<p> |
To summarize, the real strength of using Anonymous CVS is that it is |
To summarize, the real strength of using Anonymous CVS is that it is |
a "tolerant" source code control system - it <strong>respects</strong> |
a "tolerant" source code control system - it <strong>respects</strong> |