source: general/graphlib/fontconfig.xml@ 1f6d0c13

10.0 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 1f6d0c13 was 1f6d0c13, checked in by Bruce Dubbs <bdubbs@…>, 18 months ago

Xorg tags and a few others

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

  • Property mode set to 100644
File size: 13.3 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 "https://www.freedesktop.org/software/fontconfig/release/fontconfig-&fontconfig-version;.tar.bz2">
9 <!ENTITY fontconfig-download-ftp " ">
10 <!ENTITY fontconfig-md5sum "36cdea1058ef13cbbfdabe6cb019dc1c">
11 <!ENTITY fontconfig-size "1.6 MB">
12 <!ENTITY fontconfig-buildsize "16 MB (with tests)">
13 <!ENTITY fontconfig-time "0.3 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 &lfs10_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">Additional Downloads</bridgehead>
76 <itemizedlist spacing="compact">
77 <listitem>
78 <para>
79 Required patch:
80 <ulink url="&patch-root;/fontconfig-&fontconfig-version;-gperf-3.1-1.patch"/>
81 </para>
82 </listitem>
83 </itemizedlist>
84-->
85 <bridgehead renderas="sect3">Fontconfig Dependencies</bridgehead>
86
87 <bridgehead renderas="sect4">Required</bridgehead>
88 <para role="required">
89 <xref linkend="freetype2"/>
90 </para>
91
92 <bridgehead renderas="sect4">Optional</bridgehead>
93 <para role="optional">
94 <xref linkend="docbook-utils"/> and
95 <xref linkend="libxml2"/>,
96 <xref linkend="texlive"/> (or <xref linkend="tl-installer"/>)
97 </para>
98
99 <note>
100 <para>
101 If you have <application>DocBook Utils</application> installed and
102 you remove the <parameter>--disable-docs</parameter> parameter from
103 the <command>configure</command> command below, you must have
104 <xref linkend="perl-sgmlspm"/> and <xref linkend="texlive"/> installed
105 also, or the <application>Fontconfig</application> build will fail.
106 </para>
107 </note>
108
109 <para condition="html" role="usernotes">User Notes:
110 <ulink url='&blfs-wiki;/Fontconfig'/>
111 </para>
112 </sect2>
113
114 <sect2 role="installation">
115 <title>Installation of Fontconfig</title>
116
117 <para>
118 Make sure the system regenerates src/fcobjshash.h.
119 </para>
120
121<screen><userinput>rm -f src/fcobjshash.h</userinput></screen>
122
123 <para>
124 Install <application>Fontconfig</application> by running the following
125 commands:
126 </para>
127
128<screen><userinput>./configure --prefix=/usr \
129 --sysconfdir=/etc \
130 --localstatedir=/var \
131 --disable-docs \
132 --docdir=/usr/share/doc/fontconfig-&fontconfig-version; &amp;&amp;
133make</userinput></screen>
134
135 <para>
136 To test the results, issue: <command>make check</command>.
137 </para>
138
139 <para>
140 Now, as the <systemitem class="username">root</systemitem> user:
141 </para>
142
143<screen role="root"><userinput>make install</userinput></screen>
144
145 <para>
146 If you did not remove the <parameter>--disable-docs</parameter>
147 parameter from the <command>configure</command> command, you can install
148 the pre-generated documentation by using the following commands as the
149 <systemitem class="username">root</systemitem> user:
150 </para>
151
152<screen role="root"><userinput>install -v -dm755 \
153 /usr/share/{man/man{1,3,5},doc/fontconfig-&fontconfig-version;/fontconfig-devel} &amp;&amp;
154install -v -m644 fc-*/*.1 /usr/share/man/man1 &amp;&amp;
155install -v -m644 doc/*.3 /usr/share/man/man3 &amp;&amp;
156install -v -m644 doc/fonts-conf.5 /usr/share/man/man5 &amp;&amp;
157install -v -m644 doc/fontconfig-devel/* \
158 /usr/share/doc/fontconfig-&fontconfig-version;/fontconfig-devel &amp;&amp;
159install -v -m644 doc/*.{pdf,sgml,txt,html} \
160 /usr/share/doc/fontconfig-&fontconfig-version;</userinput></screen>
161
162 </sect2>
163
164 <sect2 role="commands">
165 <title>Command Explanations</title>
166
167 <para>
168 <parameter>--disable-docs</parameter>: This switch avoids building the
169 documentation (the release tarball includes pre-generated
170 documentation).
171 </para>
172
173 </sect2>
174
175 <sect2 role="configuration">
176 <title>Configuring Fontconfig</title>
177
178 <sect3 id="fontconfig-config">
179 <title>Config Files</title>
180
181 <para>
182 <filename>
183 /etc/fonts/*,
184 /etc/fonts/conf.d/* and
185 /usr/share/fontconfig/conf.avail/*
186 </filename>
187 </para>
188
189 <indexterm zone="fontconfig fontconfig-config">
190 <primary sortas="e-etc-fonts">/etc/fonts/*</primary>
191 </indexterm>
192
193 <indexterm zone="fontconfig fontconfig-config">
194 <primary sortas="e-etc-fonts-conf.d">/etc/fonts/conf.d/*</primary>
195 </indexterm>
196
197 <indexterm zone="fontconfig fontconfig-config">
198 <primary sortas="e-usr-share-fontconfig-conf.avail">/usr/share/fontconfig/conf.avail/*</primary>
199 </indexterm>
200
201 </sect3>
202
203 <sect3>
204 <title>Configuration Information</title>
205
206 <para>
207 The main configuration file for <application>Fontconfig</application> is
208 <filename>/etc/fonts/fonts.conf</filename>. Generally you do not want
209 to edit this file. It will also read <filename>/etc/fonts/local.conf</filename>
210 and any files in <filename class="directory">/etc/fonts/conf.d</filename>.
211 To put a new font directory in the configuration, create
212 (or update) the <filename>/etc/fonts/local.conf</filename> file with your
213 local information or add a new file in
214 <filename class="directory">/etc/fonts/conf.d</filename>. The default
215 location of fonts in <application>Fontconfig</application> is:
216 </para>
217
218 <itemizedlist spacing="compact">
219 <listitem>
220 <para>
221 /usr/share/fonts
222 </para>
223 </listitem>
224 <listitem>
225 <para>
226 ~/.local/share/fonts
227 </para>
228 </listitem>
229 <listitem>
230 <para>
231 ~/.fonts <emphasis>(this is now deprecated, but for the moment
232 it still works)</emphasis>
233 </para>
234 </listitem>
235 </itemizedlist>
236
237 <para>
238 <application>Fontconfig</application> also ships many example
239 configuration files in the
240 <filename class="directory">/usr/share/fontconfig/conf.avail</filename>
241 directory. Symlinking specific files to
242 <filename class="directory">/etc/fonts/conf.d</filename>
243 will enable them. The default setup is generally good enough for
244 most users. See <filename>/etc/fonts/conf.d/README</filename>
245 for a description of the configuration files.
246 </para>
247
248 <indexterm zone="fontconfig fontconfig-config">
249 <primary sortas="e-usr-share-fonts">/usr/share/fonts</primary>
250 </indexterm>
251
252 <indexterm zone="fontconfig fontconfig-config">
253 <primary sortas="e-AA.fonts">~/.fonts</primary>
254 </indexterm>
255
256 <para>
257 More information about configuring <application>Fontconfig</application>
258 can be found in the user's manual in <ulink
259 url="file:///usr/share/doc/fontconfig-&fontconfig-version;/fontconfig-user.html"/>.
260 </para>
261
262 </sect3>
263
264 </sect2>
265
266 <sect2 role="content">
267 <title>Contents</title>
268
269 <segmentedlist>
270 <segtitle>Installed Programs</segtitle>
271 <segtitle>Installed Library</segtitle>
272 <segtitle>Installed Directories</segtitle>
273
274 <seglistitem>
275 <seg>
276 fc-cache, fc-cat, fc-conflist, fc-list, fc-match, fc-pattern,
277 fc-query, fc-scan, and fc-validate
278 </seg>
279 <seg>
280 libfontconfig.so
281 </seg>
282 <seg>
283 /etc/fonts,
284 /usr/include/fontconfig,
285 /usr/share/doc/fontconfig-&fontconfig-version;,
286 /usr/share/fontconfig,
287 /usr/share/xml/fontconfig, and
288 /var/cache/fontconfig
289 </seg>
290 </seglistitem>
291 </segmentedlist>
292
293 <variablelist>
294 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
295 <?dbfo list-presentation="list"?>
296 <?dbhtml list-presentation="table"?>
297
298 <varlistentry id="fc-cache">
299 <term><command>fc-cache</command></term>
300 <listitem>
301 <para>
302 is used to create font information caches.
303 </para>
304 <indexterm zone="fontconfig fc-cache">
305 <primary sortas="b-fc-cache">fc-cache</primary>
306 </indexterm>
307 </listitem>
308 </varlistentry>
309
310 <varlistentry id="fc-cat">
311 <term><command>fc-cat</command></term>
312 <listitem>
313 <para>
314 is used to read font information caches.
315 </para>
316 <indexterm zone="fontconfig fc-cat">
317 <primary sortas="b-fc-cat">fc-cat</primary>
318 </indexterm>
319 </listitem>
320 </varlistentry>
321
322 <varlistentry id="fc-conflist">
323 <term><command>fc-conflist</command></term>
324 <listitem>
325 <para>
326 shows the ruleset files' information on the system.
327 </para>
328 <indexterm zone="fontconfig fc-conflist">
329 <primary sortas="b-fc-conflist">fc-conflist</primary>
330 </indexterm>
331 </listitem>
332 </varlistentry>
333
334 <varlistentry id="fc-list">
335 <term><command>fc-list</command></term>
336 <listitem>
337 <para>
338 is used to create font lists.
339 </para>
340 <indexterm zone="fontconfig fc-list">
341 <primary sortas="b-fc-list">fc-list</primary>
342 </indexterm>
343 </listitem>
344 </varlistentry>
345
346 <varlistentry id="fc-match">
347 <term><command>fc-match</command></term>
348 <listitem>
349 <para>
350 is used to match available fonts, or find fonts that match
351 a given pattern.
352 </para>
353 <indexterm zone="fontconfig fc-match">
354 <primary sortas="b-fc-match">fc-match</primary>
355 </indexterm>
356 </listitem>
357 </varlistentry>
358
359 <varlistentry id="fc-pattern">
360 <term><command>fc-pattern</command></term>
361 <listitem>
362 <para>
363 is used to parse pattern (empty pattern by default) and show
364 the parsed result.
365 </para>
366 <indexterm zone="fontconfig fc-pattern">
367 <primary sortas="b-fc-pattern">fc-pattern</primary>
368 </indexterm>
369 </listitem>
370 </varlistentry>
371
372 <varlistentry id="fc-query">
373 <term><command>fc-query</command></term>
374 <listitem>
375 <para>
376 is used to query fonts files and print resulting patterns.
377 </para>
378 <indexterm zone="fontconfig fc-query">
379 <primary sortas="b-fc-query">fc-query</primary>
380 </indexterm>
381 </listitem>
382 </varlistentry>
383
384 <varlistentry id="fc-scan">
385 <term><command>fc-scan</command></term>
386 <listitem>
387 <para>
388 is used to scan font files and directories, and print resulting
389 patterns.
390 </para>
391 <indexterm zone="fontconfig fc-scan">
392 <primary sortas="b-fc-scan">fc-scan</primary>
393 </indexterm>
394 </listitem>
395 </varlistentry>
396
397 <varlistentry id="fc-validate">
398 <term><command>fc-validate</command></term>
399 <listitem>
400 <para>
401 is used to validate font files.
402 </para>
403 <indexterm zone="fontconfig fc-validate">
404 <primary sortas="b-fc-validate">fc-validate</primary>
405 </indexterm>
406 </listitem>
407 </varlistentry>
408
409 <varlistentry id="libfontconfig">
410 <term><filename class="libraryfile">libfontconfig.so</filename></term>
411 <listitem>
412 <para>
413 contains functions used by the <application>Fontconfig</application>
414 programs and also by other programs to configure or customize font
415 access.
416 </para>
417 <indexterm zone="fontconfig libfontconfig">
418 <primary sortas="c-libfontconfig">libfontconfig.so</primary>
419 </indexterm>
420 </listitem>
421 </varlistentry>
422
423 </variablelist>
424
425 </sect2>
426
427</sect1>
Note: See TracBrowser for help on using the repository browser.