source: general/genlib/brotli.xml@ 51718d1

10.1 11.0 11.1 11.2 lazarus plabs/python-mods qt5new trunk upgradedb xry111/intltool xry111/soup3 xry111/test-20220226
Last change on this file since 51718d1 was 51718d1, checked in by Douglas R. Reno <renodr@…>, 2 years ago

Update to Samba-4.13.3
Update to libwacom-1.7
Minor text tweaks to brotli
Remove extraneous '/' from libusb

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

  • Property mode set to 100644
File size: 7.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 brotli-download-http "https://github.com/google/brotli/archive/v&brotli-version;/brotli-&brotli-version;.tar.gz">
8 <!ENTITY brotli-download-ftp " ">
9 <!ENTITY brotli-md5sum "c2274f0c7af8470ad514637c35bcee7d">
10 <!ENTITY brotli-size "476 KB">
11 <!ENTITY brotli-buildsize "24 MB (with python3 bindings)">
12 <!-- The python tests for this package are broken. The tarball is missing a lot of test files -->
13 <!ENTITY brotli-time "0.4 SBU (with python3 bindings)">
14]>
15
16<sect1 id="brotli" xreflabel="Brotli-&brotli-version;">
17 <?dbhtml filename="brotli.html"?>
18
19 <sect1info>
20 <othername>$LastChangedBy$</othername>
21 <date>$Date$</date>
22 </sect1info>
23
24 <title>brotli-&brotli-version;</title>
25
26 <indexterm zone="brotli">
27 <primary sortas="a-brotli">Brotli</primary>
28 </indexterm>
29
30 <sect2 role="package">
31 <title>Introduction to Brotli</title>
32
33 <para>
34 <application>Brotli</application> provides a general-purpose lossless
35 compression algorithm that compresses data using a combination of a
36 modern variant of the LZ77 algorithm, Huffman coding and 2nd order
37 context modeling. Its libraries are particularly used for WOFF2 fonts
38 on webpages.
39 </para>
40
41 &lfs10_checked;
42
43 <bridgehead renderas="sect3">Package Information</bridgehead>
44 <itemizedlist spacing="compact">
45 <listitem>
46 <para>
47 Download (HTTP): <ulink url="&brotli-download-http;"/>
48 </para>
49 </listitem>
50 <listitem>
51 <para>
52 Download (FTP): <ulink url="&brotli-download-ftp;"/>
53 </para>
54 </listitem>
55 <listitem>
56 <para>
57 Download MD5 sum: &brotli-md5sum;
58 </para>
59 </listitem>
60 <listitem>
61 <para>
62 Download size: &brotli-size;
63 </para>
64 </listitem>
65 <listitem>
66 <para>
67 Estimated disk space required: &brotli-buildsize;
68 </para>
69 </listitem>
70 <listitem>
71 <para>
72 Estimated build time: &brotli-time;
73 </para>
74 </listitem>
75 </itemizedlist>
76
77 <bridgehead renderas="sect3">Brotli Dependencies</bridgehead>
78
79 <bridgehead renderas="sect4">Required</bridgehead>
80 <para role="required">
81 <xref linkend="cmake"/>
82 </para>
83
84 <!-- Brotli doesn't have any lua bindings, at least not with 1.0.7. -->
85 <bridgehead renderas="sect4">Optional</bridgehead>
86 <para role="optional">
87 <!--<xref linkend="lua"/> (to create Lua bindings) and -->
88 <xref linkend="python2"/> (to create python2 bindings)
89 </para>
90
91 <para condition="html" role="usernotes">
92 User Notes: <ulink url="&blfs-wiki;/brotli"/>
93 </para>
94 </sect2>
95
96
97 <sect2 role="installation">
98 <title>Installation of Brotli</title>
99
100 <para>
101 At first, fix an issue in pkg-config files:
102 </para>
103
104<screen><userinput>sed -i 's@-R..libdir.@@' scripts/*.pc.in</userinput></screen>
105
106 <para>
107 Install <application>brotli</application> by running the following
108 commands:
109 </para>
110
111<screen><userinput>mkdir out &amp;&amp;
112cd out &amp;&amp;
113
114cmake -DCMAKE_INSTALL_PREFIX=/usr \
115 -DCMAKE_BUILD_TYPE=Release \
116 .. &amp;&amp;
117make</userinput></screen>
118
119
120 <para>
121 To test the results, issue: <command>make test</command>
122 </para>
123
124 <para>
125 If desired, either or both sets of python bindings can be built and
126 installed without any conflicts. If you need the
127 <application>Python2</application> bindings, add or substitute
128 <command>python2</command> for <command>python3</command> in the
129 following instructions:
130 </para>
131
132<screen><userinput>pushd .. &amp;&amp;
133python3 setup.py build &amp;&amp;
134popd</userinput></screen>
135<!-- These are broken
136-->
137 <para>
138 The python tests are missing most of the necessary testdata files and
139 therefore 240 of 311 tests fail.
140 If you nevertheless wish to test the bindings, go back to the top-level directory and
141 issue: <command>python3 setup.py test</command>.
142 </para>
143 <para>
144 Now, as the <systemitem class="username">root</systemitem> user:
145 </para>
146
147<screen role="root"><userinput>make install &amp;&amp;
148cd ..</userinput></screen>
149
150 <para>
151 If you have built either or both sets of <application>python</application>
152 bindings, install them as the <systemitem class="username">root</systemitem>
153 user (as before, use the appropriate version(s) of
154 <application>python</application>:
155 </para>
156
157<!-- EDITORS: for DESTDIR style installs use
158python3 setup.py install \-\-root /some/where -->
159<screen role="root"><userinput>python3 setup.py install --optimize=1</userinput></screen>
160
161 </sect2>
162
163 <sect2 role="content">
164 <title>Contents</title>
165
166 <segmentedlist>
167 <segtitle>Installed Programs</segtitle>
168 <segtitle>Installed Libraries</segtitle>
169 <segtitle>Installed Directory</segtitle>
170
171 <seglistitem>
172 <seg>
173 brotli
174 </seg>
175 <seg>
176 libbrotlicommon{-static.a,.so},
177 libbrotlidec{,-static.a,.so}, and
178 libbrotlienc{,-static.a,.so}
179 </seg>
180 <seg>
181 /usr/include/brotli
182 </seg>
183 </seglistitem>
184 </segmentedlist>
185
186 <variablelist>
187 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
188 <?dbfo list-presentation="list"?>
189 <?dbhtml list-presentation="table"?>
190
191 <varlistentry id="brotli-prog">
192 <term><command>brotli</command></term>
193 <listitem>
194 <para>
195 can compress or decompress files, or test the integrity of
196 compressed files.
197 </para>
198 <indexterm zone="brotli brotli-prog">
199 <primary sortas="b-brotli">brotli</primary>
200 </indexterm>
201 </listitem>
202 </varlistentry>
203
204 <varlistentry id="libbrotlicommon">
205 <term><filename class="libraryfile">libbrotlicommon{-static.a,.so}</filename></term>
206 <listitem>
207 <para>
208 is the Brotli common dictionary library.
209 </para>
210 <indexterm zone="brotli libbrotlicommon">
211 <primary sortas="c-libbrotlicommon">libbrotlicommon{,-static.a,.so}</primary>
212 </indexterm>
213 </listitem>
214 </varlistentry>
215
216 <varlistentry id="libbrotlidec">
217 <term><filename class="libraryfile">libbrotlidec{-static.a,.so}</filename></term>
218 <listitem>
219 <para>
220 is the Brotli decoder library.
221 </para>
222 <indexterm zone="brotli libbrotlidec">
223 <primary sortas="c-libbrotlidec">libbrotlidec{,-static.a,.so}</primary>
224 </indexterm>
225 </listitem>
226 </varlistentry>
227
228 <varlistentry id="libbrotlienc">
229 <term><filename class="libraryfile">libbrotlienc{-static.a,.so}</filename></term>
230 <listitem>
231 <para>
232 is the Brotli common encoder library.
233 </para>
234 <indexterm zone="brotli libbrotlienc">
235 <primary sortas="c-libbrotlienc">libbrotlienc{,-static.a,.so}</primary>
236 </indexterm>
237 </listitem>
238 </varlistentry>
239 </variablelist>
240
241 </sect2>
242</sect1>
Note: See TracBrowser for help on using the repository browser.