source: general/prog/subversion.xml@ 59a6b63

10.0 10.1 11.0 11.1 11.2 11.3 12.0 12.1 7.10 7.8 7.9 8.0 8.1 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind kea ken/TL2024 ken/inkscape-core-mods ken/tuningfonts lazarus lxqt nosym perl-modules plabs/newcss plabs/python-mods python3.11 qt5new rahul/power-profiles-daemon renodr/vulkan-addition trunk upgradedb xry111/intltool xry111/llvm18 xry111/soup3 xry111/test-20220226 xry111/xf86-video-removal
Last change on this file since 59a6b63 was 59a6b63, checked in by Fernando de Oliveira <fernando@…>, 9 years ago
  • Update to tcsh-6.19.00.
  • Update to fribidi-0.19.7.
  • Update to subversion-1.9.0.
  • Update to mariadb-10.0.21.
  • Update to firefox-39.0.3.
  • SDL-1.2.15: Move "--disable-sdl-dlopen" to option.

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@16332 af4574ff-66df-0310-9fd7-8a98e5e911e0
  • Property mode set to 100644
File size: 17.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 subversion-download-http
8 "http://archive.apache.org/dist/subversion/subversion-&subversion-version;.tar.bz2">-->
9 <!ENTITY subversion-download-http
10 "http://www.apache.org/dist/subversion/subversion-&subversion-version;.tar.bz2">
11 <!ENTITY subversion-download-ftp " ">
12 <!ENTITY subversion-md5sum "20ae7b0d4ef07eeaf73eb4e23317b495">
13 <!ENTITY subversion-size "7.4 MB">
14 <!ENTITY subversion-buildsize "174 MB (436 MB with all bindings and API documentation built; additional 785 MB for tests)">
15 <!ENTITY subversion-time "1 SBU (2.8 SBU with all bindings and API documentation built; additional 68 SBU for tests)">
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 </sect1info>
25
26 <title>Subversion-&subversion-version;</title>
27
28 <indexterm zone="subversion">
29 <primary sortas="a-Subversion">Subversion</primary>
30 </indexterm>
31
32 <sect2 role="package">
33 <title>Introduction to Subversion</title>
34
35 <para>
36 <application>Subversion</application> is a version control system that is
37 designed to be a compelling replacement for <application>CVS</application>
38 in the open source community. It extends and enhances
39 <application>CVS</application>' feature set, while maintaining a similar
40 interface for those already familiar with <application>CVS</application>.
41 These instructions install the client and server software used to
42 manipulate a <application>Subversion</application> repository. Creation of
43 a repository is covered at <xref linkend="svnserver"/>.
44 </para>
45
46 &lfs77_checked; &gcc5_checked;
47
48 <bridgehead renderas="sect3">Package Information</bridgehead>
49 <itemizedlist spacing="compact">
50 <listitem>
51 <para>
52 Download (HTTP): <ulink url="&subversion-download-http;"/>
53 </para>
54 </listitem>
55 <listitem>
56 <para>
57 Download (FTP): <ulink url="&subversion-download-ftp;"/>
58 </para>
59 </listitem>
60 <listitem>
61 <para>
62 Download MD5 sum: &subversion-md5sum;
63 </para>
64 </listitem>
65 <listitem>
66 <para>
67 Download size: &subversion-size;
68 </para>
69 </listitem>
70 <listitem>
71 <para>
72 Estimated disk space required: &subversion-buildsize;
73 </para>
74 </listitem>
75 <listitem>
76 <para>
77 Estimated build time: &subversion-time;
78 </para>
79 </listitem>
80 </itemizedlist>
81
82 <bridgehead renderas="sect3">Subversion Dependencies</bridgehead>
83
84 <bridgehead renderas="sect4">Required</bridgehead>
85 <para role="required">
86 <xref linkend="apr-util"/> and
87 <xref linkend="sqlite"/>
88 </para>
89
90 <bridgehead renderas="sect4">Recommended</bridgehead>
91 <para role="recommended">
92 <xref linkend="serf"/> (for handling http:// and https:// URLs)
93 </para>
94
95<!-- support for berkeley db is deprecated since 1.8
96 <note>
97 <para>
98 If you require the <application>Berkeley DB</application> back-end hooks
99 in <application>Subversion</application> to build or support BDB based
100 repositories, you must have <application>APR-util</application> linked to
101 the <application>Berkeley DB</application> library.
102 </para>
103 </note>
104-->
105
106 <bridgehead renderas="sect4">Optional</bridgehead>
107 <para role="optional">
108 <xref linkend="apache"/>,
109<!-- support for berkeley db is deprecated since 1.8
110 <xref linkend="db"/>,
111-->
112 <xref linkend="cyrus-sasl"/>,
113 <xref linkend="dbus"/>,
114 <xref linkend="kdelibs"/> (for <ulink url="http://utils.kde.org/projects/kwalletmanager/">KWallet</ulink> support),
115 <xref linkend="python2"/> (with sqlite support for the tests),
116 <xref linkend="ruby"/>, and
117 <xref linkend="swig"/> (for building Perl, Python and Ruby bindings)
118 </para>
119
120 <bridgehead renderas="sect4">Optional (for the Java Bindings)</bridgehead>
121 <para role="optional">
122 One of <xref linkend="openjdk"/>,
123 <ulink url="http://www.inet.no/dante/">Dante</ulink> or
124 <ulink url="http://jikes.sourceforge.net/">Jikes</ulink>,
125 and <xref linkend="junit"/> (to test the Java bindings)
126 </para>
127
128 <para condition="html" role="usernotes">
129 User Notes: <ulink url="&blfs-wiki;/subversion"/>
130 </para>
131 </sect2>
132
133 <sect2 role="installation">
134 <title>Installation of Subversion</title>
135
136 <para>
137 Install <application>Subversion</application> by running the following
138 commands:
139 </para>
140
141<screen><userinput>./configure --prefix=/usr \
142 --disable-static \
143 --with-apache-libexecdir &amp;&amp;
144make</userinput></screen>
145
146 <para>
147 If you have <xref linkend="doxygen"/> installed and you wish to build the
148 API documentation, issue: <command>doxygen doc/doxygen.conf</command>.
149 </para>
150
151 <para>
152 If you passed the <option>--enable-javahl</option> parameter to
153 <command>configure</command> and wish to build the Java bindings, issue
154 the following command:
155 </para>
156 <para>
157 <screen><command>make javahl</command></screen>
158 </para>
159
160 <para>
161 If you want to compile <application>Perl</application>,
162 <application>Python2</application>, or <application>Ruby</application>
163 bindings, issue any of the following command:
164 </para>
165 <para>
166 <screen><command>make swig-pl</command> # for <application>Perl</application>
167<command>make swig-py \
168 swig_pydir=/usr/lib/python&python2-majorver;/site-packages/libsvn \
169 swig_pydir_extra=/usr/lib/python&python2-majorver;/site-packages/svn</command> # for <application>Python</application>
170<command>make swig-rb</command> # for <application>Ruby</application></screen>
171 </para>
172
173 <para>
174 To test the results, issue: <command>make check</command>.
175 </para>
176
177 <para>
178 The Java bindings test, <command>make check-javahl</command>, fails due to
179 errors in the test suite. <!--To test the results of the Java bindings build,
180 issue <command>make check-javahl</command>. Note you must have the
181 <application>JUnit</application> testing framework installed.-->
182 </para>
183
184 <para>
185 To test the results of any of the <application>SWIG</application>
186 bindings, you can use any of the following commands:
187 <command>make check-swig-pl</command>,
188 <command> make check-swig-py</command>, or
189 <command>make check-swig-rb</command>.
190 </para>
191
192 <para>
193 The Ruby bindings test, <command>make check-swig-rb</command>, fails due
194 to errors in the test suite.
195 </para>
196
197 <para>
198 Now, as the <systemitem class="username">root</systemitem> user:
199 </para>
200
201<screen role="root"><userinput>make install &amp;&amp;
202
203install -v -m755 -d /usr/share/doc/subversion-&subversion-version; &amp;&amp;
204cp -v -R doc/* \
205 /usr/share/doc/subversion-&subversion-version;</userinput></screen>
206
207 <para>
208 If you built the Java bindings, issue the following command as the
209 <systemitem class="username">root</systemitem> user to install them:
210 </para>
211 <para>
212 <screen> <command>make install-javahl</command></screen>
213 </para>
214
215 <para>
216 If you built the <application>Perl</application>,
217 <application>Python2</application>, or
218 <application>Ruby</application> bindings, issue any of the following
219 commands as the <systemitem class="username">root</systemitem> user
220 to install them:
221 </para>
222 <para>
223 <screen><command>make install-swig-pl</command>
224<command>make install-swig-py \
225 swig_pydir=/usr/lib/python&python2-majorver;/site-packages/libsvn \
226 swig_pydir_extra=/usr/lib/python&python2-majorver;/site-packages/svn</command>
227<command>make install-swig-rb</command></screen>
228 </para>
229
230 </sect2>
231
232 <sect2 role="commands">
233 <title>Command Explanations</title>
234
235 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
236 href="../../xincludes/static-libraries.xml"/>
237
238 <para>
239 <parameter>--with-apache-libexecdir</parameter>:
240 If <xref linkend="apache"/> is installed, the shared
241 <application>Apache</application> modules are
242 built. This switch allows to have those modules installed to
243 <application>Apache</application>'s configured module dir instead
244 of <filename class="directory">/usr/libexec</filename>. It has no effect
245 if <application>Apache</application> is not installed.
246 </para>
247
248 <para>
249 <option>---disable-gmock</option>: Do not use the Googlemock testing
250 framework.
251 </para>
252
253 </sect2>
254
255 <sect2 role="configuration">
256 <title>Configuring Subversion</title>
257
258 <sect3 id="subversion-config">
259 <title>Config Files</title>
260
261 <para>
262 <filename>~/.subversion/config</filename> and
263 <filename>/etc/subversion/config</filename>
264 </para>
265
266 <indexterm zone="subversion subversion-config">
267 <primary sortas="e-AA.subversion/config">~/.subversion/config</primary>
268 </indexterm>
269
270 <indexterm zone="subversion subversion-config">
271 <primary sortas="e-etc-subversion-config">/etc/subversion/config</primary>
272 </indexterm>
273 </sect3>
274
275 <sect3>
276 <title>Configuration Information</title>
277
278 <para>
279 <filename>/etc/subversion/config</filename> is the
280 <application>Subversion</application> system-wide configuration file.
281 This file is used to specify defaults for different
282 <command>svn</command> commands.
283 </para>
284
285 <para>
286 <filename>~/.subversion/config</filename> is the user's personal
287 configuration file. It is used to override the system-wide defaults set
288 in <filename>/etc/subversion/config</filename>.
289 </para>
290 </sect3>
291
292 </sect2>
293
294 <sect2 role="content">
295 <title>Contents</title>
296
297 <segmentedlist>
298 <segtitle>Installed Programs</segtitle>
299 <segtitle>Installed Libraries</segtitle>
300 <segtitle>Installed Directories</segtitle>
301
302 <seglistitem>
303 <seg>
304 svn, svnadmin, svnbench, svndumpfilter, svnfsfs, svnlook, svnmucc,
305 svnrdump, svnserve, svnsync, and svnversion
306 </seg>
307 <seg>
308 libsvn_*-1.so and optionally, a Java library, the mod_dav_svn.so and
309 and mod_authz_svn.so <application>Apache HTTP</application> DSO
310 modules and various <application>Perl</application>,
311 <application>Python</application> and
312 <application>Ruby</application> modules.
313 </seg>
314 <seg>
315 /usr/include/subversion-1,
316 /usr/lib/perl5/site_perl/&lfs-perl-version;/{,auto/}SVN,
317 /usr/lib/python2.7/site-packages/{libsvn,svn},
318 /usr/lib/ruby/site_ruby/&lt;x.y.z&gt;/{,&lt;arch-linux&gt;-linux/}svn,
319 /usr/lib/svn-javahl, and
320 /usr/share/doc/subversion-&subversion-version;
321<!-- /usr/lib/svn-python/libsvn (optional),
322 /usr/lib/svn-python/svn (optional),
323-->
324 </seg>
325 </seglistitem>
326 </segmentedlist>
327
328 <variablelist>
329 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
330 <?dbfo list-presentation="list"?>
331 <?dbhtml list-presentation="table"?>
332
333 <varlistentry id="svn">
334 <term><command>svn</command></term>
335 <listitem>
336 <para>
337 is a command-line client program used to access
338 <application>Subversion</application> repositories.
339 </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>
350 is a tool for creating, tweaking or repairing a
351 <application>Subversion</application> repository.
352 </para>
353 <indexterm zone="subversion svnadmin">
354 <primary sortas="b-svnadmin">svnadmin</primary>
355 </indexterm>
356 </listitem>
357 </varlistentry>
358
359 <varlistentry id="svnbench">
360 <term><command>svnbench</command></term>
361 <listitem>
362 <para>
363 is a benchmarking tool.
364 </para>
365 <indexterm zone="subversion svnbench">
366 <primary sortas="b-svnbench">svnbench</primary>
367 </indexterm>
368 </listitem>
369 </varlistentry>
370
371 <varlistentry id="svndumpfilter">
372 <term><command>svndumpfilter</command></term>
373 <listitem>
374 <para>
375 is a program for filtering <application>Subversion</application>
376 repository dumpfile format streams.
377 </para>
378 <indexterm zone="subversion svndumpfilter">
379 <primary sortas="b-svndumpfilter">svndumpfilter</primary>
380 </indexterm>
381 </listitem>
382 </varlistentry>
383
384 <varlistentry id="svnfsfs">
385 <term><command>svnfsfs</command></term>
386 <listitem>
387 <para>
388 is the FSFS (FileSystem atop of the FileSystem -
389 <application>Subversion</application> filesystem implementation)
390 repository manipulation tool.
391 </para>
392 <indexterm zone="subversion svnfsfs">
393 <primary sortas="b-svnfsfs">svnfsfs</primary>
394 </indexterm>
395 </listitem>
396 </varlistentry>
397
398 <varlistentry id="svnlook">
399 <term><command>svnlook</command></term>
400 <listitem>
401 <para>
402 is a tool for inspecting a <application>Subversion</application>
403 repository.
404 </para>
405 <indexterm zone="subversion svnlook">
406 <primary sortas="b-svnlook">svnlook</primary>
407 </indexterm>
408 </listitem>
409 </varlistentry>
410
411 <varlistentry id="svnmucc">
412 <term><command>svnmucc</command></term>
413 <listitem>
414 <para>
415 is a Multiple URL Command Client for <application>Subversion</application>.
416 </para>
417 <indexterm zone="subversion svnmucc">
418 <primary sortas="b-svnmucc">svnmucc</primary>
419 </indexterm>
420 </listitem>
421 </varlistentry>
422
423 <varlistentry id="svnrdump">
424 <term><command>svnrdump</command></term>
425 <listitem>
426 <para>
427 is a tool for dumping or loading a remote
428 <application>Subversion</application> repository.
429 </para>
430 <indexterm zone="subversion svnrdump">
431 <primary sortas="b-svnrdump">svnrdump</primary>
432 </indexterm>
433 </listitem>
434 </varlistentry>
435
436 <varlistentry id="svnserve">
437 <term><command>svnserve</command></term>
438 <listitem>
439 <para>
440 is a custom standalone server program, able to run as a daemon
441 process or invoked by SSH.
442 </para>
443 <indexterm zone="subversion svnserve">
444 <primary sortas="b-svnserve">svnserve</primary>
445 </indexterm>
446 </listitem>
447 </varlistentry>
448
449 <varlistentry id="svnsync">
450 <term><command>svnsync</command></term>
451 <listitem>
452 <para>
453 is a <application>Subversion</application> repository
454 synchronisation tool.
455 </para>
456 <indexterm zone="subversion svnsync">
457 <primary sortas="b-svnsync">svnsync</primary>
458 </indexterm>
459 </listitem>
460 </varlistentry>
461
462 <varlistentry id="svnversion">
463 <term><command>svnversion</command></term>
464 <listitem>
465 <para>
466 is used to report the version number and state of a working
467 <application>Subversion</application> repository copy.
468 </para>
469 <indexterm zone="subversion svnversion">
470 <primary sortas="b-svnversion">svnversion</primary>
471 </indexterm>
472 </listitem>
473 </varlistentry>
474
475 <varlistentry id="libsvn_star-1">
476 <term><filename class="libraryfile">libsvn_*-1.so</filename></term>
477 <listitem>
478 <para>
479 are the support libraries used by the
480 <application>Subversion</application> programs.
481 </para>
482 <indexterm zone="subversion libsvn_star-1">
483 <primary sortas="c-libsvn_star-1">libsvn_*-1.so</primary>
484 </indexterm>
485 </listitem>
486 </varlistentry>
487
488 <varlistentry id="mod_authz_svn">
489 <term><filename class="libraryfile">mod_authz_svn.so</filename></term>
490 <listitem>
491 <para>
492 is a plug-in module for the <application>Apache</application> HTTP
493 server, used to authenticate users to a
494 <application>Subversion</application> repository over the Internet
495 or an intranet.
496 </para>
497 <indexterm zone="subversion mod_authz_svn">
498 <primary sortas="c-mod_authz_svn">mod_authz_svn.so</primary>
499 </indexterm>
500 </listitem>
501 </varlistentry>
502
503 <varlistentry id="mod_dav_svn">
504 <term><filename class="libraryfile">mod_dav_svn.so</filename></term>
505 <listitem>
506 <para>
507 is a plug-in module for the <application>Apache</application> HTTP
508 server, used to make a <application>Subversion</application>
509 repository available to others over the Internet or an intranet.
510 </para>
511 <indexterm zone="subversion mod_dav_svn">
512 <primary sortas="c-mod_authz_svn">mod_dav_svn.so</primary>
513 </indexterm>
514 </listitem>
515 </varlistentry>
516
517 </variablelist>
518
519 </sect2>
520
521</sect1>
Note: See TracBrowser for help on using the repository browser.