source: general/graphlib/harfbuzz.xml@ e84b992c

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

Update to Harfbuzz-1.9.0

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

  • 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 harfbuzz-download-http
8 "https://www.freedesktop.org/software/harfbuzz/release/harfbuzz-&harfbuzz-version;.tar.bz2">
9 <!ENTITY harfbuzz-download-ftp " ">
10 <!ENTITY harfbuzz-md5sum "263a3f1cb014e3ad2e4123c238a9bfc5">
11 <!ENTITY harfbuzz-size "3.7 MB">
12 <!ENTITY harfbuzz-buildsize "119 MB (with tests)">
13 <!ENTITY harfbuzz-time "1.1 SBU (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 &lfs83_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 linkend="icu"/>, and
80 <xref role="first" linkend="freetype2"/>
81 (after <xref role="nodep" linkend="harfbuzz"/> is installed, reinstall
82 <xref role="nodep" linkend="freetype2"/>)
83 </para>
84
85 <bridgehead renderas="sect4">Optional</bridgehead>
86 <para role="optional">
87 <xref linkend="cairo"/>,
88 <xref linkend="gobject-introspection"/>,
89 <xref linkend="gtk-doc"/>,
90 <xref role="first" linkend="graphite2"/> (required for building
91 <xref role="nodep" linkend="texlive"/> or
92 <xref role="nodep" linkend="libreoffice"/> with system harfbuzz)
93 <xref linkend="python2"/> (required for the testsuite), and
94 <ulink url="https://pypi.org/project/FontTools/">FontTools</ulink> (for
95 the testsuite)
96 </para>
97
98 <warning>
99 <para>
100 Recommended dependencies are not strictly required to build
101 the package. However, you might not get expected results at
102 runtime if you don't install them. Please do not report bugs
103 with this package if you <emphasis>have not</emphasis>
104 installed the recommended dependencies.
105 </para>
106 </warning>
107
108 <para condition="html" role="usernotes">
109 User Notes: <ulink url="&blfs-wiki;/harfbuzz"/>
110 </para>
111 </sect2>
112
113 <sect2 role="installation">
114 <title>Installation of HarfBuzz</title>
115
116 <para>
117 Install <application>HarfBuzz</application> by running the following
118 commands:
119 </para>
120
121<screen><userinput>./configure --prefix=/usr --with-gobject &amp;&amp;
122make</userinput></screen>
123
124 <para>
125 To test the results, issue: <command>make check</command>.
126 </para>
127
128 <para>
129 Now, as the <systemitem class="username">root</systemitem> user:
130 </para>
131
132<screen role="root"><userinput>make install</userinput></screen>
133 </sect2>
134
135 <sect2 role="commands">
136 <title>Command Explanations</title>
137
138 <para>
139 <parameter>--with-gobject</parameter>: This switch enables building
140 of the <application>HarfBuzz</application> GObject wrapper. Remove
141 it if you did not install <application>GLib</application>.
142 </para>
143
144 <para>
145 <option>--with-graphite2</option>: This switch enables
146 <application>Graphite2</application> support, which is required for
147 building <xref linkend="texlive"/> or <xref linkend="libreoffice"/>
148 with system harfbuzz.
149 </para>
150
151 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
152 href="../../xincludes/gtk-doc-rebuild.xml"/>
153
154 </sect2>
155
156 <sect2 role="content">
157 <title>Contents</title>
158
159 <segmentedlist>
160 <segtitle>Installed Programs</segtitle>
161 <segtitle>Installed Libraries</segtitle>
162 <segtitle>Installed Directories</segtitle>
163
164 <seglistitem>
165 <seg>
166 hb-ot-shape-closure, hb-shape, hb-subset, and
167 hb-view (only if cairo is installed)
168 </seg>
169 <seg>
170 libharfbuzz.so, libharfbuzz-gobject.so, libharfbuzz-subset.so,
171 and libharfbuzz-icu.so
172 </seg>
173 <seg>
174 /usr/{include,lib/cmake,share/gtk-doc/html}/harfbuzz
175 </seg>
176 </seglistitem>
177 </segmentedlist>
178
179 <variablelist>
180 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
181 <?dbfo list-presentation="list"?>
182 <?dbhtml list-presentation="table"?>
183
184 <varlistentry id="hb-ot-shape-closure">
185 <term><command>hb-ot-shape-closure</command></term>
186 <listitem>
187 <para>
188 gives the set of characters contained in a string, represented as
189 single characters and/or single character names. Example:
190 <command>hb-ot-shape-closure
191 /usr/share/fonts/dejavu/DejaVuSans.ttf "Hello World."</command>.
192 </para>
193 <indexterm zone="harfbuzz hb-ot-shape-closure">
194 <primary sortas="b-hb-ot-shape-closure">hb-ot-shape-closure</primary>
195 </indexterm>
196 </listitem>
197 </varlistentry>
198
199 <varlistentry id="hb-shape">
200 <term><command>hb-shape</command></term>
201 <listitem>
202 <para>
203 is used for the conversion of text strings into positioned glyphs.
204 </para>
205 <indexterm zone="harfbuzz hb-shape">
206 <primary sortas="b-hb-shape">hb-shape</primary>
207 </indexterm>
208 </listitem>
209 </varlistentry>
210
211 <varlistentry id="hb-view">
212 <term><command>hb-view</command></term>
213 <listitem>
214 <para>
215 may be used for a graphical view of a string shape, using a
216 particular font, as a set of glyphs. Output format is automatically
217 defined by the file extension, the supported ones being
218 ansi/png/svg/pdf/ps/eps. Example:
219 <command>hb-view --output-file=hello.png
220 /usr/share/fonts/dejavu/DejaVuSans.ttf "Hello World."</command>.
221 </para>
222 <indexterm zone="harfbuzz hb-view">
223 <primary sortas="b-hb-view">hb-view</primary>
224 </indexterm>
225 </listitem>
226 </varlistentry>
227
228 <varlistentry id="libharfbuzz">
229 <term><filename class="libraryfile">libharfbuzz.so</filename></term>
230 <listitem>
231 <para>
232 HarfBuzz text shaping library.
233 </para>
234 <indexterm zone="harfbuzz libharfbuzz">
235 <primary sortas="c-libharfbuzz">libharfbuzz.so</primary>
236 </indexterm>
237 </listitem>
238 </varlistentry>
239
240 <varlistentry id="libharfbuzz-gobject">
241 <term><filename class="libraryfile">libharfbuzz-gobject.so</filename></term>
242 <listitem>
243 <para>
244 HarfBuzz text shaping library GObject integration.
245 </para>
246 <indexterm zone="harfbuzz libharfbuzz-gobject">
247 <primary sortas="c-libharfbuzz-gobject">libharfbuzz-gobject.so</primary>
248 </indexterm>
249 </listitem>
250 </varlistentry>
251
252 <varlistentry id="libharfbuzz-icu">
253 <term><filename class="libraryfile">libharfbuzz-icu.so</filename></term>
254 <listitem>
255 <para>
256 HarfBuzz text shaping library ICU integration.
257 </para>
258 <indexterm zone="harfbuzz libharfbuzz-icu">
259 <primary sortas="c-libharfbuzz-icu">libharfbuzz-icu.so</primary>
260 </indexterm>
261 </listitem>
262 </varlistentry>
263
264 </variablelist>
265
266 </sect2>
267
268</sect1>
Note: See TracBrowser for help on using the repository browser.