source: general/prog/subversion.xml@ 8aeb474

10.0 10.1 11.0 11.1 11.2 11.3 12.0 12.1 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 8aeb474 was 6508aec, checked in by Bruce Dubbs <bdubbs@…>, 12 years ago

Update to Subversion-1.7.6

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

  • Property mode set to 100644
File size: 16.3 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 subversion-download-http
8 "http://archive.apache.org/dist/subversion/subversion-&subversion-version;.tar.bz2">
9 <!ENTITY subversion-download-ftp " ">
10 <!ENTITY subversion-md5sum "4baa434db7709bb059b05d02a2547663">
11 <!ENTITY subversion-size "5.7 MB">
12 <!ENTITY subversion-buildsize "115 MB (703 MB with tests)">
13 <!ENTITY subversion-time "0.9 SBU (8.4 SBU with tests)">
14]>
15
16<sect1 id="subversion" xreflabel="Subversion-&subversion-version;">
17 <?dbhtml filename="subversion.html"?>
18
19 <sect1info>
20 <othername>$LastChangedBy$</othername>
21 <date>$Date$</date>
22 </sect1info>
23
24 <title>Subversion-&subversion-version;</title>
25
26 <indexterm zone="subversion">
27 <primary sortas="a-Subversion">Subversion</primary>
28 </indexterm>
29
30 <sect2 role="package">
31 <title>Introduction to Subversion</title>
32
33 <para>
34 <application>Subversion</application> is a version control system that is
35 designed to be a compelling replacement for <application>CVS</application>
36 in the open source community. It extends and enhances
37 <application>CVS</application>' feature set, while maintaining a similar
38 interface for those already familiar with <application>CVS</application>.
39 These instructions install the client and server software used to
40 manipulate a <application>Subversion</application> repository. Creation of
41 a repository is covered at <xref linkend="svnserver"/>.
42 </para>
43
44 &lfs72_checked;
45
46 <bridgehead renderas="sect3">Package Information</bridgehead>
47 <itemizedlist spacing="compact">
48 <listitem>
49 <para>
50 Download (HTTP): <ulink url="&subversion-download-http;"/>
51 </para>
52 </listitem>
53 <listitem>
54 <para>
55 Download (FTP): <ulink url="&subversion-download-ftp;"/>
56 </para>
57 </listitem>
58 <listitem>
59 <para>
60 Download MD5 sum: &subversion-md5sum;
61 </para>
62 </listitem>
63 <listitem>
64 <para>
65 Download size: &subversion-size;
66 </para>
67 </listitem>
68 <listitem>
69 <para>
70 Estimated disk space required: &subversion-buildsize;
71 </para>
72 </listitem>
73 <listitem>
74 <para>
75 Estimated build time: &subversion-time;
76 </para>
77 </listitem>
78 </itemizedlist>
79
80 <bridgehead renderas="sect3">Additional Downloads</bridgehead>
81 <itemizedlist spacing='compact'>
82 <listitem>
83 <para>Required patch: <ulink
84 url="&patch-root;/subversion-&subversion-version;-build_fixes-1.patch"/></para>
85 </listitem>
86 </itemizedlist>
87
88 <bridgehead renderas="sect3">Subversion Dependencies</bridgehead>
89
90 <bridgehead renderas="sect4">Required</bridgehead>
91 <para role="required">
92 <xref linkend="sqlite"/>,
93 <xref linkend="apr-util"/> and
94 <xref linkend="neon"/> or
95 <ulink url="http://code.google.com/p/serf/">serf</ulink>.
96 </para>
97
98 <para>
99 If you require the <application>Berkeley DB</application> back-end hooks
100 in <application>Subversion</application> to build or support BDB based
101 repositories, you must have <application>APR-util</application> linked to
102 the <application>Berkeley DB</application> library.
103 </para>
104
105 <bridgehead renderas="sect4">Optional</bridgehead>
106 <para role="optional">
107 <xref linkend="python2"/> (required to run the test suite),
108 <xref linkend="db"/>,
109 <xref linkend="cyrus-sasl"/>,
110 <xref linkend="openssl"/>,
111 <xref linkend="dbus-glib"/>,
112 <xref linkend="gnome-keyring"/>,
113 KWallet from KDE and
114 <xref linkend="apache"/>.
115 </para>
116
117 <bridgehead renderas="sect4">Optional (for the Java Bindings)</bridgehead>
118 <para role="optional">
119 One of <xref linkend="openjdk"/>,
120 <ulink url="http://www.inet.no/dante/">Dante</ulink>, or
121 <ulink url="http://oss.software.ibm.com/developerworks/opensource/jikes/">Jikes</ulink>,
122 and <xref linkend="junit"/> (to test the Java bindings)
123 </para>
124
125 <bridgehead renderas="sect4">Optional (for the SWIG Bindings)</bridgehead>
126 <para role="optional">
127 <ulink url="http://www.swig.org">SWIG</ulink> and
128 <xref linkend="python2"/>.
129 </para>
130
131 <para condition="html" role="usernotes">
132 User Notes: <ulink url="&blfs-wiki;/subversion"/>
133 </para>
134 </sect2>
135
136 <sect2 role="installation">
137 <title>Installation of Subversion</title>
138
139 <para>
140 Install <application>Subversion</application> by running the following
141 commands:
142 </para>
143
144<screen><userinput>patch -Np1 -i ../subversion-&subversion-version;-build_fixes-1.patch &amp;&amp;
145./configure --prefix=/usr --disable-static &amp;&amp;
146make</userinput></screen>
147
148 <para>
149 If you have <xref linkend="doxygen"/> installed and you wish to build the
150 API documentation, issue: <command>doxygen doc/doxygen.conf</command>.
151 </para>
152
153 <para>
154 If you passed the <option>--enable-javahl</option> parameter to
155 <command>configure</command> and wish to build the Java bindings, issue
156 the following command:
157 </para>
158
159<screen><userinput>make javahl</userinput></screen>
160
161 <para>
162 <application>Perl</application> and/or <application>Python</application>
163 <!-- ruby is currently b0rken <application>Ruby</application> -->
164 </para>
165
166 <para>
167 If you have a multi core CPU and normally run <command>make</command> with
168 multiple jobs (eg <command>make -j4</command>) then a bug in the
169 <filename>Makefile</filename> will prevent the
170 <application>Perl</application> bindings compiling correctly. Fix the
171 <filename>Makefile</filename> with this sed:
172 </para>
173
174<screen><userinput>sed -i 's#Makefile.PL.in$#&amp; libsvn_swig_perl#' Makefile.in &amp;&amp;</userinput></screen>
175
176 <para>
177 To compile the <application>Perl</application> and/or
178 <application>Python</application> bindings issue any or all of the
179 following commands:
180 </para>
181<screen><userinput>make swig-pl &amp;&amp;
182make swig-py</userinput></screen>
183
184<!-- &amp;&amp;
185make swig-rb -->
186
187 <para>
188 To test the results, issue: <command>make check</command>.
189 </para>
190
191 <para>
192 To test the results of the Java bindings build, issue
193 <command>make check-javahl</command>. Note you must have the
194 <application>JUnit</application> testing framework installed.
195 </para>
196
197 <para>
198 To test the results of any or all of the <application>SWIG</application>
199 bindings, you can use the following commands:
200 </para>
201
202<screen><userinput>make check-swig-pl &amp;&amp;
203make check-swig-py</userinput></screen>
204
205<!-- &amp;&amp;
206make check-swig-rb -->
207
208 <para>
209 Now, as the <systemitem class="username">root</systemitem> user:
210 </para>
211
212<screen role="root"><userinput>make install &amp;&amp;
213install -v -m755 -d /usr/share/doc/subversion-&subversion-version; &amp;&amp;
214cp -v -R doc/* \
215 /usr/share/doc/subversion-&subversion-version;</userinput></screen>
216
217 <para>
218 If you built the Java bindings, issue the following command as the
219 <systemitem class="username">root</systemitem> user to install them:
220 </para>
221
222<screen role="root"><userinput>make install-javahl</userinput></screen>
223
224 <para>
225 If you built any of the <application>SWIG</application> bindings, issue
226 any or all of the following commands as the
227 <systemitem class="username">root</systemitem> user to install them:
228 </para>
229
230<screen role="root"><userinput>make install-swig-pl &amp;&amp;
231make install-swig-py</userinput></screen>
232
233<!-- &amp;&amp;
234make install-swig-rb -->
235
236 <para>
237 In order for <application>Python</application> to automatically discover
238 the bindings, add
239 <filename class="directory">/usr/lib/svn-python</filename> to the
240 <envar>PYTHONPATH</envar> environment variable to the system or personal
241 profiles.
242 </para>
243 </sect2>
244
245 <sect2 role="commands">
246 <title>Command Explanations</title>
247
248 <para>
249 <option>--disable-static</option>: This stops it installing static
250 versions of the libraries.
251 </para>
252
253<!-- <para>
254 <parameter>CC="gcc -std=gnu99"</parameter>: If you want to compile
255 <filename class="libraryfile">mod_dav_svn.so</filename> to use with
256 <application>Apache</application>, configure will complain that your C
257 compiler is not the same as the one that compiled
258 <application>Apache</application>. To prevent this happening you can add
259 <parameter>CC="gcc -std=gnu99"</parameter> (or whatever
260 <application>Apache</application> used) to the
261 <command>configure</command> options.
262 </para> -->
263 </sect2>
264
265 <sect2 role="configuration">
266 <title>Configuring Subversion</title>
267
268 <sect3 id="subversion-config">
269 <title>Config Files</title>
270
271 <para>
272 <filename>~/.subversion/config</filename> and
273 <filename>/etc/subversion/config</filename>
274 </para>
275
276 <indexterm zone="subversion subversion-config">
277 <primary sortas="e-AA.subversion/config">~/.subversion/config</primary>
278 </indexterm>
279
280 <indexterm zone="subversion subversion-config">
281 <primary sortas="e-etc-subversion-config">/etc/subversion/config</primary>
282 </indexterm>
283 </sect3>
284
285 <sect3>
286 <title>Configuration Information</title>
287
288 <para>
289 <filename>/etc/subversion/config</filename> is the
290 <application>Subversion</application> system-wide configuration file.
291 This file is used to specify defaults for different
292 <command>svn</command> commands.
293 </para>
294
295 <para>
296 <filename>~/.subversion/config</filename> is the user's personal
297 configuration file. It is used to override the system-wide defaults set
298 in <filename>/etc/subversion/config</filename>.
299 </para>
300 </sect3>
301 </sect2>
302
303 <sect2 role="content">
304 <title>Contents</title>
305
306 <segmentedlist>
307 <segtitle>Installed Programs</segtitle>
308 <segtitle>Installed Libraries</segtitle>
309 <segtitle>Installed Directories</segtitle>
310
311 <seglistitem>
312 <seg>
313 svn, svnadmin, svndumpfilter, svnlook, svnserve, svnsync and
314 svnversion
315 </seg>
316 <seg>
317 libsvn*.so and optionally, a Java library, the mod_dav_svn.so, and
318 and mod_authz_svn.so <application>Apache HTTP</application> DSO
319 modules and various <application>Perl</application> and
320 <application>Python</application>
321 <!-- <application>Ruby</application> --> modules.
322 </seg>
323 <seg>
324 /usr/include/subversion-1,
325 /usr/lib/perl5/site_perl/&lfs-perl-version;/auto/SVN (optional),
326 /usr/lib/perl5/site_perl/&lfs-perl-version;/SVN (optional),
327 /usr/lib/ruby/site_ruby/&lt;x.y&gt;/i686-linux/svn (al),
328 /usr/lib/svn-javahl (optional),
329 /usr/lib/svn-python (optional) and
330 /usr/share/doc/subversion-&subversion-version;
331 </seg>
332 </seglistitem>
333 </segmentedlist>
334
335 <variablelist>
336 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
337 <?dbfo list-presentation="list"?>
338 <?dbhtml list-presentation="table"?>
339
340 <varlistentry id="svn">
341 <term><command>svn</command></term>
342 <listitem>
343 <para>
344 is a command-line client program used to access
345 <application>Subversion</application> repositories.
346 </para>
347 <indexterm zone="subversion svn">
348 <primary sortas="b-svn">svn</primary>
349 </indexterm>
350 </listitem>
351 </varlistentry>
352
353 <varlistentry id="svnadmin">
354 <term><command>svnadmin</command></term>
355 <listitem>
356 <para>
357 is a tool for creating, tweaking or repairing a
358 <application>Subversion</application> repository.
359 </para>
360 <indexterm zone="subversion svnadmin">
361 <primary sortas="b-svnadmin">svnadmin</primary>
362 </indexterm>
363 </listitem>
364 </varlistentry>
365
366 <varlistentry id="svndumpfilter">
367 <term><command>svndumpfilter</command></term>
368 <listitem>
369 <para>
370 is a program for filtering <application>Subversion</application>
371 repository dumpfile format streams.
372 </para>
373 <indexterm zone="subversion svndumpfilter">
374 <primary sortas="b-svndumpfilter">svndumpfilter</primary>
375 </indexterm>
376 </listitem>
377 </varlistentry>
378
379 <varlistentry id="svnlook">
380 <term><command>svnlook</command></term>
381 <listitem>
382 <para>
383 is a tool for inspecting a <application>Subversion</application>
384 repository.
385 </para>
386 <indexterm zone="subversion svnlook">
387 <primary sortas="b-svnlook">svnlook</primary>
388 </indexterm>
389 </listitem>
390 </varlistentry>
391
392 <varlistentry id="svnrdump">
393 <term><command>svnrdump</command></term>
394 <listitem>
395 <para>
396 is a tool for dumping or loading a remote
397 <application>Subversion</application> repository.
398 </para>
399 <indexterm zone="subversion svnrdump">
400 <primary sortas="b-svnrdump">svnrdump</primary>
401 </indexterm>
402 </listitem>
403 </varlistentry>
404
405 <varlistentry id="svnserve">
406 <term><command>svnserve</command></term>
407 <listitem>
408 <para>
409 is a custom standalone server program, able to run as a daemon
410 process or invoked by SSH.
411 </para>
412 <indexterm zone="subversion svnserve">
413 <primary sortas="b-svnserve">svnserve</primary>
414 </indexterm>
415 </listitem>
416 </varlistentry>
417
418 <varlistentry id="svnsync">
419 <term><command>svnsync</command></term>
420 <listitem>
421 <para>
422 is a <application>Subversion</application> repository
423 synchronisation tool.
424 </para>
425 <indexterm zone="subversion svnsync">
426 <primary sortas="b-svnsync">svnsync</primary>
427 </indexterm>
428 </listitem>
429 </varlistentry>
430
431 <varlistentry id="svnversion">
432 <term><command>svnversion</command></term>
433 <listitem>
434 <para>
435 is used to report the version number and state of a working
436 <application>Subversion</application> repository copy.
437 </para>
438 <indexterm zone="subversion svnversion">
439 <primary sortas="b-svnversion">svnversion</primary>
440 </indexterm>
441 </listitem>
442 </varlistentry>
443
444 <varlistentry id="libsvn_star">
445 <term><filename class="libraryfile">libsvn_*.so</filename></term>
446 <listitem>
447 <para>
448 are the support libraries used by the
449 <application>Subversion</application> programs.
450 </para>
451 <indexterm zone="subversion libsvn_star">
452 <primary sortas="c-libsvn_star">libsvn_*.so</primary>
453 </indexterm>
454 </listitem>
455 </varlistentry>
456
457 <varlistentry id="mod_authz_svn">
458 <term><filename class="libraryfile">mod_authz_svn.so</filename></term>
459 <listitem>
460 <para>
461 is a plug-in module for the <application>Apache</application> HTTP
462 server, used to authenticate users to a
463 <application>Subversion</application> repository over the Internet
464 or an intranet.
465 </para>
466 <indexterm zone="subversion mod_authz_svn">
467 <primary sortas="c-mod_authz_svn">mod_authz_svn.so</primary>
468 </indexterm>
469 </listitem>
470 </varlistentry>
471
472 <varlistentry id="mod_dav_svn">
473 <term><filename class="libraryfile">mod_dav_svn.so</filename></term>
474 <listitem>
475 <para>
476 is a plug-in module for the <application>Apache</application> HTTP
477 server, used to make a <application>Subversion</application>
478 repository available to others over the Internet or an intranet.
479 </para>
480 <indexterm zone="subversion mod_dav_svn">
481 <primary sortas="c-mod_authz_svn">mod_dav_svn.so</primary>
482 </indexterm>
483 </listitem>
484 </varlistentry>
485 </variablelist>
486 </sect2>
487</sect1>
Note: See TracBrowser for help on using the repository browser.