source: general/graphlib/fontconfig.xml@ 32471cc

10.0 10.1 11.0 11.1 11.2 8.0 8.1 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind lazarus perl-modules plabs/python-mods qt5new trunk upgradedb xry111/intltool xry111/soup3 xry111/test-20220226
Last change on this file since 32471cc was 32471cc, checked in by Bruce Dubbs <bdubbs@…>, 6 years ago

Fix fontconfig seds

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

  • Property mode set to 100644
File size: 12.7 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 fontconfig-download-http
8 "http://www.freedesktop.org/software/fontconfig/release/fontconfig-&fontconfig-version;.tar.bz2">
9 <!ENTITY fontconfig-download-ftp " ">
10 <!ENTITY fontconfig-md5sum "b5af5a423ee3b5cfc34846838963c058">
11 <!ENTITY fontconfig-size "1.5 MB">
12 <!ENTITY fontconfig-buildsize "14 MB (with tests)">
13 <!ENTITY fontconfig-time "0.4 SBU (with tests)">
14]>
15
16<sect1 id="fontconfig" xreflabel="Fontconfig-&fontconfig-version;">
17 <?dbhtml filename="fontconfig.html"?>
18
19 <sect1info>
20 <othername>$LastChangedBy$</othername>
21 <date>$Date$</date>
22 </sect1info>
23
24 <title>Fontconfig-&fontconfig-version;</title>
25
26 <indexterm zone="fontconfig">
27 <primary sortas="a-Fontconfig">Fontconfig</primary>
28 </indexterm>
29
30 <sect2 role="package">
31 <title>Introduction to Fontconfig</title>
32
33 <para>
34 The <application>Fontconfig</application> package contains
35 a library and support programs used for configuring and
36 customizing font access.
37 </para>
38
39 &lfs80_checked;
40
41 <bridgehead renderas="sect3">Package Information</bridgehead>
42 <itemizedlist spacing="compact">
43 <listitem>
44 <para>
45 Download (HTTP): <ulink url="&fontconfig-download-http;"/>
46 </para>
47 </listitem>
48 <listitem>
49 <para>
50 Download (FTP): <ulink url="&fontconfig-download-ftp;"/>
51 </para>
52 </listitem>
53 <listitem>
54 <para>
55 Download MD5 sum: &fontconfig-md5sum;
56 </para>
57 </listitem>
58 <listitem>
59 <para>
60 Download size: &fontconfig-size;
61 </para>
62 </listitem>
63 <listitem>
64 <para>
65 Estimated disk space required: &fontconfig-buildsize;
66 </para>
67 </listitem>
68 <listitem>
69 <para>
70 Estimated build time: &fontconfig-time;
71 </para>
72 </listitem>
73 </itemizedlist>
74
75 <bridgehead renderas="sect3">Fontconfig Dependencies</bridgehead>
76
77 <bridgehead renderas="sect4">Required</bridgehead>
78 <para role="required">
79 <xref linkend="freetype2"/>
80 </para>
81
82 <bridgehead renderas="sect4">Optional</bridgehead>
83 <para role="optional">
84 <xref linkend="docbook-utils"/> and
85 <xref linkend="libxml2"/>,
86 <xref linkend="texlive"/> (or <xref linkend="tl-installer"/>)
87 </para>
88
89 <note>
90 <para>
91 If you have <application>DocBook Utils</application> installed and
92 you remove the <parameter>--disable-docs</parameter> parameter from
93 the <command>configure</command> command below, you must have
94 <xref linkend="perl-sgmlspm"/> and <xref linkend="texlive"/> installed
95 also, or the <application>Fontconfig</application> build will fail.
96 </para>
97 </note>
98
99 <para condition="html" role="usernotes">User Notes:
100 <ulink url='&blfs-wiki;/Fontconfig'/>
101 </para>
102 </sect2>
103
104 <sect2 role="installation">
105 <title>Installation of Fontconfig</title>
106
107 <para>
108 Install <application>Fontconfig</application> by running the following
109 commands:
110 </para>
111
112<screen><userinput>sed -e '/FC_CHAR_WIDTH/s/CHAR_WIDTH/CHARWIDTH/' \
113 -e '/FC_CHARWIDTH/a #define FC_CHAR_WIDTH FC_CHARWIDTH' \
114 -i fontconfig/fontconfig.h &amp;&amp;
115sed 's/CHAR_WIDTH/CHARWIDTH/' -i src/fcobjs.h &amp;&amp;
116
117./configure --prefix=/usr \
118 --sysconfdir=/etc \
119 --localstatedir=/var \
120 --disable-docs \
121 --docdir=/usr/share/doc/fontconfig-&fontconfig-version; &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
134 <para>
135 If you did not remove the <parameter>--disable-docs</parameter>
136 parameter from the <command>configure</command> command, you can install
137 the pre-generated documentation by using the following commands as the
138 <systemitem class="username">root</systemitem> user:
139 </para>
140
141<screen role="root"><userinput>install -v -dm755 \
142 /usr/share/{man/man{3,5},doc/fontconfig-&fontconfig-version;/fontconfig-devel} &amp;&amp;
143install -v -m644 fc-*/*.1 /usr/share/man/man1 &amp;&amp;
144install -v -m644 doc/*.3 /usr/share/man/man3 &amp;&amp;
145install -v -m644 doc/fonts-conf.5 /usr/share/man/man5 &amp;&amp;
146install -v -m644 doc/fontconfig-devel/* \
147 /usr/share/doc/fontconfig-&fontconfig-version;/fontconfig-devel &amp;&amp;
148install -v -m644 doc/*.{pdf,sgml,txt,html} \
149 /usr/share/doc/fontconfig-&fontconfig-version;</userinput></screen>
150
151 </sect2>
152
153 <sect2 role="commands">
154 <title>Command Explanations</title>
155
156 <para>
157 <command>sed ...</command>: Fix a conflict in names caused by
158 changes to a glibc-2.25 header file.
159 </para>
160
161 <para>
162 <parameter>--disable-docs</parameter>: This switch avoids building the
163 documentation (the release tarball includes pre-generated
164 documentation).
165 </para>
166
167 </sect2>
168
169 <sect2 role="configuration">
170 <title>Configuring Fontconfig</title>
171
172 <sect3 id="fontconfig-config">
173 <title>Config Files</title>
174
175 <para>
176 <filename>
177 /etc/fonts/*,
178 /etc/fonts/conf.d/* and
179 /usr/share/fontconfig/conf.avail/*
180 </filename>
181 </para>
182
183 <indexterm zone="fontconfig fontconfig-config">
184 <primary sortas="e-etc-fonts">/etc/fonts/*</primary>
185 </indexterm>
186
187 <indexterm zone="fontconfig fontconfig-config">
188 <primary sortas="e-etc-fonts-conf.d">/etc/fonts/conf.d/*</primary>
189 </indexterm>
190
191 <indexterm zone="fontconfig fontconfig-config">
192 <primary sortas="e-usr-share-fontconfig-conf.avail">/usr/share/fontconfig/conf.avail/*</primary>
193 </indexterm>
194
195 </sect3>
196
197 <sect3>
198 <title>Configuration Information</title>
199
200 <para>
201 The main configuration file for <application>Fontconfig</application> is
202 <filename>/etc/fonts/fonts.conf</filename>. Generally you do not want
203 to edit this file. It will also read <filename>/etc/fonts/local.conf</filename>
204 and any files in <filename class="directory">/etc/fonts/conf.d</filename>.
205 To put a new font directory in the configuration, create
206 (or update) the <filename>/etc/fonts/local.conf</filename> file with your
207 local information or add a new file in
208 <filename class="directory">/etc/fonts/conf.d</filename>. The default
209 location of fonts in <application>Fontconfig</application> is:
210 </para>
211
212 <itemizedlist spacing="compact">
213 <listitem>
214 <para>/usr/share/fonts</para>
215 </listitem>
216 <listitem>
217 <para>~/.local/share/fonts</para>
218 </listitem>
219 <listitem>
220 <para>~/.fonts <emphasis>(this is now deprecated, but for the moment
221 it still works)</emphasis></para>
222 </listitem>
223 </itemizedlist>
224
225 <para>
226 <application>Fontconfig</application> also ships many example
227 configuration files in the
228 <filename class="directory">/usr/share/fontconfig/conf.avail</filename>
229 directory. Symlinking specific files to
230 <filename class="directory">/etc/fonts/conf.d</filename>
231 will enable them. The default setup is generally good enough for
232 most users. See <filename>/etc/fonts/conf.d/README</filename>
233 for a description of the configuration files.
234 </para>
235
236 <indexterm zone="fontconfig fontconfig-config">
237 <primary sortas="e-usr-share-fonts">/usr/share/fonts</primary>
238 </indexterm>
239
240 <indexterm zone="fontconfig fontconfig-config">
241 <primary sortas="e-AA.fonts">~/.fonts</primary>
242 </indexterm>
243
244 <para>
245 More information about configuring <application>Fontconfig</application>
246 can be found in the user's manual in <ulink
247 url="file:///usr/share/doc/fontconfig-&fontconfig-version;/fontconfig-user.html"/>
248 </para>
249
250 </sect3>
251
252 </sect2>
253
254 <sect2 role="content">
255 <title>Contents</title>
256
257 <segmentedlist>
258 <segtitle>Installed Programs</segtitle>
259 <segtitle>Installed Library</segtitle>
260 <segtitle>Installed Directories</segtitle>
261
262 <seglistitem>
263 <seg>
264 fc-cache, fc-cat, fc-list, fc-match, fc-pattern, fc-query,
265 fc-scan and fc-validate
266 </seg>
267 <seg>
268 libfontconfig.so
269 </seg>
270 <seg>
271 /etc/fonts,
272 /usr/include/fontconfig,
273 /usr/share/doc/fontconfig-&fontconfig-version;,
274 /usr/share/fontconfig,
275 /usr/share/xml/fontconfig and
276 /var/cache/fontconfig
277 </seg>
278 </seglistitem>
279 </segmentedlist>
280
281 <variablelist>
282 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
283 <?dbfo list-presentation="list"?>
284 <?dbhtml list-presentation="table"?>
285
286 <varlistentry id="fc-cache">
287 <term><command>fc-cache</command></term>
288 <listitem>
289 <para>
290 is used to create font information caches.
291 </para>
292 <indexterm zone="fontconfig fc-cache">
293 <primary sortas="b-fc-cache">fc-cache</primary>
294 </indexterm>
295 </listitem>
296 </varlistentry>
297
298 <varlistentry id="fc-cat">
299 <term><command>fc-cat</command></term>
300 <listitem>
301 <para>
302 is used to read font information caches.
303 </para>
304 <indexterm zone="fontconfig fc-cat">
305 <primary sortas="b-fc-cat">fc-cat</primary>
306 </indexterm>
307 </listitem>
308 </varlistentry>
309
310 <varlistentry id="fc-list">
311 <term><command>fc-list</command></term>
312 <listitem>
313 <para>
314 is used to create font lists.
315 </para>
316 <indexterm zone="fontconfig fc-list">
317 <primary sortas="b-fc-list">fc-list</primary>
318 </indexterm>
319 </listitem>
320 </varlistentry>
321
322 <varlistentry id="fc-match">
323 <term><command>fc-match</command></term>
324 <listitem>
325 <para>
326 is used to match available fonts, or find fonts that match
327 a given pattern.
328 </para>
329 <indexterm zone="fontconfig fc-match">
330 <primary sortas="b-fc-match">fc-match</primary>
331 </indexterm>
332 </listitem>
333 </varlistentry>
334
335 <varlistentry id="fc-pattern">
336 <term><command>fc-pattern</command></term>
337 <listitem>
338 <para>
339 is used to parse pattern (empty pattern by default) and show
340 the parsed result.
341 </para>
342 <indexterm zone="fontconfig fc-pattern">
343 <primary sortas="b-fc-pattern">fc-pattern</primary>
344 </indexterm>
345 </listitem>
346 </varlistentry>
347
348 <varlistentry id="fc-query">
349 <term><command>fc-query</command></term>
350 <listitem>
351 <para>
352 is used to query fonts files and print resulting patterns.
353 </para>
354 <indexterm zone="fontconfig fc-query">
355 <primary sortas="b-fc-query">fc-query</primary>
356 </indexterm>
357 </listitem>
358 </varlistentry>
359
360 <varlistentry id="fc-scan">
361 <term><command>fc-scan</command></term>
362 <listitem>
363 <para>
364 is used to scan font files and directories, and print resulting
365 patterns.
366 </para>
367 <indexterm zone="fontconfig fc-scan">
368 <primary sortas="b-fc-scan">fc-scan</primary>
369 </indexterm>
370 </listitem>
371 </varlistentry>
372
373 <varlistentry id="fc-validate">
374 <term><command>fc-validate</command></term>
375 <listitem>
376 <para>
377 is used to validate font files.
378 </para>
379 <indexterm zone="fontconfig fc-validate">
380 <primary sortas="b-fc-validate">fc-validate</primary>
381 </indexterm>
382 </listitem>
383 </varlistentry>
384
385 <varlistentry id="libfontconfig">
386 <term><filename class="libraryfile">libfontconfig.so</filename></term>
387 <listitem>
388 <para>
389 contains functions used by the <application>Fontconfig</application>
390 programs and also by other programs to configure or customize font
391 access.
392 </para>
393 <indexterm zone="fontconfig libfontconfig">
394 <primary sortas="c-libfontconfig">libfontconfig.so</primary>
395 </indexterm>
396 </listitem>
397 </varlistentry>
398
399 </variablelist>
400
401 </sect2>
402
403</sect1>
Note: See TracBrowser for help on using the repository browser.