source: general/graphlib/harfbuzz.xml@ dc96204

10.0 10.1 11.0 ken/refactor-virt lazarus qt5new trunk xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since dc96204 was dc96204, checked in by Douglas R. Reno <renodr@…>, 16 months ago

Update to harfbuzz-2.6.8
Update to valgrind-3.16.1
Update to rsync-3.2.1
Update to libnma-1.8.30

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

  • Property mode set to 100644
File size: 9.0 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 "c8d4f2aeed6e576bd42f9dc6def1b1ae">
11 <!ENTITY harfbuzz-size "8.6 MB">
12 <!ENTITY harfbuzz-buildsize "241 MB (add 31 MB for tests)">
13 <!ENTITY harfbuzz-time "0.5 SBU (Using parallelism=4; add 2.1 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 &lfs91_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>./configure --prefix=/usr --with-gobject --with-graphite2 &amp;&amp;
123make</userinput></screen>
124
125 <para>
126 To test the results, issue: <command>make check</command>.
127 </para>
128
129 <para>
130 Now, as the <systemitem class="username">root</systemitem> user:
131 </para>
132
133<screen role="root"><userinput>make install</userinput></screen>
134 </sect2>
135
136 <sect2 role="commands">
137 <title>Command Explanations</title>
138
139 <para>
140 <parameter>--with-gobject</parameter>: This switch enables building
141 of the <application>HarfBuzz</application> GObject wrapper. Remove
142 it if you did not install <application>GLib</application>.
143 </para>
144
145 <para>
146 <parameter>--with-graphite2</parameter>: This switch enables
147 <application>Graphite2</application> support, which is required for
148 building <xref linkend="texlive"/> or <xref linkend="libreoffice"/>
149 with system harfbuzz.
150 </para>
151
152 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
153 href="../../xincludes/gtk-doc-rebuild.xml"/>
154
155 </sect2>
156
157 <sect2 role="content">
158 <title>Contents</title>
159
160 <segmentedlist>
161 <segtitle>Installed Programs</segtitle>
162 <segtitle>Installed Libraries</segtitle>
163 <segtitle>Installed Directories</segtitle>
164
165 <seglistitem>
166 <seg>
167 hb-ot-shape-closure, hb-shape, hb-subset, and
168 hb-view (only if cairo is installed)
169 </seg>
170 <seg>
171 libharfbuzz.so, libharfbuzz-gobject.so, libharfbuzz-icu.so, and
172 libharfbuzz-subset.so
173 </seg>
174 <seg>
175 /usr/{include,lib/cmake,share/gtk-doc/html}/harfbuzz
176 </seg>
177 </seglistitem>
178 </segmentedlist>
179
180 <variablelist>
181 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
182 <?dbfo list-presentation="list"?>
183 <?dbhtml list-presentation="table"?>
184
185 <varlistentry id="hb-ot-shape-closure">
186 <term><command>hb-ot-shape-closure</command></term>
187 <listitem>
188 <para>
189 gives the set of characters contained in a string, represented as
190 single characters and/or single character names. Example:
191 <command>hb-ot-shape-closure
192 /usr/share/fonts/dejavu/DejaVuSans.ttf "Hello World."</command>.
193 </para>
194 <indexterm zone="harfbuzz hb-ot-shape-closure">
195 <primary sortas="b-hb-ot-shape-closure">hb-ot-shape-closure</primary>
196 </indexterm>
197 </listitem>
198 </varlistentry>
199
200 <varlistentry id="hb-shape">
201 <term><command>hb-shape</command></term>
202 <listitem>
203 <para>
204 is used for the conversion of text strings into positioned glyphs.
205 </para>
206 <indexterm zone="harfbuzz hb-shape">
207 <primary sortas="b-hb-shape">hb-shape</primary>
208 </indexterm>
209 </listitem>
210 </varlistentry>
211
212 <varlistentry id="hb-subset">
213 <term><command>hb-subset</command></term>
214 <listitem>
215 <para>
216 is used to create subsets of fonts, and display text using them.
217 </para>
218 <indexterm zone="harfbuzz hb-subset">
219 <primary sortas="b-hb-subset">hb-subset</primary>
220 </indexterm>
221 </listitem>
222 </varlistentry>
223
224 <varlistentry id="hb-view">
225 <term><command>hb-view</command></term>
226 <listitem>
227 <para>
228 may be used for a graphical view of a string shape, using a
229 particular font, as a set of glyphs. Output format is automatically
230 defined by the file extension, the supported ones being
231 ansi/png/svg/pdf/ps/eps. Example:
232 <command>hb-view --output-file=hello.png
233 /usr/share/fonts/dejavu/DejaVuSans.ttf "Hello World."</command>.
234 </para>
235 <indexterm zone="harfbuzz hb-view">
236 <primary sortas="b-hb-view">hb-view</primary>
237 </indexterm>
238 </listitem>
239 </varlistentry>
240
241 <varlistentry id="libharfbuzz">
242 <term><filename class="libraryfile">libharfbuzz.so</filename></term>
243 <listitem>
244 <para>
245 HarfBuzz text shaping library.
246 </para>
247 <indexterm zone="harfbuzz libharfbuzz">
248 <primary sortas="c-libharfbuzz">libharfbuzz.so</primary>
249 </indexterm>
250 </listitem>
251 </varlistentry>
252
253 <varlistentry id="libharfbuzz-gobject">
254 <term><filename class="libraryfile">libharfbuzz-gobject.so</filename></term>
255 <listitem>
256 <para>
257 HarfBuzz text shaping library GObject integration.
258 </para>
259 <indexterm zone="harfbuzz libharfbuzz-gobject">
260 <primary sortas="c-libharfbuzz-gobject">libharfbuzz-gobject.so</primary>
261 </indexterm>
262 </listitem>
263 </varlistentry>
264
265 <varlistentry id="libharfbuzz-icu">
266 <term><filename class="libraryfile">libharfbuzz-icu.so</filename></term>
267 <listitem>
268 <para>
269 HarfBuzz text shaping library ICU integration.
270 </para>
271 <indexterm zone="harfbuzz libharfbuzz-icu">
272 <primary sortas="c-libharfbuzz-icu">libharfbuzz-icu.so</primary>
273 </indexterm>
274 </listitem>
275 </varlistentry>
276
277 </variablelist>
278
279 </sect2>
280
281</sect1>
Note: See TracBrowser for help on using the repository browser.