source: general/graphlib/harfbuzz.xml@ ba31c2b

10.0 10.1 11.0 11.1 9.0 9.1 lazarus qt5new trunk upgradedb xry111/intltool xry111/test-20220226
Last change on this file since ba31c2b was ba31c2b, checked in by Bruce Dubbs <bdubbs@…>, 3 years ago

Update to harfbuzz-2.4.0.
Update to highlight-3.50.

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