source: general/genlib/libxslt.xml@ 4dbc40bb

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

libxslt: simplify the sed by using -r, and add an explanation

  • Property mode set to 100644
File size: 8.5 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 -r '/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 <command>sed -i -r '/max(Parser)?Depth/d' ...</command>: this works
175 around an issue running test suite of libxslt with libxml-2.9.12.
176 </para>
177
178 <para>
179 <parameter>--without-python</parameter>: This parameter disables the libxslt
180 python module since it does not support Python3. If you wish to enable
181 this module, make sure that <xref role="nodep" linkend="libxml2py2"/> is
182 installed, and remove this parameter.
183 </para>
184
185 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
186 href="../../xincludes/static-libraries.xml"/>
187
188 </sect2>
189
190 <sect2 role="content">
191 <title>Contents</title>
192
193 <segmentedlist>
194 <segtitle>Installed Programs</segtitle>
195 <segtitle>Installed Libraries</segtitle>
196 <segtitle>Installed Directories</segtitle>
197
198 <seglistitem>
199 <seg>
200 xslt-config and xsltproc
201 </seg>
202 <seg>
203 libexslt.so, libxslt.so and optionally, libxsltmod.so
204 <application>Python</application> module
205 </seg>
206 <seg>
207 /usr/include/libexslt,
208 /usr/include/libxslt,
209 /usr/lib/libxslt-plugins,
210 /usr/share/doc/libxslt-&libxslt-version;, and
211 /usr/share/doc/libxslt-python-&libxslt-version;</seg>
212 </seglistitem>
213 </segmentedlist>
214
215 <variablelist>
216 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
217 <?dbfo list-presentation="list"?>
218 <?dbhtml list-presentation="table"?>
219
220 <varlistentry id="xslt-config">
221 <term><command>xslt-config</command></term>
222 <listitem>
223 <para>
224 is used to find out the pre-processor, linking and
225 compiling flags necessary to use the <application>libxslt</application>
226 libraries in 3rd-party programs
227 </para>
228 <indexterm zone="libxslt xslt-config">
229 <primary sortas="b-xslt-config">xslt-config</primary>
230 </indexterm>
231 </listitem>
232 </varlistentry>
233
234 <varlistentry id="xsltproc">
235 <term><command>xsltproc</command></term>
236 <listitem>
237 <para>
238 is used to apply XSLT stylesheets to XML documents
239 </para>
240 <indexterm zone="libxslt xsltproc">
241 <primary sortas="b-xsltproc">xsltproc</primary>
242 </indexterm>
243 </listitem>
244 </varlistentry>
245
246 <varlistentry id="libexslt">
247 <term><filename class="libraryfile">libexslt.so</filename></term>
248 <listitem>
249 <para>
250 is used to provide extensions to XSLT functions
251 </para>
252 <indexterm zone="libxslt libexslt">
253 <primary sortas="c-libexslt">libexslt.so</primary>
254 </indexterm>
255 </listitem>
256 </varlistentry>
257
258 <varlistentry id="libxslt-lib">
259 <term><filename class="libraryfile">libxslt.so</filename></term>
260 <listitem>
261 <para>
262 provides extensions to the
263 <filename class="libraryfile">libxml2</filename>
264 libraries to parse files that use the XSLT format
265 </para>
266 <indexterm zone="libxslt libxslt-lib">
267 <primary sortas="c-libxslt">libxslt.so</primary>
268 </indexterm>
269 </listitem>
270 </varlistentry>
271
272 </variablelist>
273
274 </sect2>
275
276</sect1>
Note: See TracBrowser for help on using the repository browser.