source: general/graphlib/harfbuzz.xml@ 41e68a2d

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

Update to nghttp2-1.39.2 (security update)
Update to harfbuzz-2.6.0
Update to DateTime-Calendar-Julian-0.101 (Perl Module)

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@21966 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 harfbuzz-download-http
8 "https://www.freedesktop.org/software/harfbuzz/release/harfbuzz-&harfbuzz-version;.tar.xz">
9 <!ENTITY harfbuzz-download-ftp " ">
10 <!ENTITY harfbuzz-md5sum "3e2653d2195d6c18e5cded055c873601">
11 <!ENTITY harfbuzz-size "5.5 MB">
12 <!ENTITY harfbuzz-buildsize "215 MB (with tests)">
13 <!ENTITY harfbuzz-time "0.8 SBU (Using parallelism=4; with tests)">
14]>
15
16<sect1 id="harfbuzz" xreflabel="HarfBuzz-&harfbuzz-version;">
17 <?dbhtml filename="harfbuzz.html"?>
18
19 <sect1info>
20 <othername>$LastChangedBy$</othername>
21 <date>$Date$</date>
22 </sect1info>
23
24 <title>HarfBuzz-&harfbuzz-version;</title>
25
26 <indexterm zone="harfbuzz">
27 <primary sortas="a-HarfBuzz">HarfBuzz</primary>
28 </indexterm>
29
30 <sect2 role="package">
31 <title>Introduction to Harfbuzz</title>
32
33 <para>
34 The <application>HarfBuzz</application> package contains an OpenType text
35 shaping engine.
36 </para>
37
38 &lfs84_checked;
39
40 <bridgehead renderas="sect3">Package Information</bridgehead>
41 <itemizedlist spacing="compact">
42 <listitem>
43 <para>
44 Download (HTTP): <ulink url="&harfbuzz-download-http;"/>
45 </para>
46 </listitem>
47 <listitem>
48 <para>
49 Download (FTP): <ulink url="&harfbuzz-download-ftp;"/>
50 </para>
51 </listitem>
52 <listitem>
53 <para>
54 Download MD5 sum: &harfbuzz-md5sum;
55 </para>
56 </listitem>
57 <listitem>
58 <para>
59 Download size: &harfbuzz-size;
60 </para>
61 </listitem>
62 <listitem>
63 <para>
64 Estimated disk space required: &harfbuzz-buildsize;
65 </para>
66 </listitem>
67 <listitem>
68 <para>
69 Estimated build time: &harfbuzz-time;
70 </para>
71 </listitem>
72 </itemizedlist>
73
74 <bridgehead renderas="sect3">HarfBuzz Dependencies</bridgehead>
75
76 <bridgehead renderas="sect4">Recommended</bridgehead>
77 <para role="recommended">
78 <xref linkend="glib2"/> (required for Pango),
79 <xref role="first" linkend="graphite2"/> (required for building
80 <xref role="nodep" linkend="texlive"/> or
81 <xref role="nodep" linkend="libreoffice"/> with system harfbuzz),
82 <xref linkend="icu"/>, and
83 <xref role="first" linkend="freetype2"/>
84 (after <xref role="nodep" linkend="harfbuzz"/> is installed, reinstall
85 <xref role="nodep" linkend="freetype2"/>)
86 </para>
87
88 <bridgehead renderas="sect4">Optional</bridgehead>
89 <para role="optional">
90 <xref linkend="cairo"/> (circular: build cairo and all its recommended
91 dependencies, including harfbuzz, first, then rebuild harfbuzz if the
92 cairo backend is needed),
93 <xref linkend="gobject-introspection"/>,
94 <xref linkend="gtk-doc"/>, and
95 <ulink url="https://pypi.org/project/FontTools/">FontTools</ulink>
96 (Python 2 or Python 3 module, for the testsuite)
97 </para>
98
99 <warning>
100 <para>
101 Recommended dependencies are not strictly required to build
102 the package. However, you might not get expected results at
103 runtime if you don't install them. Please do not report bugs
104 with this package if you <emphasis>have not</emphasis>
105 installed the recommended dependencies.
106 </para>
107 </warning>
108
109 <para condition="html" role="usernotes">
110 User Notes: <ulink url="&blfs-wiki;/harfbuzz"/>
111 </para>
112 </sect2>
113
114 <sect2 role="installation">
115 <title>Installation of HarfBuzz</title>
116
117 <para>
118 Install <application>HarfBuzz</application> by running the following
119 commands:
120 </para>
121
122<screen><userinput>./configure --prefix=/usr --with-gobject --with-graphite2 &amp;&amp;
123make</userinput></screen>
124
125 <para>
126 If FontTools is installed for Python 3 and you want to test the results
127 with it, adjust the test suite:
128 <command>
129 find -name \*.py -exec sed '1s@python@&amp;3@' -i {} \;
130 </command>.
131 To test the results, issue: <command>make check</command>.
132 </para>
133
134 <para>
135 Now, as the <systemitem class="username">root</systemitem> user:
136 </para>
137
138<screen role="root"><userinput>make install</userinput></screen>
139 </sect2>
140
141 <sect2 role="commands">
142 <title>Command Explanations</title>
143
144 <para>
145 <parameter>--with-gobject</parameter>: This switch enables building
146 of the <application>HarfBuzz</application> GObject wrapper. Remove
147 it if you did not install <application>GLib</application>.
148 </para>
149
150 <para>
151 <parameter>--with-graphite2</parameter>: This switch enables
152 <application>Graphite2</application> support, which is required for
153 building <xref linkend="texlive"/> or <xref linkend="libreoffice"/>
154 with system harfbuzz.
155 </para>
156
157 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
158 href="../../xincludes/gtk-doc-rebuild.xml"/>
159
160 </sect2>
161
162 <sect2 role="content">
163 <title>Contents</title>
164
165 <segmentedlist>
166 <segtitle>Installed Programs</segtitle>
167 <segtitle>Installed Libraries</segtitle>
168 <segtitle>Installed Directories</segtitle>
169
170 <seglistitem>
171 <seg>
172 hb-ot-shape-closure, hb-shape, hb-subset, and
173 hb-view (only if cairo is installed)
174 </seg>
175 <seg>
176 libharfbuzz.so, libharfbuzz-gobject.so, libharfbuzz-icu.so, and
177 libharfbuzz-subset.so
178 </seg>
179 <seg>
180 /usr/{include,lib/cmake,share/gtk-doc/html}/harfbuzz
181 </seg>
182 </seglistitem>
183 </segmentedlist>
184
185 <variablelist>
186 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
187 <?dbfo list-presentation="list"?>
188 <?dbhtml list-presentation="table"?>
189
190 <varlistentry id="hb-ot-shape-closure">
191 <term><command>hb-ot-shape-closure</command></term>
192 <listitem>
193 <para>
194 gives the set of characters contained in a string, represented as
195 single characters and/or single character names. Example:
196 <command>hb-ot-shape-closure
197 /usr/share/fonts/dejavu/DejaVuSans.ttf "Hello World."</command>.
198 </para>
199 <indexterm zone="harfbuzz hb-ot-shape-closure">
200 <primary sortas="b-hb-ot-shape-closure">hb-ot-shape-closure</primary>
201 </indexterm>
202 </listitem>
203 </varlistentry>
204
205 <varlistentry id="hb-shape">
206 <term><command>hb-shape</command></term>
207 <listitem>
208 <para>
209 is used for the conversion of text strings into positioned glyphs.
210 </para>
211 <indexterm zone="harfbuzz hb-shape">
212 <primary sortas="b-hb-shape">hb-shape</primary>
213 </indexterm>
214 </listitem>
215 </varlistentry>
216
217 <varlistentry id="hb-subset">
218 <term><command>hb-subset</command></term>
219 <listitem>
220 <para>
221 is used to create subsets of fonts, and display text using them.
222 </para>
223 <indexterm zone="harfbuzz hb-subset">
224 <primary sortas="b-hb-subset">hb-subset</primary>
225 </indexterm>
226 </listitem>
227 </varlistentry>
228
229 <varlistentry id="hb-view">
230 <term><command>hb-view</command></term>
231 <listitem>
232 <para>
233 may be used for a graphical view of a string shape, using a
234 particular font, as a set of glyphs. Output format is automatically
235 defined by the file extension, the supported ones being
236 ansi/png/svg/pdf/ps/eps. Example:
237 <command>hb-view --output-file=hello.png
238 /usr/share/fonts/dejavu/DejaVuSans.ttf "Hello World."</command>.
239 </para>
240 <indexterm zone="harfbuzz hb-view">
241 <primary sortas="b-hb-view">hb-view</primary>
242 </indexterm>
243 </listitem>
244 </varlistentry>
245
246 <varlistentry id="libharfbuzz">
247 <term><filename class="libraryfile">libharfbuzz.so</filename></term>
248 <listitem>
249 <para>
250 HarfBuzz text shaping library.
251 </para>
252 <indexterm zone="harfbuzz libharfbuzz">
253 <primary sortas="c-libharfbuzz">libharfbuzz.so</primary>
254 </indexterm>
255 </listitem>
256 </varlistentry>
257
258 <varlistentry id="libharfbuzz-gobject">
259 <term><filename class="libraryfile">libharfbuzz-gobject.so</filename></term>
260 <listitem>
261 <para>
262 HarfBuzz text shaping library GObject integration.
263 </para>
264 <indexterm zone="harfbuzz libharfbuzz-gobject">
265 <primary sortas="c-libharfbuzz-gobject">libharfbuzz-gobject.so</primary>
266 </indexterm>
267 </listitem>
268 </varlistentry>
269
270 <varlistentry id="libharfbuzz-icu">
271 <term><filename class="libraryfile">libharfbuzz-icu.so</filename></term>
272 <listitem>
273 <para>
274 HarfBuzz text shaping library ICU integration.
275 </para>
276 <indexterm zone="harfbuzz libharfbuzz-icu">
277 <primary sortas="c-libharfbuzz-icu">libharfbuzz-icu.so</primary>
278 </indexterm>
279 </listitem>
280 </varlistentry>
281
282 </variablelist>
283
284 </sect2>
285
286</sect1>
Note: See TracBrowser for help on using the repository browser.