source: basicnet/netprogs/cvs.xml@ 4e33969

<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
  <!ENTITY % general-entities SYSTEM "../../general.ent">
  %general-entities;

  <!ENTITY cvs-download-http "https://ccvs.cvshome.org/files/documents/19/534/cvs-&cvs-version;.tar.bz2">
  <!ENTITY cvs-download-ftp  " ">
  <!ENTITY cvs-size          "2.3 MB">
  <!ENTITY cvs-buildsize     "20 MB">
  <!ENTITY cvs-time          "0.31 SBU">
]>

<sect1 id="cvs" xreflabel="CVS-&cvs-version;">
<sect1info>
<othername>$LastChangedBy$</othername>
<date>$Date$</date>
</sect1info>
<?dbhtml filename="cvs.html"?>
<title>CVS-&cvs-version;</title>

<sect2>
<title>Introduction to <application><acronym>CVS</acronym></application></title>

<para><application><acronym>CVS</acronym></application> is the Concurrent 
Versioning System. This is a version control system useful for projects
using a central repository to hold files and then track all changes made to 
those files. These instructions install the client used to manipulate the
repository, creation of a repository is covered at <xref linkend="cvsserver"/>.
</para>

<sect3><title>Package information</title>
<itemizedlist spacing='compact'>
<listitem><para>Download (HTTP): <ulink url="&cvs-download-http;"/></para></listitem>
<listitem><para>Download (FTP): <ulink url="&cvs-download-ftp;"/></para></listitem>
<listitem><para>Download size: &cvs-size;</para></listitem>
<listitem><para>Estimated Disk space required: &cvs-buildsize;</para></listitem>
<listitem><para>Estimated build time: &cvs-time;</para></listitem></itemizedlist>
</sect3>

<sect3><title>Additional downloads</title>
<itemizedlist spacing='compact'>
<listitem><para>Recommended patch: <ulink
url="&patch-root;/cvs-&cvs-version;-zlib-2.patch"/>
</para></listitem>
</itemizedlist></sect3>

<sect3><title><application>CVS</application> dependencies</title>
<sect4><title>Optional</title>
<para>
<xref linkend="gdbm"/>,
<ulink url="http://www.pdc.kth.se/kth-krb/">krb4</ulink>,
<xref linkend="mitkrb"/> or <xref linkend="heimdal"/>,
<xref linkend="gs"/> or <xref linkend="espgs"/>,
<ulink url="../server/mail.html">MTA</ulink> and
<xref linkend="postlfs-editors-vim"/>
</para></sect4>
</sect3>

</sect2>

<sect2>
<title>Installation of <application><acronym>CVS</acronym></application></title>

<para>By default <application><acronym>CVS</acronym></application>
is statically linked against the zlib library included in its source
tree. This makes it exposed to possible security vulnerabilities in that
library. If you want to modify CVS to use the newest system shared zlib
library apply the following patch:</para>

<screen><userinput><command>patch -Np1 -i ../cvs-&cvs-version;-zlib-2.patch</command></userinput></screen>

<para>Install <application><acronym>cvs</acronym></application> by running the following commands:</para>

<screen><userinput><command>./configure --prefix=/usr &amp;&amp;
make &amp;&amp;
make install</command></userinput></screen>

</sect2>

<sect2>
<title>Configuring <application><acronym>CVS</acronym></application></title>

<sect3><title>Config files</title>
<para><filename>~/.cvsrc</filename>, <filename>~/.cvswrappers</filename></para>
</sect3>

<sect3><title>Configuration Information</title>

<para><filename>~/.cvsrc</filename> is the main
<application><acronym>CVS</acronym></application> configuration file.
This file is used by users to specify defaults for different <command>cvs
</command> commands, for example to make all <command>cvs diff</command> 
commands run with <userinput>-u</userinput>, a user would add <userinput>
diff -u</userinput> to their <filename>.cvsrc</filename> file.</para>

<para><filename>~/.cvswrappers</filename> specifies wrappers to be used in 
addition to those specified in the <filename>CVSROOT/cvswrappers</filename> 
file in the repository.</para>

<para><filename>~/.cvspass</filename> can hold passwords to complete
logins to servers.</para></sect3>

</sect2>

<sect2>
<title>Contents</title>

<para>The <application><acronym>CVS</acronym></application> package contains 
<command>cvs</command>, <command>cvsbug</command> and <command>rcs2log</command>.</para>

</sect2>

<sect2><title>Description</title>

<sect3><title>cvs</title>
<para>This is the main program file for the concurrent versioning 
system.</para></sect3>

<sect3><title>cvsbug</title>
<para>This is used to send problem reports about
<application><acronym>CVS</acronym></application> to a central
support site.</para></sect3>

<sect3><title>rcs2log</title>
<para><acronym>RCS</acronym> to Change Log generator.</para></sect3>

</sect2>

</sect1>