source: archive/cvs.xml@ 45ab6c7

11.0 qt5new trunk
Last change on this file since 45ab6c7 was 45ab6c7, checked in by Xi Ruoyao <xry111@…>, 5 months ago

more SVN prop clean up

Remove "$LastChanged$" everywhere, and also some unused $Date$

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