source: general/genlib/libxml2.xml@ cd127567

10.0 10.1 11.0 11.1 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind lazarus perl-modules qt5new trunk upgradedb xry111/intltool xry111/test-20220226
Last change on this file since cd127567 was cd127567, checked in by Bruce Dubbs <bdubbs@…>, 5 years ago

Update to itstool-2.0.4.
Update to Lingua-Translit-0.28 (Perl Module).

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

  • Property mode set to 100644
File size: 9.2 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 libxml2-download-http "http://xmlsoft.org/sources/libxml2-&libxml2-version;.tar.gz">
8 <!ENTITY libxml2-download-ftp "ftp://xmlsoft.org/libxml2/libxml2-&libxml2-version;.tar.gz">
9 <!ENTITY libxml2-md5sum "dbae8327d8471941bf0472e273473e36">
10 <!ENTITY libxml2-size "5.2 MB">
11 <!ENTITY libxml2-buildsize "97 MB (add 30 MB for tests)">
12 <!ENTITY libxml2-time "0.4 SBU (add 0.3 SBU for tests)">
13 <!ENTITY testsuite-version "20130923">
14]>
15
16<sect1 id="libxml2" xreflabel="libxml2-&libxml2-version;">
17 <?dbhtml filename="libxml2.html"?>
18
19 <sect1info>
20 <othername>$LastChangedBy$</othername>
21 <date>$Date$</date>
22 </sect1info>
23
24 <title>libxml2-&libxml2-version;</title>
25
26 <indexterm zone="libxml2">
27 <primary sortas="a-libxml2">libxml2</primary>
28 </indexterm>
29
30 <sect2 role="package">
31 <title>Introduction to libxml2</title>
32
33 <para>
34 The <application>libxml2</application> package contains libraries
35 and utilities used for parsing XML files.
36 </para>
37
38 &lfs81_checked;
39
40 <bridgehead renderas="sect3">Package Information</bridgehead>
41 <itemizedlist spacing="compact">
42 <listitem>
43 <para>
44 Download (HTTP): <ulink url="&libxml2-download-http;"/>
45 </para>
46 </listitem>
47 <listitem>
48 <para>
49 Download (FTP): <ulink url="&libxml2-download-ftp;"/>
50 </para>
51 </listitem>
52 <listitem>
53 <para>
54 Download MD5 sum: &libxml2-md5sum;
55 </para>
56 </listitem>
57 <listitem>
58 <para>
59 Download size: &libxml2-size;
60 </para>
61 </listitem>
62 <listitem>
63 <para>
64 Estimated disk space required: &libxml2-buildsize;
65 </para>
66 </listitem>
67 <listitem>
68 <para>
69 Estimated build time: &libxml2-time;
70 </para>
71 </listitem>
72 </itemizedlist>
73
74 <bridgehead renderas="sect3">Additional Downloads</bridgehead>
75 <itemizedlist spacing="compact">
76 <listitem>
77 <para>
78 Optional Testsuite:
79 <ulink url="http://www.w3.org/XML/Test/xmlts&testsuite-version;.tar.gz"/> - This
80 enables <command>make check</command> to do complete testing.
81 </para>
82 </listitem>
83<!-- All CVEs seem to have been applied in 2.9.4
84 <listitem>
85 <para>
86 Required patch:
87 <ulink url="&patch-root;/libxml2-&libxml2-version;-security_fixes-1.patch"/>
88 </para>
89 </listitem>-->
90 </itemizedlist>
91
92 <bridgehead renderas="sect3">libxml2 Dependencies</bridgehead>
93
94 <bridgehead renderas="sect4">Optional</bridgehead>
95 <para role="optional">
96 <xref linkend="python2"/> <!--or <xref linkend="python3"/> (to build and
97 install a <application>Python</application> library module, additionally
98 it is required to run the full suite of tests)-->
99 <!-- As discovered by Bruce, itstool needs this module. -->
100 </para>
101
102 <note>
103 <para>
104 Some packages which utilize <application>libxml2</application> (such as
105 <application>GNOME Doc Utils</application>) need the
106 <application>Python</application> module installed to function properly
107 and some packages will not build properly if the
108 <application>Python</application> module is not available.
109 </para>
110 </note>
111
112 <bridgehead renderas="sect4">Optional</bridgehead>
113 <para role="optional">
114 <xref linkend="icu"/> and
115 <xref linkend="valgrind"/> (may be used in the tests)
116 </para>
117
118 <para condition="html" role="usernotes">
119 User Notes: <ulink url="&blfs-wiki;/libxml2"/>
120 </para>
121 </sect2>
122
123 <sect2 role="installation">
124 <title>Installation of libxml2</title>
125
126 <para>
127 If you want to build the <application>Python</application> module for
128 <xref linkend="python3"/>, run:
129 </para>
130
131<screen><userinput>sed -i '/_PyVerify_fd/,+1d' python/types.c</userinput></screen>
132
133 <para>
134 Install <application>libxml2</application> by running the following
135 commands:
136 </para>
137
138<screen><userinput>./configure --prefix=/usr \
139 --disable-static \
140 --with-history \
141 --with-python=/usr/bin/python3 &amp;&amp;
142make</userinput></screen>
143
144 <para>If you downloaded the testsuite, issue the following command:</para>
145
146<screen><userinput>tar xf ../xmlts&testsuite-version;.tar.gz</userinput></screen>
147
148 <para>
149 To test the results, issue: <command>make check &gt; check.log</command>.
150 A summary of the results can be obtained with <command>grep -E
151 '^Total|expected' check.log</command>. If <xref linkend="valgrind"/> is
152 installed and you want to check memory leaks, replace
153 <command>check</command> with <command>check-valgrind</command>.
154 </para>
155
156 <note>
157 <para>
158 The tests use <ulink url="http://localhost/">http://localhost/</ulink>
159 to test parsing of external entities. If the machine where you run the
160 tests serves as a web site, the tests may hang, depending on the
161 content of the file served. It is therefore recommended to shut down
162 the server during the tests, as the <systemitem
163 class="username">root</systemitem> user:
164 </para>
165
166<screen role="nodump" revision="sysv"><userinput>/etc/init.d/httpd stop</userinput></screen>
167<screen role="nodump" revision="systemd"><userinput>systemctl stop httpd.service</userinput></screen>
168
169 </note>
170 <para>
171 Now, as the <systemitem class="username">root</systemitem> user:
172 </para>
173
174<screen role="root"><userinput>make install</userinput></screen>
175 </sect2>
176
177 <sect2 role="commands">
178 <title>Command Explanations</title>
179
180 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
181 href="../../xincludes/static-libraries.xml"/>
182
183 <para>
184 <parameter>--with-history</parameter>: This switch enables
185 <application>Readline</application> support when running
186 <command>xmlcatalog</command> or <command>xmllint</command> in shell mode.
187 </para>
188
189 <para>
190 <option>--with-python=/usr/bin/python3</option>: Add this switch if you
191 want libxml2 to use Python3 instead of Python2.
192 </para>
193
194 <para>
195 <option>--with-icu</option>: Add this switch if you have built
196 <xref linkend="icu"/>, for better unicode support.
197 </para>
198
199 <para>
200 <option>--with-threads</option>: Add this switch to enable multithread
201 support.
202 </para>
203
204 </sect2>
205
206 <sect2 role="content">
207 <title>Contents</title>
208
209 <segmentedlist>
210 <segtitle>Installed Programs</segtitle>
211 <segtitle>Installed Libraries</segtitle>
212 <segtitle>Installed Directories</segtitle>
213
214 <seglistitem>
215 <seg>
216 xml2-config, xmlcatalog and xmllint
217 </seg>
218 <seg>
219 libxml2.so and optionally, the libxml2mod.so
220 <application>Python</application> module
221 </seg>
222 <seg>
223 /usr/include/libxml2,
224 /usr/lib/cmake/libxml2,
225 /usr/share/doc/libxml2-&libxml2-version;,
226 /usr/share/doc/libxml2-python-&libxml2-version;, and
227 /usr/share/gtk-doc/html/libxml2
228 </seg>
229 </seglistitem>
230 </segmentedlist>
231
232 <variablelist>
233 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
234 <?dbfo list-presentation="list"?>
235 <?dbhtml list-presentation="table"?>
236
237 <varlistentry id="xml2-config">
238 <term><command>xml2-config</command></term>
239 <listitem>
240 <para>
241 determines the compile and linker flags that should be used to
242 compile and link programs that use
243 <filename class='libraryfile'>libxml2</filename>.
244 </para>
245 <indexterm zone="libxml2 xml2-config">
246 <primary sortas="b-xml2-config">xml2-config</primary>
247 </indexterm>
248 </listitem>
249 </varlistentry>
250
251 <varlistentry id="xmlcatalog">
252 <term><command>xmlcatalog</command></term>
253 <listitem>
254 <para>
255 is used to monitor and manipulate XML and SGML catalogs.
256 </para>
257 <indexterm zone="libxml2 xmlcatalog">
258 <primary sortas="b-xmlcatalog">xmlcatalog</primary>
259 </indexterm>
260 </listitem>
261 </varlistentry>
262
263 <varlistentry id="xmllint">
264 <term><command>xmllint</command></term>
265 <listitem>
266 <para>
267 parses XML files and outputs reports (based upon options) to detect
268 errors in XML coding.
269 </para>
270 <indexterm zone="libxml2 xmllint">
271 <primary sortas="b-xmllint">xmllint</primary>
272 </indexterm>
273 </listitem>
274 </varlistentry>
275
276 <varlistentry id="libxml2-lib">
277 <term><filename class="libraryfile">libxml2.so</filename></term>
278 <listitem>
279 <para>
280 provides functions for programs to parse files that use the XML
281 format.
282 </para>
283 <indexterm zone="libxml2 libxml2-lib">
284 <primary sortas="c-libxml2">libxml2.so</primary>
285 </indexterm>
286 </listitem>
287 </varlistentry>
288
289 </variablelist>
290
291 </sect2>
292
293</sect1>
Note: See TracBrowser for help on using the repository browser.