source: general/graphlib/harfbuzz.xml@ 9b8c04ed

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 9b8c04ed was 9b8c04ed, checked in by Pierre Labastie <pieere@…>, 2 years ago

Harfbuzz-2.7.4

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@24035 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://github.com/harfbuzz/harfbuzz/releases/download/&harfbuzz-version;/harfbuzz-&harfbuzz-version;.tar.xz">
9 <!ENTITY harfbuzz-download-ftp " ">
10 <!ENTITY harfbuzz-md5sum "6d8393e6fb84edfb15997d1c5ba35b1b">
11 <!ENTITY harfbuzz-size "9.1 MB">
12 <!ENTITY harfbuzz-buildsize "240 MB (add 6 MB for tests)">
13 <!ENTITY harfbuzz-time "0.4 SBU (Using parallelism=4; add 0.2 SBU for 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 &lfs10_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 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>mkdir build &amp;&amp;
123cd build &amp;&amp;
124
125meson --prefix=/usr -Dgraphite=enabled &amp;&amp;
126ninja</userinput></screen>
127
128 <para>
129 To test the results, issue: <command>ninja test</command>.
130 </para>
131
132 <para>
133 Now, as the <systemitem class="username">root</systemitem> user:
134 </para>
135
136<screen role="root"><userinput>ninja install</userinput></screen>
137 </sect2>
138
139 <sect2 role="commands">
140 <title>Command Explanations</title>
141
142<!--
143 <para>
144 <parameter>- -with-gobject</parameter>: This switch enables building
145 of the <application>HarfBuzz</application> GObject wrapper. Remove
146 it if you did not install <application>GLib</application>.
147 </para>
148-->
149 <para>
150 <parameter>-Dgraphite=enabled</parameter>: This switch enables
151 <application>Graphite2</application> support, which is required for
152 building <xref linkend="texlive"/> or <xref linkend="libreoffice"/>
153 with system harfbuzz.
154 </para>
155
156 <para>
157 <option>-Ddocs=false</option>: If <xref linkend="gtk-doc"/> is installed,
158 the documentation is built and installed. This switch prevents that.
159 </para>
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 Directories</segtitle>
170
171 <seglistitem>
172 <seg>
173 hb-ot-shape-closure, hb-shape, hb-subset, and
174 hb-view (only if cairo is installed)
175 </seg>
176 <seg>
177 libharfbuzz.so, libharfbuzz-gobject.so, libharfbuzz-icu.so, and
178 libharfbuzz-subset.so
179 </seg>
180 <seg>
181 /usr/{include,lib/cmake,share/gtk-doc/html}/harfbuzz
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="hb-ot-shape-closure">
192 <term><command>hb-ot-shape-closure</command></term>
193 <listitem>
194 <para>
195 gives the set of characters contained in a string, represented as
196 single characters and/or single character names. Example:
197 <command>hb-ot-shape-closure
198 /usr/share/fonts/dejavu/DejaVuSans.ttf "Hello World."</command>.
199 </para>
200 <indexterm zone="harfbuzz hb-ot-shape-closure">
201 <primary sortas="b-hb-ot-shape-closure">hb-ot-shape-closure</primary>
202 </indexterm>
203 </listitem>
204 </varlistentry>
205
206 <varlistentry id="hb-shape">
207 <term><command>hb-shape</command></term>
208 <listitem>
209 <para>
210 is used for the conversion of text strings into positioned glyphs.
211 </para>
212 <indexterm zone="harfbuzz hb-shape">
213 <primary sortas="b-hb-shape">hb-shape</primary>
214 </indexterm>
215 </listitem>
216 </varlistentry>
217
218 <varlistentry id="hb-subset">
219 <term><command>hb-subset</command></term>
220 <listitem>
221 <para>
222 is used to create subsets of fonts, and display text using them.
223 </para>
224 <indexterm zone="harfbuzz hb-subset">
225 <primary sortas="b-hb-subset">hb-subset</primary>
226 </indexterm>
227 </listitem>
228 </varlistentry>
229
230 <varlistentry id="hb-view">
231 <term><command>hb-view</command></term>
232 <listitem>
233 <para>
234 displays a graphical view of a string shape using a
235 particular font as a set of glyphs. The output format is
236 automatically defined by the file extension, the supported ones
237 being ansi/png/svg/pdf/ps/eps. For example:
238 <command>hb-view --output-file=hello.png
239 /usr/share/fonts/dejavu/DejaVuSans.ttf "Hello World."</command>.
240 </para>
241 <indexterm zone="harfbuzz hb-view">
242 <primary sortas="b-hb-view">hb-view</primary>
243 </indexterm>
244 </listitem>
245 </varlistentry>
246
247 <varlistentry id="libharfbuzz">
248 <term><filename class="libraryfile">libharfbuzz.so</filename></term>
249 <listitem>
250 <para>
251 is the HarfBuzz text shaping library.
252 </para>
253 <indexterm zone="harfbuzz libharfbuzz">
254 <primary sortas="c-libharfbuzz">libharfbuzz.so</primary>
255 </indexterm>
256 </listitem>
257 </varlistentry>
258
259 <varlistentry id="libharfbuzz-gobject">
260 <term><filename class="libraryfile">libharfbuzz-gobject.so</filename></term>
261 <listitem>
262 <para>
263 provides GObject integration for the HarfBuzz text shaping library.
264 </para>
265 <indexterm zone="harfbuzz libharfbuzz-gobject">
266 <primary sortas="c-libharfbuzz-gobject">libharfbuzz-gobject.so</primary>
267 </indexterm>
268 </listitem>
269 </varlistentry>
270
271 <varlistentry id="libharfbuzz-icu">
272 <term><filename class="libraryfile">libharfbuzz-icu.so</filename></term>
273 <listitem>
274 <para>
275 provides ICU integration for the HarfBuzz text shaping library.
276 </para>
277 <indexterm zone="harfbuzz libharfbuzz-icu">
278 <primary sortas="c-libharfbuzz-icu">libharfbuzz-icu.so</primary>
279 </indexterm>
280 </listitem>
281 </varlistentry>
282
283 </variablelist>
284
285 </sect2>
286
287</sect1>
Note: See TracBrowser for help on using the repository browser.