source: basicnet/netprogs/subversion.xml@ 7e1f3aa

10.0 10.1 11.0 11.1 11.2 11.3 12.0 12.1 6.2 6.2.0 6.2.0-rc1 6.2.0-rc2 6.3 6.3-rc1 6.3-rc2 6.3-rc3 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 kea ken/TL2024 ken/inkscape-core-mods ken/tuningfonts krejzi/svn lazarus lxqt nosym perl-modules plabs/newcss plabs/python-mods python3.11 qt5new rahul/power-profiles-daemon renodr/vulkan-addition systemd-11177 systemd-13485 trunk upgradedb xry111/intltool xry111/llvm18 xry111/soup3 xry111/test-20220226 xry111/xf86-video-removal
Last change on this file since 7e1f3aa was 061ec9d, checked in by Randy McMurchy <randy@…>, 18 years ago

Added the 'User Notes' wiki link to each package page; changed all instances of .[so,a] to .{so,a} (brackets changed to braces); changed all replaceable tags to use angle brackets instead of square brackets to encapsulate the text - commit #1

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@5829 af4574ff-66df-0310-9fd7-8a98e5e911e0
  • Property mode set to 100644
File size: 18.5 KB
Line 
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
3 "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
4 <!ENTITY % general-entities SYSTEM "../../general.ent">
5 %general-entities;
6
7 <!ENTITY subversion-download-http "http://subversion.tigris.org/tarballs/subversion-&subversion-version;.tar.bz2">
8 <!ENTITY subversion-download-ftp " ">
9 <!ENTITY subversion-md5sum "07b95963968ae345541ca99d0e7bf082">
10 <!ENTITY subversion-size "6.7 MB">
11
12 <!ENTITY subversion-buildsize "100 MB (additional 57 MB to install all bindings and 465 MB to run all test suites)">
13 <!ENTITY subversion-time "1.7 SBU (add 1.1 SBU for bindings and 20-60 minutes to run test suites)">
14
15 <!ENTITY svn-neon-version "0.25.5">
16]>
17
18<sect1 id="subversion" xreflabel="Subversion-&subversion-version;">
19 <?dbhtml filename="subversion.html"?>
20
21 <sect1info>
22 <othername>$LastChangedBy$</othername>
23 <date>$Date$</date>
24 <keywordset>
25 <keyword role="package">subversion-&subversion-version;.tar</keyword>
26 <keyword role="ftpdir">subversion</keyword>
27 </keywordset>
28 </sect1info>
29
30 <title>Subversion-&subversion-version;</title>
31
32 <indexterm zone="subversion">
33 <primary sortas="a-Subversion">Subversion</primary>
34 </indexterm>
35
36 <sect2 role="package">
37 <title>Introduction to Subversion</title>
38
39 <para><application>Subversion</application> is a version control
40 system that is designed to be a compelling replacement for
41 <application>CVS</application> in the open source community. It
42 extends and enhances <application>CVS</application>' feature set,
43 while maintaining a similar interface for those already familiar with
44 <application>CVS</application>. These instructions install the client
45 and server software used to manipulate a
46 <application>Subversion</application> repository. Creation of a repository
47 is covered at <xref linkend="svnserver"/>.</para>
48
49 <bridgehead renderas="sect3">Package Information</bridgehead>
50 <itemizedlist spacing="compact">
51 <listitem>
52 <para>Download (HTTP): <ulink url="&subversion-download-http;"/></para>
53 </listitem>
54 <listitem>
55 <para>Download (FTP): <ulink url="&subversion-download-ftp;"/></para>
56 </listitem>
57 <listitem>
58 <para>Download MD5 sum: &subversion-md5sum;</para>
59 </listitem>
60 <listitem>
61 <para>Download size: &subversion-size;</para>
62 </listitem>
63 <listitem>
64 <para>Estimated disk space required: &subversion-buildsize;</para>
65 </listitem>
66 <listitem>
67 <para>Estimated build time: &subversion-time;</para>
68 </listitem>
69 </itemizedlist>
70
71 <!--
72 <bridgehead renderas="sect3">Additional Downloads</bridgehead>
73 <itemizedlist spacing="compact">
74 <listitem>
75 <para>Required patch if using
76 <application>Swig</application>-1.3.25 and you wish
77 to build the <application>Perl</application> bindings: <ulink
78 url="&patch-root;/patches/subversion-&subversion-version;-swig_1.3.25-1.patch"/></para>
79 </listitem>
80 </itemizedlist>
81 -->
82
83 <bridgehead renderas="sect3">Subversion Dependencies</bridgehead>
84
85 <bridgehead renderas="sect4">Optional</bridgehead>
86 <para role="optional"><xref linkend="python"/>
87 (required to run the test suite),
88 <!-- <xref linkend="db"/>, -->
89 <xref linkend="apache"/> or
90 <ulink url="http://apr.apache.org/">Apache Portable Runtime</ulink>,
91 <ulink url="http://www.webdav.org/neon/">neon-&svn-neon-version;</ulink>,
92 <xref linkend="jdk"/> (to build the Java bindings),
93 <ulink url="http://www.junit.org/">JUnit</ulink>
94 (required for running the Java bindings test suite and requires
95 <xref linkend="unzip"/>),
96 <ulink url="http://www.inet.no/dante/">Dante</ulink>
97 (alternate Java compiler), and
98 <ulink url="http://oss.software.ibm.com/developerworks/opensource/jikes/">
99 Jikes</ulink> (another alternate Java compiler)</para>
100
101 <bridgehead renderas="sect4">Optional for the Bundled Version of
102 <application>Neon</application></bridgehead>
103 <para role="optional"><xref linkend="pkgconfig"/>,
104 <xref linkend="libxml2"/> or <xref linkend="expat"/>,
105 <xref linkend="openssl"/>,
106 <xref linkend="heimdal"/> or <xref linkend="mitkrb"/></para>
107
108 <bridgehead renderas="sect4">Optional for the Bundled Version of
109 <application>Apache Portable Runtime</application></bridgehead>
110 <para role="optional"><xref linkend="expat"/> and
111 <xref linkend="gdbm"/></para>
112 <!-- <xref linkend="db"/>, -->
113
114 <bridgehead renderas="sect4">Optional to Build the
115 <application>SWIG</application> Bindings</bridgehead>
116 <para role="optional"><ulink url="http://www.swig.org">SWIG</ulink>,
117 <xref linkend="python"/>, and
118 <xref linkend="ruby"/></para>
119
120 <para>Note that the <application>Python</application>,
121 <application>Perl</application> and <application>Ruby</application>
122 bindings will not compile properly with the current version of
123 <application>SWIG</application>. To build the bindings, you must have
124 <application>SWIG</application>-1.3.{24,25} installed. Complete
125 instructions for building the <application>SWIG</application> bindings
126 can be found in the <application>Subversion</application> source tree
127 file <filename>./subversion/bindings/swig/INSTALL</filename>.</para>
128
129 <para condition="html" role="usernotes">User Notes:
130 <ulink url="&blfs-wiki;/subversion"/></para>
131
132 </sect2>
133
134 <sect2 role="installation">
135 <title>Installation of Subversion</title>
136
137 <caution>
138 <para>For reasons that are not yet fully understood,
139 <application>Subversion</application> repositories based on some versions
140 of <application>Berkeley DB</application> (notably 4.4.x) may not perform
141 reliably. Though there have been no reports of corrupted databases caused
142 by this issue, the <application>Subversion</application> test suite may
143 report a failure in one of the tests due to problems opening a repository
144 based on <application>Berkeley DB</application>. This issue only affects
145 BDB-based repositories on a local installation and does not affect access
146 to a BDB-based repository on a remote system built with older versions of
147 <application>Subversion</application> or
148 <application>Berkeley DB</application>.</para>
149
150 <para>For these reasons, the <application>Berkeley DB</application>
151 back-end is disabled, and any local BDB-based repositories you may have
152 will be unavailable after installing <application>Subversion</application>
153 using the following instructions. Please reference the information at
154 <ulink
155 url="http://svnbook.red-bean.com/en/1.1/ch05s03.html#svn-ch-5-sect-3.5"/>
156 if you need to migrate your repositores.</para>
157 </caution>
158
159 <para>Install <application>Subversion</application> by running the
160 following commands:</para>
161
162<screen><userinput>./configure --prefix=/usr \
163 --without-berkeley-db \
164 --with-installbuilddir=/usr/lib/apr-0 &amp;&amp;
165make</userinput></screen>
166
167 <note>
168 <para>If you have <application>Apache</application> installed, pass
169 the <option>--with-apr=/usr</option> and
170 <option>--with-apr-util=/usr</option> switches to the
171 <command>configure</command> script. Otherwise,
172 <application>Subversion</application> will overwrite APR and APR-utils
173 from the <application>Apache</application> installation with the source
174 distribution files. You may also need to pass
175 <option>--with-apxs=/usr/sbin/apxs</option> as <command>apxs</command>
176 might not be in an unprivileged user's <envar>PATH</envar> and won't be
177 properly discovered. Additionally if you have
178 <application>Apache</application> installed, you may safely remove the
179 <parameter>--with-installbuilddir=/usr/lib/apr-0</parameter> parameter
180 as it will have no effect.</para>
181 </note>
182
183 <para>If you passed the <option>--enable-javahl</option> parameter to
184 <command>configure</command> and wish to build the Java bindings, issue
185 the following command:</para>
186
187<screen><userinput>make javahl</userinput></screen>
188
189 <para>If you passed the <option>-with-swig</option> parameter to
190 <command>configure</command> and wish to build the
191 <application>Perl</application>, <application>Python</application> and/or
192 <application>Ruby</application> bindings, issue any or all of the following
193 commands:</para>
194
195<screen><userinput>make swig-pl &amp;&amp;
196make swig-py &amp;&amp;
197make swig-rb</userinput></screen>
198
199 <para>To test the results of the <application>Subversion</application>
200 build, issue: <command>make check</command>. This will take quite a long
201 time.</para>
202
203 <note>
204 <para>The <computeroutput>fs-base-test</computeroutput> is known to fail
205 with issues surrounding the Berkely database installation. As mentioned
206 earlier, it is not yet fully understood why this test fails.</para>
207 </note>
208
209 <para>To test the results of the Java bindings build, issue
210 <command>make check-javahl</command>. Note you must have the
211 <application>JUnit</application> (version 3.8.x) testing framework
212 installed.</para>
213
214 <para>To test the results of any or all of the
215 <application>SWIG</application> bindings, you can use the following
216 commands:</para>
217
218<screen><userinput>make check-swig-pl &amp;&amp;
219make check-swig-py &amp;&amp;
220make check-swig-rb</userinput></screen>
221
222 <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
223
224<screen role='root'><userinput>make install &amp;&amp;
225rm doc/{Makefile,doxygen.conf} &amp;&amp;
226find doc -type d -exec chmod 755 {} \; &amp;&amp;
227find doc -type f -exec chmod 644 {} \; &amp;&amp;
228install -v -m755 -d /usr/share/doc/subversion-&subversion-version; &amp;&amp;
229cp -v -R doc/* /usr/share/doc/subversion-&subversion-version;</userinput></screen>
230
231 <para>If you built the Java bindings, issue the following command
232 as the <systemitem class="username">root</systemitem> user to install
233 them:</para>
234
235<screen role='root'><userinput>make install-javahl</userinput></screen>
236
237 <para>If you built any of the <application>SWIG</application> bindings,
238 issue any or all of the following commands as the
239 <systemitem class="username">root</systemitem> user to install them:</para>
240
241<screen role='root'><userinput>make install-swig-pl &amp;&amp;
242
243make install-swig-py &amp;&amp;
244echo /usr/lib/svn-python \
245 &gt; /usr/lib/python2.4/site-packages/subversion.pth &amp;&amp;
246
247make install-swig-rb</userinput></screen>
248
249 </sect2>
250
251 <sect2 role="commands">
252 <title>Command Explanations</title>
253
254 <para><parameter>--with-installbuilddir=/usr/lib/apr-0</parameter>:
255 This parameter is used (and only has an effect if you used the source
256 provided version of Apache Portable Runtime) to force the installation
257 of some APR-related support programs to
258 <filename class="directory">/usr/lib/apr-0</filename> instead of
259 <filename class="directory">/usr/build</filename>.</para>
260
261 <para><option>--with-neon=<replaceable>&lt;prefix&gt;</replaceable></option>:
262 This option should be used if you wish to use a system-installed version
263 of <application>neon</application>.</para>
264
265 <para><option>--with-ssl</option>: This switch enables
266 <application>OpenSSL</application> support in
267 <application>neon</application> (only required if you use the bundled
268 version of <application>neon</application>).</para>
269
270 </sect2>
271
272 <sect2 role="configuration">
273 <title>Configuring Subversion</title>
274
275 <sect3 id="subversion-config">
276 <title>Config Files</title>
277
278 <para><filename>~/.subversion/config</filename> and
279 <filename>/etc/subversion/config</filename></para>
280
281 <indexterm zone="subversion subversion-config">
282 <primary sortas="e-AA.subversion/config">~/.subversion/config</primary>
283 </indexterm>
284
285 <indexterm zone="subversion subversion-config">
286 <primary sortas="e-etc-subversion-config">/etc/subversion/config</primary>
287 </indexterm>
288
289 </sect3>
290
291 <sect3>
292 <title>Configuration Information</title>
293
294 <para><filename>/etc/subversion/config</filename> is the
295 <application>Subversion</application> system-wide configuration file.
296 This file is used to specify defaults for different
297 <command>svn</command> commands.</para>
298
299 <para><filename>~/.subversion/config</filename> is the user's personal
300 configuration file. It is used to override the system-wide defaults
301 set in <filename>/etc/subversion/config</filename>.</para>
302
303 </sect3>
304
305 </sect2>
306
307 <sect2 role="content">
308 <title>Contents</title>
309
310 <segmentedlist>
311 <segtitle>Installed Programs</segtitle>
312 <segtitle>Installed Libraries</segtitle>
313 <segtitle>Installed Directories</segtitle>
314
315 <seglistitem>
316 <seg>svn, svnadmin, svndumpfilter, svnlook, svnserve, svnversion, and
317 optionally, neon-config and apr-config</seg>
318 <seg>libsvn*.{so,a} and optionally, libneon.{so,a} and the mod_dav_svn.so,
319 and mod_authz_svn.so <application>Apache HTTP</application>
320 DSO modules</seg>
321 <seg>/etc/subversion, /usr/include/neon (optional), /usr/include/subversion-1,
322 /usr/lib/perl5/site_perl/&lfs-perl-version;/i686-linux/auto/SVN (optional),
323 /usr/lib/perl5/site_perl/&lfs-perl-version;/i686-linux/SVN (optional),
324 /usr/lib/svn-javahl (optional), /usr/lib/svn-python (optional),
325 /usr/share/doc/neon-&svn-neon-version; (optional), and
326 /usr/share/doc/subversion-&subversion-version;</seg>
327 </seglistitem>
328 </segmentedlist>
329
330 <variablelist>
331 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
332 <?dbfo list-presentation="list"?>
333 <?dbhtml list-presentation="table"?>
334
335 <varlistentry id="svn">
336 <term><command>svn</command></term>
337 <listitem>
338 <para>is a command-line client program used to access
339 <application>Subversion</application> repositories.</para>
340 <indexterm zone="subversion svn">
341 <primary sortas="b-svn">svn</primary>
342 </indexterm>
343 </listitem>
344 </varlistentry>
345
346 <varlistentry id="svnadmin">
347 <term><command>svnadmin</command></term>
348 <listitem>
349 <para>is a tool for creating, tweaking or repairing a
350 <application>Subversion</application> repository.</para>
351 <indexterm zone="subversion svnadmin">
352 <primary sortas="b-svnadmin">svnadmin</primary>
353 </indexterm>
354 </listitem>
355 </varlistentry>
356
357 <varlistentry id="svndumpfilter">
358 <term><command>svndumpfilter</command></term>
359 <listitem>
360 <para>is a program for filtering <application>Subversion</application>
361 repository dumpfile format streams.</para>
362 <indexterm zone="subversion svndumpfilter">
363 <primary sortas="b-svndumpfilter">svndumpfilter</primary>
364 </indexterm>
365 </listitem>
366 </varlistentry>
367
368 <varlistentry id="svnlook">
369 <term><command>svnlook</command></term>
370 <listitem>
371 <para>is a tool for inspecting a
372 <application>Subversion</application> repository.</para>
373 <indexterm zone="subversion svnlook">
374 <primary sortas="b-svnlook">svnlook</primary>
375 </indexterm>
376 </listitem>
377 </varlistentry>
378
379 <varlistentry id="svnserve">
380 <term><command>svnserve</command></term>
381 <listitem>
382 <para>is a custom standalone server program, able to run as a
383 daemon process or invoked by SSH.</para>
384 <indexterm zone="subversion svnserve">
385 <primary sortas="b-svnserve">svnserve</primary>
386 </indexterm>
387 </listitem>
388 </varlistentry>
389
390 <varlistentry id="svnversion">
391 <term><command>svnversion</command></term>
392 <listitem>
393 <para>is used to report the version number and state of a
394 working <application>Subversion</application> repository copy.</para>
395 <indexterm zone="subversion svnversion">
396 <primary sortas="b-svnversion">svnversion</primary>
397 </indexterm>
398 </listitem>
399 </varlistentry>
400
401 <varlistentry id="neon-config">
402 <term><command>neon-config</command></term>
403 <listitem>
404 <para>is a script which provides information about an installed
405 copy of the <application>neon</application> library.</para>
406 <indexterm zone="subversion neon-config">
407 <primary sortas="b-neon-config">neon-config</primary>
408 </indexterm>
409 </listitem>
410 </varlistentry>
411
412 <varlistentry id="libsvn_star">
413 <term><filename class='libraryfile'>libsvn_*.{so,a}</filename></term>
414 <listitem>
415 <para>are the support libraries used by the
416 <application>Subversion</application> programs.</para>
417 <indexterm zone="subversion libsvn_star">
418 <primary sortas="c-libsvn_star">libsvn_*.{so,a}</primary>
419 </indexterm>
420 </listitem>
421 </varlistentry>
422
423 <varlistentry id="libneon">
424 <term><filename class='libraryfile'>libneon.{so,a}</filename></term>
425 <listitem>
426 <para>is used as a high-level interface to common
427 HTTP and WebDAV methods.</para>
428 <indexterm zone="subversion libneon">
429 <primary sortas="c-libneon">libneon.{so,a}</primary>
430 </indexterm>
431 </listitem>
432 </varlistentry>
433
434 <varlistentry id="mod_authz_svn">
435 <term><filename class='libraryfile'>mod_authz_svn.so</filename></term>
436 <listitem>
437 <para>is a plug-in module for the <application>Apache</application>
438 HTTP server, used to authenticate users to a
439 <application>Subversion</application> repository over the Internet or an
440 intranet.</para>
441 <indexterm zone="subversion mod_authz_svn">
442 <primary sortas="c-mod_authz_svn">mod_authz_svn.so</primary>
443 </indexterm>
444 </listitem>
445 </varlistentry>
446
447 <varlistentry id="mod_dav_svn">
448 <term><filename class='libraryfile'>mod_dav_svn.so</filename></term>
449 <listitem>
450 <para>is a plug-in module for the <application>Apache</application>
451 HTTP server, used to make a
452 <application>Subversion</application> repository available to others over the
453 Internet or an intranet.</para>
454 <indexterm zone="subversion mod_dav_svn">
455 <primary sortas="c-mod_authz_svn">mod_dav_svn.so</primary>
456 </indexterm>
457 </listitem>
458 </varlistentry>
459
460 </variablelist>
461
462 </sect2>
463
464</sect1>
Note: See TracBrowser for help on using the repository browser.