source: general/prog/cvs.xml@ 5603a81

10.0 10.1 11.0 7.10 7.4 7.5 7.6 7.6-blfs 7.6-systemd 7.7 7.8 7.9 8.0 8.1 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind gnome kde5-13430 kde5-14269 kde5-14686 ken/refactor-virt krejzi/svn lazarus nosym perl-modules qt5new systemd-11177 systemd-13485 trunk xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since 5603a81 was 5603a81, checked in by Andrew Benton <andy@…>, 9 years ago

Added some checked tags

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@10151 af4574ff-66df-0310-9fd7-8a98e5e911e0

  • Property mode set to 100644
File size: 9.8 KB
Line 
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
3 "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
4 <!ENTITY % general-entities SYSTEM "../../general.ent">
5 %general-entities;
6
7 <!ENTITY cvs-download-http "http://ftp.gnu.org/non-gnu/cvs/source/stable/&cvs-version;/cvs-&cvs-version;.tar.bz2">
8 <!ENTITY cvs-download-ftp "ftp://ftp.gnu.org/non-gnu/cvs/source/stable/&cvs-version;/cvs-&cvs-version;.tar.bz2">
9 <!ENTITY cvs-md5sum "0213ea514e231559d6ff8f80a34117f0">
10 <!ENTITY cvs-size "2.9 MB">
11 <!ENTITY cvs-buildsize "32.3 MB">
12 <!ENTITY cvs-time "0.3 SBU (additional ~20 SBU to run the test suite)">
13]>
14
15<sect1 id="cvs" xreflabel="CVS-&cvs-version;">
16 <?dbhtml filename="cvs.html"?>
17
18 <sect1info>
19 <othername>$LastChangedBy$</othername>
20 <date>$Date$</date>
21 </sect1info>
22
23 <title>CVS-&cvs-version;</title>
24
25 <indexterm zone="cvs">
26 <primary sortas="a-CVS">CVS</primary>
27 </indexterm>
28
29 <sect2 role="package">
30 <title>Introduction to CVS</title>
31
32 <para><application>CVS</application> is the Concurrent Versions System.
33 This is a version control system useful for projects using a central
34 repository to hold files and then track all changes made to those files.
35 These instructions install the client used to manipulate the repository,
36 creation of a repository is covered at <xref linkend="cvsserver"/>.</para>
37
38 &lfs71_checked;
39
40 <bridgehead renderas="sect3">Package Information</bridgehead>
41 <itemizedlist spacing="compact">
42 <listitem>
43 <para>Download (HTTP): <ulink url="&cvs-download-http;"/></para>
44 </listitem>
45 <listitem>
46 <para>Download (FTP): <ulink url="&cvs-download-ftp;"/></para>
47 </listitem>
48 <listitem>
49 <para>Download MD5 sum: &cvs-md5sum;</para>
50 </listitem>
51 <listitem>
52 <para>Download size: &cvs-size;</para>
53 </listitem>
54 <listitem>
55 <para>Estimated disk space required: &cvs-buildsize;</para>
56 </listitem>
57 <listitem>
58 <para>Estimated build time: &cvs-time;</para>
59 </listitem>
60 </itemizedlist>
61
62 <bridgehead renderas="sect3">Additional Downloads</bridgehead>
63 <itemizedlist spacing='compact'>
64 <listitem>
65 <para>Recommended patch: <ulink
66 url="&patch-root;/cvs-&cvs-version;-zlib-1.patch"/></para>
67 </listitem>
68 </itemizedlist>
69
70 <bridgehead renderas="sect3">CVS Dependencies</bridgehead>
71
72 <bridgehead renderas="sect4">Optional</bridgehead>
73 <para role="optional"><!-- <xref linkend="gdbm"/>, -->
74 <xref linkend="tcsh"/>,
75 <xref linkend="openssh"/>,
76 <ulink url="http://www.pdc.kth.se/kth-krb/">krb4</ulink>,
77 <xref linkend="mitkrb"/>
78 (for the GSSAPI libraries),
79 <xref linkend="gs"/><!-- or <xref linkend="espgs"/> -->, and
80 an <xref linkend="server-mail"/> (that provides a
81 <command>sendmail</command> command)</para>
82
83 <para><application>CVS</application> will invoke a default text editor to
84 create a commit message if the <parameter>-m "Commit message"</parameter>
85 parameter was not used when changes are committed to a repository.
86 <application>CVS</application> looks for the following text editors, in the
87 order shown below, during configuration to determine the default. This
88 default can always be overridden by the <envar>CVSEDITOR</envar> or
89 <envar>EDITOR</envar> environment variables and can be specified directly
90 by passing the <option>--with-editor=<replaceable>&lt;desired text
91 editor&gt;</replaceable></option> parameter to the
92 <command>configure</command> script.</para>
93
94 <itemizedlist spacing='compact'>
95 <listitem>
96 <para><xref linkend="vim"/></para>
97 </listitem>
98 <listitem>
99 <para><xref linkend="emacs"/></para>
100 </listitem>
101 <listitem>
102 <para><xref linkend="nano"/></para>
103 </listitem>
104 <listitem>
105 <para><xref linkend="re-alpine"/> (for Pico)</para>
106 </listitem>
107 </itemizedlist>
108
109
110 <para condition="html" role="usernotes">User Notes:
111 <ulink url="&blfs-wiki;/cvs"/></para>
112
113 </sect2>
114
115 <sect2 role="installation">
116 <title>Installation of CVS</title>
117
118 <para>By default <application>CVS</application> is statically linked
119 against the <application>Zlib</application> library included in its source
120 tree. This makes it exposed to possible security vulnerabilities in that
121 library. If you want to modify <application>CVS</application> to use the
122 system shared <application>Zlib</application> library, apply the following
123 patch:</para>
124
125<screen><userinput>patch -Np1 -i ../cvs-&cvs-version;-zlib-1.patch</userinput></screen>
126
127 <para>Install <application>CVS</application> by running
128 the following commands:</para>
129
130<screen><userinput>./configure --prefix=/usr &amp;&amp;
131make</userinput></screen>
132
133 <para>If you have <!--<xref linkend="tetex"/> or--> <xref linkend="texlive"/>
134 installed and wish to create DVI, Postscript, HTML or text docs from the
135 documentation source files, issue the following command:</para>
136
137<screen><userinput>make -C doc html txt dvi ps</userinput></screen>
138
139 <para>To test the results, issue: <command>make check</command>. This will
140 take quite a while. If you don't have <command>rsh</command> configured for
141 access to the host you are building on (or you didn't pass the
142 <option>--with-rsh=</option> parameter to the <command>configure</command>
143 script, some tests may fail. If you passed the
144 <option>--with-rsh=ssh</option> parameter to enable <command>ssh</command>
145 as the default remote shell program, you'll need to issue the following
146 command so that the tests will complete without any failures:</para>
147
148<screen><userinput>sed -e 's/rsh};/ssh};/' \
149 -e 's/g=rw,o=r$/g=r,o=r/' \
150 -i src/sanity.sh</userinput></screen>
151
152 <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
153
154<screen role='root'><userinput>make install &amp;&amp;
155install -v -m755 -d /usr/share/doc/cvs-&cvs-version; &amp;&amp;
156install -v -m644 FAQ README /usr/share/doc/cvs-&cvs-version; &amp;&amp;
157install -v -m644 doc/*.pdf /usr/share/doc/cvs-&cvs-version;</userinput></screen>
158
159 <para>If you created any additional documentation, install it by issuing
160 the following commands as the
161 <systemitem class="username">root</systemitem> user:</para>
162
163<screen role='root'><userinput>install -v -m644 doc/*.{ps,dvi,txt} /usr/share/doc/cvs-&cvs-version; &amp;&amp;
164install -v -m755 -d /usr/share/doc/cvs-&cvs-version;/html/cvs{,client} &amp;&amp;
165install -v -m644 doc/cvs.html/* \
166 /usr/share/doc/cvs-&cvs-version;/html/cvs &amp;&amp;
167install -v -m644 doc/cvsclient.html/* \
168 /usr/share/doc/cvs-&cvs-version;/html/cvsclient</userinput></screen>
169
170 </sect2>
171
172 <sect2 role="configuration">
173 <title>Configuring CVS</title>
174
175 <sect3 id="cvs-config">
176 <title>Config Files</title>
177
178 <para><filename>~/.cvsrc</filename>, <filename>~/.cvswrappers</filename>,
179 and <filename>~/.cvspass</filename>.</para>
180
181 <indexterm zone="cvs cvs-config">
182 <primary sortas="e-AA.cvsrc">~/.cvsrc</primary>
183 </indexterm>
184
185 <indexterm zone="cvs cvs-config">
186 <primary sortas="e-AA.cvswrappers">~/.cvswrappers</primary>
187 </indexterm>
188
189 <indexterm zone="cvs cvs-config">
190 <primary sortas="e-AA.cvspass">~/.cvspass</primary>
191 </indexterm>
192
193 </sect3>
194
195 <sect3>
196 <title>Configuration Information</title>
197
198 <para><filename>~/.cvsrc</filename> is the main
199 <application>CVS</application> configuration file.
200 This file is used by users to specify defaults for different
201 <command>cvs</command> commands. For example, to make all
202 <command>cvs diff</command> commands run with <option>-u</option>, a user
203 would add <option>diff -u</option> to their <filename>.cvsrc</filename>
204 file.</para>
205
206 <para><filename>~/.cvswrappers</filename> specifies wrappers to be used in
207 addition to those specified in the <filename>CVSROOT/cvswrappers</filename>
208 file in the repository.</para>
209
210 <para><filename>~/.cvspass</filename> contains passwords used to complete
211 logins to servers.</para>
212
213 </sect3>
214
215 </sect2>
216
217 <sect2 role="content">
218 <title>Contents</title>
219
220 <segmentedlist>
221 <segtitle>Installed Programs</segtitle>
222 <segtitle>Installed Libraries</segtitle>
223 <segtitle>Installed Directories</segtitle>
224
225 <seglistitem>
226 <seg>cvs, cvsbug, and rcs2log</seg>
227 <seg>None</seg>
228 <seg>/usr/share/cvs and /usr/share/doc/cvs-&cvs-version;</seg>
229 </seglistitem>
230 </segmentedlist>
231
232 <variablelist>
233 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
234 <?dbfo list-presentation="list"?>
235 <?dbhtml list-presentation="table"?>
236
237 <varlistentry id="cvs-prog">
238 <term><command>cvs</command></term>
239 <listitem>
240 <para>is the main program file for the concurrent versions system.</para>
241 <indexterm zone="cvs cvs-prog">
242 <primary sortas="b-cvs">cvs</primary>
243 </indexterm>
244 </listitem>
245 </varlistentry>
246
247 <varlistentry id="cvsbug">
248 <term><command>cvsbug</command></term>
249 <listitem>
250 <para>is used to send problem reports about <application>CVS</application>
251 to a central support site.</para>
252 <indexterm zone="cvs cvsbug">
253 <primary sortas="b-cvsbug">cvsbug</primary>
254 </indexterm>
255 </listitem>
256 </varlistentry>
257
258 <varlistentry id="rcs2log">
259 <term><command>rcs2log</command></term>
260 <listitem>
261 <para>is a symlink to the contributed RCS to Change Log
262 generator.</para>
263 <indexterm zone="cvs rcs2log">
264 <primary sortas="b-rcs2log">rcs2log</primary>
265 </indexterm>
266 </listitem>
267 </varlistentry>
268 </variablelist>
269
270 </sect2>
271
272</sect1>
Note: See TracBrowser for help on using the repository browser.