source: archive/cvs.xml@ d1c51434

10.0 10.1 11.0 7.10 7.8 7.9 8.0 8.1 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind nosym perl-modules qt5new trunk xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since d1c51434 was d1c51434, checked in by Fernando de Oliveira <fernando@…>, 6 years ago
  • Update to x264-snapshot-20150908-2245.
  • Update to mplayer-SVN-r37520.
  • Remove "CVS-1.11.23" and "Running a CVS Server".
  • Update to joe-4.1.

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

  • Property mode set to 100644
File size: 10.6 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 &lfs77_checked; &gcc5_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="ftp://ftp.pdc.kth.se/pub/krb/src/">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>Now fix some conflicts with newer libraries and programs:</para>
128
129<screen><userinput>sed -i -e 's/getline /get_line /' lib/getline.{c,h} &amp;&amp;
130sed -i -e 's/^@sp$/&amp; 1/' doc/cvs.texinfo &amp;&amp;
131touch doc/*.pdf</userinput></screen>
132
133 <para>Install <application>CVS</application> by running
134 the following commands:</para>
135
136<screen><userinput>./configure --prefix=/usr --docdir=/usr/share/doc/cvs-&cvs-version; &amp;&amp;
137make</userinput></screen>
138
139 <para>If you wish to create HTML or text docs from the
140 documentation source files, issue the following command:</para>
141
142<screen><userinput>make -C doc html txt</userinput></screen>
143
144<!-- developer: test suite still fails, even if the modifications are made
145 and a further patch:
146 https://projects.archlinux.org/svntogit/packages.git/plain/trunk/cvs-1.11.23-sanity.patch?h=packages/cvs
147 is applied.-->
148<!-- <para>To test the results, issue: <command>make check</command>. This will
149 take quite a while. If you don't have <command>rsh</command> configured for
150 access to the host you are building on (or you didn't pass the
151 <option>-\-with-rsh=</option> parameter to the <command>configure</command>
152 script, some tests may fail. If you passed the
153 <option>-\-with-rsh=ssh</option> parameter to enable <command>ssh</command>
154 as the default remote shell program, you'll need to issue the following
155 command so that the tests will complete without any failures:</para>
156
157<screen><userinput>sed -e 's/rsh};/ssh};/' \
158 the string in following expression is not found anywhere in src/sanity.sh
159 -e 's/g=rw,o=r$/g=r,o=r/' \
160 -i src/sanity.sh</userinput></screen>-->
161
162 <para>This package does not come with a working test suite.</para>
163
164 <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
165
166<screen role='root'><userinput>make install &amp;&amp;
167make -C doc install-pdf &amp;&amp;
168install -v -m644 FAQ README /usr/share/doc/cvs-&cvs-version;</userinput></screen>
169
170 <para>If you created any additional documentation, install it by issuing
171 the following commands as the
172 <systemitem class="username">root</systemitem> user:</para>
173
174<screen role='root'><userinput>install -v -m644 doc/*.txt /usr/share/doc/cvs-&cvs-version; &amp;&amp;
175install -v -m755 -d /usr/share/doc/cvs-&cvs-version;/html/cvs{,client} &amp;&amp;
176install -v -m644 doc/cvs.html/* \
177 /usr/share/doc/cvs-&cvs-version;/html/cvs &amp;&amp;
178install -v -m644 doc/cvsclient.html/* \
179 /usr/share/doc/cvs-&cvs-version;/html/cvsclient</userinput></screen>
180
181 </sect2>
182
183 <sect2 role="commands">
184 <title>Command Explanations</title>
185
186 <para>
187 <option>--with-rsh=ssh</option>: Use this switch to enable
188 <command>ssh</command> as the default remote shell program.
189 </para>
190
191 </sect2>
192
193 <sect2 role="configuration">
194 <title>Configuring CVS</title>
195
196 <sect3 id="cvs-config">
197 <title>Config Files</title>
198
199 <para><filename>~/.cvsrc</filename>, <filename>~/.cvswrappers</filename>,
200 and <filename>~/.cvspass</filename>.</para>
201
202 <indexterm zone="cvs cvs-config">
203 <primary sortas="e-AA.cvsrc">~/.cvsrc</primary>
204 </indexterm>
205
206 <indexterm zone="cvs cvs-config">
207 <primary sortas="e-AA.cvswrappers">~/.cvswrappers</primary>
208 </indexterm>
209
210 <indexterm zone="cvs cvs-config">
211 <primary sortas="e-AA.cvspass">~/.cvspass</primary>
212 </indexterm>
213
214 </sect3>
215
216 <sect3>
217 <title>Configuration Information</title>
218
219 <para><filename>~/.cvsrc</filename> is the main
220 <application>CVS</application> configuration file.
221 This file is used by users to specify defaults for different
222 <command>cvs</command> commands. For example, to make all
223 <command>cvs diff</command> commands run with <option>-u</option>, a user
224 would add <option>diff -u</option> to their <filename>.cvsrc</filename>
225 file.</para>
226
227 <para><filename>~/.cvswrappers</filename> specifies wrappers to be used in
228 addition to those specified in the <filename>CVSROOT/cvswrappers</filename>
229 file in the repository.</para>
230
231 <para><filename>~/.cvspass</filename> contains passwords used to complete
232 logins to servers.</para>
233
234 </sect3>
235
236 </sect2>
237
238 <sect2 role="content">
239 <title>Contents</title>
240
241 <segmentedlist>
242 <segtitle>Installed Programs</segtitle>
243 <segtitle>Installed Libraries</segtitle>
244 <segtitle>Installed Directories</segtitle>
245
246 <seglistitem>
247 <seg>cvs, cvsbug, and rcs2log</seg>
248 <seg>None</seg>
249 <seg>/usr/share/cvs and /usr/share/doc/cvs-&cvs-version;</seg>
250 </seglistitem>
251 </segmentedlist>
252
253 <variablelist>
254 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
255 <?dbfo list-presentation="list"?>
256 <?dbhtml list-presentation="table"?>
257
258 <varlistentry id="cvs-prog">
259 <term><command>cvs</command></term>
260 <listitem>
261 <para>is the main program file for the concurrent versions system.</para>
262 <indexterm zone="cvs cvs-prog">
263 <primary sortas="b-cvs">cvs</primary>
264 </indexterm>
265 </listitem>
266 </varlistentry>
267
268 <varlistentry id="cvsbug">
269 <term><command>cvsbug</command></term>
270 <listitem>
271 <para>is used to send problem reports about <application>CVS</application>
272 to a central support site.</para>
273 <indexterm zone="cvs cvsbug">
274 <primary sortas="b-cvsbug">cvsbug</primary>
275 </indexterm>
276 </listitem>
277 </varlistentry>
278
279 <varlistentry id="rcs2log">
280 <term><command>rcs2log</command></term>
281 <listitem>
282 <para>is a symlink to the contributed RCS to Change Log
283 generator.</para>
284 <indexterm zone="cvs rcs2log">
285 <primary sortas="b-rcs2log">rcs2log</primary>
286 </indexterm>
287 </listitem>
288 </varlistentry>
289 </variablelist>
290
291 </sect2>
292
293</sect1>
Note: See TracBrowser for help on using the repository browser.