[BACK]Return to anoncvs.html CVS log [TXT][DIR] Up to [local] / www

Diff for /www/anoncvs.html between version 1.99 and 1.100

version 1.99, 2000/01/26 22:48:30 version 1.100, 2000/01/26 23:47:44
Line 16 
Line 16 
 <p>  <p>
 <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>  <p>
   <ul><h3>Table Of Contents</h3>
   <li><a href="#anoncvs">What is Anonymous CVS?</a>
   <li><a href="#CVS">What is CVS?</a>
   <li><a href="#starting">Getting Started Using Anonymous CVS.</a>
   <li><a href="#using">Using CVS to Get and Update your Source Tree.</a>
   <li><a href="#CVSROOT">Available Anonymous CVS Servers.</a>
   </ul>
   </p>
   <hr>
   
   
   <a name="anoncvs"></a>
   <h3><font color=#0000e0>What is Anonymous CVS?</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.
Line 42 
Line 55 
         <li><b>www</b> - Houses all OpenBSD web pages. (Including this one).          <li><b>www</b> - Houses all OpenBSD web pages. (Including this one).
 </ul>  </ul>
   
 <h3><font color=#0000e0>CVS:</font></h3>  <p>
   To summarize, the real strength of using Anonymous CVS is that it is
   a "tolerant" source code control system - it <strong>respects</strong>
   changes that you have made to your local sources and makes <strong>
   "best efforts"</strong> to update your entire source tree, rather than
   leaving you a list of arcane problems that have to be resolved before
   continuing.
   </p>
   
   <a name="CVS"></a>
   <h3><font color=#0000e0>What is CVS?</font></h3>
   
 <p>  <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>
Line 71 
Line 94 
 to update any other source modules you requested.  to update any other source modules you requested.
 </p>  </p>
   
   <a name="starting"></a>
   <h3><font color=#0000e0>Getting Started Using Anonymous CVS.</font></h3>
   
 <p>  <p>
   The latest version of CVS is available at
   <a href=http://download.cyclic.com/pub/>Cyclic</a>.
   Versions earlier than 1.6 are not recommended, and may not work.
   If you already have OpenBSD installed, CVS is included.
   </p>
   
   <p>
 People who own an OpenBSD CD may have seen the <i>CVS/</i> 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 <b>src</b> 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
Line 89 
Line 122 
         # <b>mount -t union -o -b /mnt /usr/src</b>          # <b>mount -t union -o -b /mnt /usr/src</b>
 </pre>  </pre>
 </ul>  </ul>
   
   <p>
   For people who don't have a CD on hand, you can use <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=cvs&sektion=1&format=html">cvs(1)</a> to "<b>checkout</b>" the source repository for you. This is discussed in the <a href="#using">next section</a>.
   </p>
   
   <p>
 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.  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.
   </p>
   
 <!-- Does this need to be here now that the man page is linked? -->  <a name="using"></a>
 <h4>CVS COMMAND SUMMARY</h4>  <h3><font color=#0000e0>Using CVS(1) to get and update your source tree.</font></h3>
 <dt> cvs [cvs args] [cvs command] [cvs command args]  
 <dd> below is a listing of commonly used cvs commands.  
 <dl>  
 <DT>add  
 <dd>Add a new file or directory to the repository.  
 <dt>get  
 <dd>Make a working directory of source files for editing.  
 <dt>commit  
 <dd>Apply changes to the source repository (write access)  
 <dt>diff  
 <dd>Show differences between local files and the source repository.  
 <dt>history  
 <dd>Show reports on cvs commands against the source repository.  
 <dt>log  
 <dd>Display CVS log information.  
 <dt>rdiff  
 <dd>Prepare a collection of diffs reflecting changes between release.  
 <dt>status  
 <dd>Show current status of files in the repository and local copies.  
 <dt>update  
 <DD>Bring your working directory up to date with the repository.  
 </dl>  
   
 <p>  <p>
 To summarize, the real strength of using Anonymous CVS is that it is  CVS was designed to be a simple way to retrive and update your sources, therefore there
 a "tolerant" source code control system - it <strong>respects</strong>  isn't much involved at all in doing so. To start off you must know which Anonymous CVS server you are going to use. A list of these servers is <a href="#CVSROOT">below</a>.
 changes that you have made to your local sources and makes <strong>  Do, however, notice that there are only 3 ways to access these servers.
 "best efforts"</strong> to update your entire source tree, rather than  </p>
 leaving you a list of arcane problems that have to be resolved before  
 continuing.  
   
 <h3><font color=#0000e0>Using Anonymous CVS:</font></h3>  <ul>
   <li><b>ssh</b> - Secure Shell can be used to access the anonymous CVS servers. This is the <b>recommended</b> way of doing so, as it is encrypted. As of 2.6 OpenBSD has included OpenSSH in its standard distribution.
   <li><b>rsh</b> - Remote Shell can be used on some of the servers for users who don't have access to <a href="http://www.openssh.com">ssh</a>
   <li><b>pserver</b> - pserver is primarily useful for users who are behind firewalls that block the other two connections.
   </ul>
   
 <p>  <p>
 The latest version of CVS is available at  <b>NOTE:</b> - For users wishing to use ssh, you must first set the <i>CVS_RSH</i> variable to ssh.
 <a href=http://download.cyclic.com/pub/>Cyclic</a>.  
 Versions earlier than 1.6 are not recommended, and may not work.  <ul>
 If you already have OpenBSD installed, CVS is included.  <li> For Korn/Bourne shells.
   <pre>
           $ <b>export CVS_RSH="/usr/bin/ssh"</b>
   </pre>
   <li> For CSH based shells.
   <pre>
           $ <b>setenv CVS_RSH /usr/bin/ssh</b>
   </pre>
   </ul>
   
   <p>
   Once you have chosen which <a href="#CVSROOT">Anonymous CVS Server</a> you will use, and which method you will use, you can start using cvs. For those of you who have CD's you can start with the CVS checkout that is on the CD by using the method <a href="#starting">above</a> to get the sources onto your system. If you don't have a CD handy, use the method below to checkout the sources. This method puts the OpenBSD source tree into <i>/usr/src</i>.
   </p>
   
   <p>
   <ul><pre>
   # <b>cd /usr; cvs checkout src</b>
   </ul></pre>
   </p>
   
   <p>
   The above will checkout the most current sources. Many of you will only want the release sources, especially if you are patching your system. To checkout release sources you must specify a tag along with your command. Example:
   </p>
   
   <p>
   <ul><pre>
   # <b>cd /usr; cvs checkout -rOPENBSD_2_6 src</b>
   </ul></pre>
   Or OPENBSD_2_5 for 2.5, etc.
   </p>
   
   
   <a name="CVSROOT"></a>
   <h3><font color=#0000e0>Available Anonymous CVS Servers.</font></h3>
   
 <p>  <p>
 There are two levels of source tree access:  There are two levels of source tree access:
Legend:
Removed from v.1.99  
changed lines
  Added in v.1.100