source: general/graphlib/freetype2.xml@ c858506

10.1 11.0 ken/refactor-virt lazarus qt5new trunk upgradedb xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since c858506 was c858506, checked in by Ken Moffat <ken@…>, 15 months ago

· freetype-2.10.4 (security fix)
· patch ghostscript for build breakage introduced by freetype-2.10.3.

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

  • Property mode set to 100644
File size: 8.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 freetype2-download-http "&sourceforge-dl;/freetype/freetype-&freetype2-version;.tar.xz">
8 <!ENTITY freetype2-download-ftp "&gentoo-ftp-repo;/freetype-&freetype2-version;.tar.xz">
9 <!ENTITY freetype2-md5sum "0e6c0e9b218be3ba3e26e1d23b1c80dd">
10 <!ENTITY freetype2-size "2.4 MB">
11 <!ENTITY freetype2-buildsize "43 MB (with additional documentation)">
12 <!ENTITY freetype2-time "0.2 SBU (with additional documentation)">
13
14 <!ENTITY freetype2-doc-version "&freetype2-version;">
15 <!ENTITY freetype2-doc-download-http "&sourceforge-dl;/freetype/freetype-doc-&freetype2-doc-version;.tar.xz">
16 <!ENTITY freetype2-doc-download-ftp "&gentoo-ftp-repo;/freetype-doc-&freetype2-doc-version;.tar.xz">
17 <!ENTITY freetype2-doc-md5sum "a389bc390ca8009c758094e71a8fb18d">
18 <!ENTITY freetype2-doc-size "2.0 MB">
19]>
20
21<sect1 id="freetype2" xreflabel="FreeType-&freetype2-version;">
22 <?dbhtml filename="freetype2.html"?>
23
24 <sect1info>
25 <othername>$LastChangedBy$</othername>
26 <date>$Date$</date>
27 </sect1info>
28
29 <title>FreeType-&freetype2-version;</title>
30
31 <indexterm zone="freetype2">
32 <primary sortas="a-FreeType">FreeType</primary>
33 </indexterm>
34
35 <sect2 role="package">
36 <title>Introduction to FreeType2</title>
37
38 <para>
39 The <application>FreeType2</application> package contains
40 a library which allows applications to properly render
41 <application>TrueType</application> fonts.
42 </para>
43
44 &lfs10_checked;
45
46 <bridgehead renderas="sect3">Package Information</bridgehead>
47 <itemizedlist spacing="compact">
48 <listitem>
49 <para>
50 Download (HTTP): <ulink url="&freetype2-download-http;"/>
51 </para>
52 </listitem>
53<!-- <listitem>
54 <para>
55 Download (FTP): <ulink url="&freetype2-download-ftp;"/>
56 </para>
57 </listitem> -->
58 <listitem>
59 <para>
60 Download MD5 sum: &freetype2-md5sum;
61 </para>
62 </listitem>
63 <listitem>
64 <para>
65 Download size: &freetype2-size;
66 </para>
67 </listitem>
68 <listitem>
69 <para>
70 Estimated disk space required: &freetype2-buildsize;
71 </para>
72 </listitem>
73 <listitem>
74 <para>
75 Estimated build time: &freetype2-time;
76 </para>
77 </listitem>
78 </itemizedlist>
79
80 <bridgehead renderas="sect3">Additional Downloads</bridgehead>
81 <itemizedlist spacing="compact">
82 <title>Additional Documentation</title>
83 <listitem>
84 <para>
85 Download (HTTP): <ulink url="&freetype2-doc-download-http;"/>
86 </para>
87 </listitem>
88 <listitem>
89 <para>
90 Download MD5 sum: &freetype2-doc-md5sum;
91 </para>
92 </listitem>
93 <listitem>
94 <para>
95 Download size: &freetype2-doc-size;
96 </para>
97 </listitem>
98 </itemizedlist>
99
100 <bridgehead renderas="sect3">FreeType2 Dependencies</bridgehead>
101
102 <bridgehead renderas="sect4">Recommended</bridgehead>
103 <para role="recommended">
104 <xref linkend="harfbuzz"/>
105 (first, install without it, after it is installed, reinstall
106 <xref linkend="freetype2"/>),
107 <xref linkend="libpng"/>, and
108 <xref linkend="which"/>
109 </para>
110
111 <bridgehead renderas="sect4">Optional</bridgehead>
112 <para role="optional">
113 <xref linkend="brotli"/>
114 </para>
115
116 <bridgehead renderas="sect4">Optional (for documentation)</bridgehead>
117 <para role="optional">
118 <ulink url="https://pypi.org/project/docwriter/">docwriter</ulink>
119 </para>
120
121 <para condition="html" role="usernotes">User Notes:
122 <ulink url="&blfs-wiki;/freetype2"/>
123 </para>
124 </sect2>
125
126 <sect2 role="installation">
127 <title>Installation of FreeType2</title>
128
129 <para>
130 If you downloaded the additional documentation, unpack it into the
131 source tree using the following command:
132 </para>
133
134<screen><userinput>tar -xf ../freetype-doc-&freetype2-doc-version;.tar.xz --strip-components=2 -C docs</userinput></screen>
135
136 <para>
137 Install <application>FreeType2</application> by running the following
138 commands:
139 </para>
140
141<screen><userinput>sed -ri "s:.*(AUX_MODULES.*valid):\1:" modules.cfg &amp;&amp;
142
143sed -r "s:.*(#.*SUBPIXEL_RENDERING) .*:\1:" \
144 -i include/freetype/config/ftoption.h &amp;&amp;
145
146./configure --prefix=/usr --enable-freetype-config --disable-static &amp;&amp;
147make</userinput></screen>
148
149 <para>
150 This package does not come with a test suite.
151 </para>
152
153 <para>
154 Now, as the <systemitem class="username">root</systemitem> user:
155 </para>
156
157<screen role="root"><userinput>make install</userinput></screen>
158
159 <para>
160 If you downloaded the optional documentation, install it as the
161 <systemitem class="username">root</systemitem> user:
162 </para>
163
164<screen role="root"><userinput>install -v -m755 -d /usr/share/doc/freetype-&freetype2-version; &amp;&amp;
165cp -v -R docs/* /usr/share/doc/freetype-&freetype2-version; &amp;&amp;
166rm -v /usr/share/doc/freetype-&freetype2-version;/freetype-config.1</userinput></screen>
167
168 </sect2>
169
170 <sect2 role="commands">
171 <title>Command Explanations</title>
172
173 <para>
174 <command>sed -ri ...</command>: First command enables GX/AAT and OpenType
175 table validation and second command enables Subpixel Rendering. Note that
176 Subpixel Rendering may have patent issues. Be sure to read the
177 <literal>'Other patent issues'</literal> part of <ulink
178 url="http://www.freetype.org/patents.html"/> before enabling this option.
179 </para>
180
181 <para>
182 <parameter>--enable-freetype-config</parameter>: This switch
183 ensure that the man page for freetype-config is installed.
184 </para>
185
186 <para>
187 <option>--without-harfbuzz</option>: If
188 <application>harfbuzz</application> is installed prior to
189 <application>freetype</application> without
190 <application>freetype</application> support, use this switch to avoid a
191 build failure.
192 </para>
193
194 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
195 href="../../xincludes/static-libraries.xml"/>
196 <!-- No longer valid with 2.10.1, /usr/bin/freetype-config is installed
197 by the 'make install' command.
198 <para>
199 <command>cp builds/unix/freetype-config /usr/bin</command>: Manually
200 place the freetype configureation program needed by other programs when
201 using the freetype library.
202 </para>
203 -->
204
205 </sect2>
206
207 <sect2 role="content">
208 <title>Contents</title>
209
210 <segmentedlist>
211 <segtitle>Installed Program</segtitle>
212 <segtitle>Installed Library</segtitle>
213 <segtitle>Installed Directories</segtitle>
214
215 <seglistitem>
216 <seg>
217 freetype-config
218 </seg>
219 <seg>
220 libfreetype.so
221 </seg>
222 <seg>
223 /usr/include/freetype2 and
224 /usr/share/doc/freetype-&freetype2-version;
225 </seg>
226 </seglistitem>
227 </segmentedlist>
228
229 <variablelist>
230 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
231 <?dbfo list-presentation="list"?>
232 <?dbhtml list-presentation="table"?>
233
234 <varlistentry id="freetype-config">
235 <term><command>freetype-config</command></term>
236 <listitem>
237 <para>
238 is used to get <application>FreeType</application> compilation
239 and linking information.
240 </para>
241 <indexterm zone="freetype2 freetype-config">
242 <primary sortas="b-freetype-config">freetype2-config</primary>
243 </indexterm>
244 </listitem>
245 </varlistentry>
246
247 <varlistentry id="libfreetype">
248 <term><filename class="libraryfile">libfreetype.so</filename></term>
249 <listitem>
250 <para>
251 contains functions for rendering various font types, such
252 as TrueType and Type1.
253 </para>
254 <indexterm zone="freetype2 libfreetype">
255 <primary sortas="c-libfreetype">libfreetype.so</primary>
256 </indexterm>
257 </listitem>
258 </varlistentry>
259
260 </variablelist>
261
262 </sect2>
263
264</sect1>
Note: See TracBrowser for help on using the repository browser.