source: general/genlib/libxslt.xml@ 1b893a7

11.0 11.1 lazarus qt5new trunk upgradedb xry111/intltool xry111/test-20220226
Last change on this file since 1b893a7 was 1b893a7, checked in by Xi Ruoyao <xry111@…>, 12 months ago

libxslt: workaround a testsuite issue with latest libxml

  • Property mode set to 100644
File size: 8.4 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 libxslt-download-http "http://xmlsoft.org/sources/libxslt-&libxslt-version;.tar.gz">
8 <!ENTITY libxslt-download-ftp "ftp://xmlsoft.org/libxslt/libxslt-&libxslt-version;.tar.gz">
9 <!ENTITY libxslt-md5sum "db8765c8d076f1b6caafd9f2542a304a">
10 <!ENTITY libxslt-size "3.4 MB">
11 <!ENTITY libxslt-buildsize "36 MB (with tests)">
12 <!ENTITY libxslt-time "0.3 SBU (with tests)">
13]>
14
15<sect1 id="libxslt" xreflabel="libxslt-&libxslt-version;">
16 <?dbhtml filename="libxslt.html"?>
17
18 <sect1info>
19 <date>$Date$</date>
20 </sect1info>
21
22 <title>libxslt-&libxslt-version;</title>
23
24 <indexterm zone="libxslt">
25 <primary sortas="a-libxslt">libxslt</primary>
26 </indexterm>
27
28 <sect2 role="package">
29 <title>Introduction to libxslt</title>
30
31 <para>
32 The <application>libxslt</application> package contains
33 XSLT libraries used for extending <filename
34 class="libraryfile">libxml2</filename> libraries to
35 support XSLT files.
36 </para>
37
38 &lfs101_checked;
39
40 <bridgehead renderas="sect3">Package Information</bridgehead>
41 <itemizedlist spacing="compact">
42 <listitem>
43 <para>
44 Download (HTTP): <ulink url="&libxslt-download-http;"/>
45 </para>
46 </listitem>
47 <listitem>
48 <para>
49 Download (FTP): <ulink url="&libxslt-download-ftp;"/>
50 </para>
51 </listitem>
52 <listitem>
53 <para>
54 Download MD5 sum: &libxslt-md5sum;
55 </para>
56 </listitem>
57 <listitem>
58 <para>
59 Download size: &libxslt-size;
60 </para>
61 </listitem>
62 <listitem>
63 <para>
64 Estimated disk space required: &libxslt-buildsize;
65 </para>
66 </listitem>
67 <listitem>
68 <para>
69 Estimated build time: &libxslt-time;
70 </para>
71 </listitem>
72 </itemizedlist>
73<!--
74 <bridgehead renderas="sect3">Additional Downloads</bridgehead>
75 <itemizedlist spacing="compact">
76 <listitem>
77 <para>
78 Required patch:
79 <ulink url="&patch-root;/libxslt-&libxslt-version;-security_fix-1.patch"/>
80 </para>
81 </listitem>
82 </itemizedlist>
83-->
84 <bridgehead renderas="sect3">libxslt Dependencies</bridgehead>
85
86 <bridgehead renderas="sect4">Required</bridgehead>
87 <para role="required">
88 <xref linkend="libxml2"/>
89 </para>
90
91 <bridgehead renderas="sect4">Recommended</bridgehead>
92 <para role="recommended">
93 <xref linkend="DocBook"/> and
94 <xref linkend="docbook-xsl"/>
95 </para>
96
97 <note>
98 <para>
99 Although it is not a direct dependency, many applications
100 using <application>libxslt</application> will expect
101 <xref linkend="DocBook"/> and <xref linkend="docbook-xsl"/>
102 to be present.
103 </para>
104 </note>
105
106 <bridgehead renderas="sect4">Optional</bridgehead>
107 <para role="optional">
108 <xref linkend="libgcrypt"/> and
109 <xref linkend="libxml2py2"/>
110 <!-- Seems to be used for tests -->
111 <note><simpara>The <xref role="nodep" linkend="libxml2py2"/>
112 dependency is only appropriate if the <application>Python2</application>
113 module for this package is needed. The
114 libxslt <application>Python2</application> module is not needed for
115 any package in BLFS but various non-BLFS packages may install
116 <application>Python2</application> modules which reference it.
117 </simpara></note>
118 </para>
119
120 <para condition="html" role="usernotes">User Notes:
121 <ulink url="&blfs-wiki;/libxslt"/>
122 </para>
123 </sect2>
124
125 <sect2 role="installation">
126 <title>Installation of libxslt</title>
127<!--
128 <para>
129 First, install a security patch to fix a security framework bypass:
130 </para>
131
132<screen><userinput remap="pre">patch -Np1 -i ../libxslt-&libxslt-version;-security_fix-1.patch</userinput></screen>
133-->
134 <para>
135 Install <application>libxslt</application> by running the following
136 commands:
137 </para>
138
139<screen><userinput>sed -i s/3000/5000/ libxslt/transform.c doc/xsltproc.{1,xml} &amp;&amp;
140sed -i '/max\(Parser\)\?Depth/d' ./tests/fuzz/fuzz.c &amp;&amp;
141./configure --prefix=/usr --disable-static --without-python &amp;&amp;
142make</userinput></screen>
143
144 <para>
145 A shipped man page is glitched. If the recommended dependencies are
146 installed, regenerate it by running the following commands:
147 </para>
148
149<screen><userinput>sed -e 's@http://cdn.docbook.org/release/xsl@https://cdn.docbook.org/release/xsl-nons@' \
150 -e 's@\$Date\$@31 October 2019@' -i doc/xsltproc.xml &amp;&amp;
151xsltproc/xsltproc --nonet doc/xsltproc.xml -o doc/xsltproc.1</userinput></screen>
152
153 <para>
154 To test the results, issue: <command>make check</command>.
155 </para>
156
157 <para>
158 Now, as the <systemitem class="username">root</systemitem> user:
159 </para>
160
161<screen role="root"><userinput>make install</userinput></screen>
162
163 </sect2>
164
165 <sect2 role="commands">
166 <title>Command Explanations</title>
167
168 <para>
169 <command>sed -i s/3000/5000/ ...</command>: this increases the recursion
170 limit in libxslt. This is needed by some packages for their documentation.
171 </para>
172
173 <para>
174 <parameter>--without-python</parameter>: This parameter disables the libxslt
175 python module since it does not support Python3. If you wish to enable
176 this module, make sure that <xref role="nodep" linkend="libxml2py2"/> is
177 installed, and remove this parameter.
178 </para>
179
180 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
181 href="../../xincludes/static-libraries.xml"/>
182
183 </sect2>
184
185 <sect2 role="content">
186 <title>Contents</title>
187
188 <segmentedlist>
189 <segtitle>Installed Programs</segtitle>
190 <segtitle>Installed Libraries</segtitle>
191 <segtitle>Installed Directories</segtitle>
192
193 <seglistitem>
194 <seg>
195 xslt-config and xsltproc
196 </seg>
197 <seg>
198 libexslt.so, libxslt.so and optionally, libxsltmod.so
199 <application>Python</application> module
200 </seg>
201 <seg>
202 /usr/include/libexslt,
203 /usr/include/libxslt,
204 /usr/lib/libxslt-plugins,
205 /usr/share/doc/libxslt-&libxslt-version;, and
206 /usr/share/doc/libxslt-python-&libxslt-version;</seg>
207 </seglistitem>
208 </segmentedlist>
209
210 <variablelist>
211 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
212 <?dbfo list-presentation="list"?>
213 <?dbhtml list-presentation="table"?>
214
215 <varlistentry id="xslt-config">
216 <term><command>xslt-config</command></term>
217 <listitem>
218 <para>
219 is used to find out the pre-processor, linking and
220 compiling flags necessary to use the <application>libxslt</application>
221 libraries in 3rd-party programs
222 </para>
223 <indexterm zone="libxslt xslt-config">
224 <primary sortas="b-xslt-config">xslt-config</primary>
225 </indexterm>
226 </listitem>
227 </varlistentry>
228
229 <varlistentry id="xsltproc">
230 <term><command>xsltproc</command></term>
231 <listitem>
232 <para>
233 is used to apply XSLT stylesheets to XML documents
234 </para>
235 <indexterm zone="libxslt xsltproc">
236 <primary sortas="b-xsltproc">xsltproc</primary>
237 </indexterm>
238 </listitem>
239 </varlistentry>
240
241 <varlistentry id="libexslt">
242 <term><filename class="libraryfile">libexslt.so</filename></term>
243 <listitem>
244 <para>
245 is used to provide extensions to XSLT functions
246 </para>
247 <indexterm zone="libxslt libexslt">
248 <primary sortas="c-libexslt">libexslt.so</primary>
249 </indexterm>
250 </listitem>
251 </varlistentry>
252
253 <varlistentry id="libxslt-lib">
254 <term><filename class="libraryfile">libxslt.so</filename></term>
255 <listitem>
256 <para>
257 provides extensions to the
258 <filename class="libraryfile">libxml2</filename>
259 libraries to parse files that use the XSLT format
260 </para>
261 <indexterm zone="libxslt libxslt-lib">
262 <primary sortas="c-libxslt">libxslt.so</primary>
263 </indexterm>
264 </listitem>
265 </varlistentry>
266
267 </variablelist>
268
269 </sect2>
270
271</sect1>
Note: See TracBrowser for help on using the repository browser.