source: general/graphlib/fontconfig.xml@ 43cca44

10.0 10.1 11.0 8.0 8.1 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind ken/refactor-virt lazarus perl-modules qt5new trunk xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since 43cca44 was 43cca44, checked in by Bruce Dubbs <bdubbs@…>, 5 years ago

Update to phonon-4.9.1.
Update to kf5-5.31.

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

  • Property mode set to 100644
File size: 12.6 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 &lfs7a_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 -i -e 's/CHAR_WIDTH/CHARWIDTH/' src/fcobjs.h fontconfig/fontconfig.h &amp;&amp;
113
114./configure --prefix=/usr \
115 --sysconfdir=/etc \
116 --localstatedir=/var \
117 --disable-docs \
118 --docdir=/usr/share/doc/fontconfig-&fontconfig-version; &amp;&amp;
119make</userinput></screen>
120
121 <para>
122 To test the results, issue: <command>make check</command>.
123 </para>
124
125 <para>
126 Now, as the <systemitem class="username">root</systemitem> user:
127 </para>
128
129<screen role="root"><userinput>make install</userinput></screen>
130
131 <para>
132 If you did not remove the <parameter>--disable-docs</parameter>
133 parameter from the <command>configure</command> command, you can install
134 the pre-generated documentation by using the following commands as the
135 <systemitem class="username">root</systemitem> user:
136 </para>
137
138<screen role="root"><userinput>install -v -dm755 \
139 /usr/share/{man/man{3,5},doc/fontconfig-&fontconfig-version;/fontconfig-devel} &amp;&amp;
140install -v -m644 fc-*/*.1 /usr/share/man/man1 &amp;&amp;
141install -v -m644 doc/*.3 /usr/share/man/man3 &amp;&amp;
142install -v -m644 doc/fonts-conf.5 /usr/share/man/man5 &amp;&amp;
143install -v -m644 doc/fontconfig-devel/* \
144 /usr/share/doc/fontconfig-&fontconfig-version;/fontconfig-devel &amp;&amp;
145install -v -m644 doc/*.{pdf,sgml,txt,html} \
146 /usr/share/doc/fontconfig-&fontconfig-version;</userinput></screen>
147
148 </sect2>
149
150 <sect2 role="commands">
151 <title>Command Explanations</title>
152
153 <para>
154 <command>sed ...</command>: Fix a conflict in names caused by
155 changes to a glibc-2.25 header file.
156 </para>
157
158 <para>
159 <parameter>--disable-docs</parameter>: This switch avoids building the
160 documentation (the release tarball includes pre-generated
161 documentation).
162 </para>
163
164 </sect2>
165
166 <sect2 role="configuration">
167 <title>Configuring Fontconfig</title>
168
169 <sect3 id="fontconfig-config">
170 <title>Config Files</title>
171
172 <para>
173 <filename>
174 /etc/fonts/*,
175 /etc/fonts/conf.d/* and
176 /usr/share/fontconfig/conf.avail/*
177 </filename>
178 </para>
179
180 <indexterm zone="fontconfig fontconfig-config">
181 <primary sortas="e-etc-fonts">/etc/fonts/*</primary>
182 </indexterm>
183
184 <indexterm zone="fontconfig fontconfig-config">
185 <primary sortas="e-etc-fonts-conf.d">/etc/fonts/conf.d/*</primary>
186 </indexterm>
187
188 <indexterm zone="fontconfig fontconfig-config">
189 <primary sortas="e-usr-share-fontconfig-conf.avail">/usr/share/fontconfig/conf.avail/*</primary>
190 </indexterm>
191
192 </sect3>
193
194 <sect3>
195 <title>Configuration Information</title>
196
197 <para>
198 The main configuration file for <application>Fontconfig</application> is
199 <filename>/etc/fonts/fonts.conf</filename>. Generally you do not want
200 to edit this file. It will also read <filename>/etc/fonts/local.conf</filename>
201 and any files in <filename class="directory">/etc/fonts/conf.d</filename>.
202 To put a new font directory in the configuration, create
203 (or update) the <filename>/etc/fonts/local.conf</filename> file with your
204 local information or add a new file in
205 <filename class="directory">/etc/fonts/conf.d</filename>. The default
206 location of fonts in <application>Fontconfig</application> is:
207 </para>
208
209 <itemizedlist spacing="compact">
210 <listitem>
211 <para>/usr/share/fonts</para>
212 </listitem>
213 <listitem>
214 <para>~/.local/share/fonts</para>
215 </listitem>
216 <listitem>
217 <para>~/.fonts <emphasis>(this is now deprecated, but for the moment
218 it still works)</emphasis></para>
219 </listitem>
220 </itemizedlist>
221
222 <para>
223 <application>Fontconfig</application> also ships many example
224 configuration files in the
225 <filename class="directory">/usr/share/fontconfig/conf.avail</filename>
226 directory. Symlinking specific files to
227 <filename class="directory">/etc/fonts/conf.d</filename>
228 will enable them. The default setup is generally good enough for
229 most users. See <filename>/etc/fonts/conf.d/README</filename>
230 for a description of the configuration files.
231 </para>
232
233 <indexterm zone="fontconfig fontconfig-config">
234 <primary sortas="e-usr-share-fonts">/usr/share/fonts</primary>
235 </indexterm>
236
237 <indexterm zone="fontconfig fontconfig-config">
238 <primary sortas="e-AA.fonts">~/.fonts</primary>
239 </indexterm>
240
241 <para>
242 More information about configuring <application>Fontconfig</application>
243 can be found in the user's manual in <ulink
244 url="file:///usr/share/doc/fontconfig-&fontconfig-version;/fontconfig-user.html"/>
245 </para>
246
247 </sect3>
248
249 </sect2>
250
251 <sect2 role="content">
252 <title>Contents</title>
253
254 <segmentedlist>
255 <segtitle>Installed Programs</segtitle>
256 <segtitle>Installed Library</segtitle>
257 <segtitle>Installed Directories</segtitle>
258
259 <seglistitem>
260 <seg>
261 fc-cache, fc-cat, fc-list, fc-match, fc-pattern, fc-query,
262 fc-scan and fc-validate
263 </seg>
264 <seg>
265 libfontconfig.so
266 </seg>
267 <seg>
268 /etc/fonts,
269 /usr/include/fontconfig,
270 /usr/share/doc/fontconfig-&fontconfig-version;,
271 /usr/share/fontconfig,
272 /usr/share/xml/fontconfig and
273 /var/cache/fontconfig
274 </seg>
275 </seglistitem>
276 </segmentedlist>
277
278 <variablelist>
279 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
280 <?dbfo list-presentation="list"?>
281 <?dbhtml list-presentation="table"?>
282
283 <varlistentry id="fc-cache">
284 <term><command>fc-cache</command></term>
285 <listitem>
286 <para>
287 is used to create font information caches.
288 </para>
289 <indexterm zone="fontconfig fc-cache">
290 <primary sortas="b-fc-cache">fc-cache</primary>
291 </indexterm>
292 </listitem>
293 </varlistentry>
294
295 <varlistentry id="fc-cat">
296 <term><command>fc-cat</command></term>
297 <listitem>
298 <para>
299 is used to read font information caches.
300 </para>
301 <indexterm zone="fontconfig fc-cat">
302 <primary sortas="b-fc-cat">fc-cat</primary>
303 </indexterm>
304 </listitem>
305 </varlistentry>
306
307 <varlistentry id="fc-list">
308 <term><command>fc-list</command></term>
309 <listitem>
310 <para>
311 is used to create font lists.
312 </para>
313 <indexterm zone="fontconfig fc-list">
314 <primary sortas="b-fc-list">fc-list</primary>
315 </indexterm>
316 </listitem>
317 </varlistentry>
318
319 <varlistentry id="fc-match">
320 <term><command>fc-match</command></term>
321 <listitem>
322 <para>
323 is used to match available fonts, or find fonts that match
324 a given pattern.
325 </para>
326 <indexterm zone="fontconfig fc-match">
327 <primary sortas="b-fc-match">fc-match</primary>
328 </indexterm>
329 </listitem>
330 </varlistentry>
331
332 <varlistentry id="fc-pattern">
333 <term><command>fc-pattern</command></term>
334 <listitem>
335 <para>
336 is used to parse pattern (empty pattern by default) and show
337 the parsed result.
338 </para>
339 <indexterm zone="fontconfig fc-pattern">
340 <primary sortas="b-fc-pattern">fc-pattern</primary>
341 </indexterm>
342 </listitem>
343 </varlistentry>
344
345 <varlistentry id="fc-query">
346 <term><command>fc-query</command></term>
347 <listitem>
348 <para>
349 is used to query fonts files and print resulting patterns.
350 </para>
351 <indexterm zone="fontconfig fc-query">
352 <primary sortas="b-fc-query">fc-query</primary>
353 </indexterm>
354 </listitem>
355 </varlistentry>
356
357 <varlistentry id="fc-scan">
358 <term><command>fc-scan</command></term>
359 <listitem>
360 <para>
361 is used to scan font files and directories, and print resulting
362 patterns.
363 </para>
364 <indexterm zone="fontconfig fc-scan">
365 <primary sortas="b-fc-scan">fc-scan</primary>
366 </indexterm>
367 </listitem>
368 </varlistentry>
369
370 <varlistentry id="fc-validate">
371 <term><command>fc-validate</command></term>
372 <listitem>
373 <para>
374 is used to validate font files.
375 </para>
376 <indexterm zone="fontconfig fc-validate">
377 <primary sortas="b-fc-validate">fc-validate</primary>
378 </indexterm>
379 </listitem>
380 </varlistentry>
381
382 <varlistentry id="libfontconfig">
383 <term><filename class="libraryfile">libfontconfig.so</filename></term>
384 <listitem>
385 <para>
386 contains functions used by the <application>Fontconfig</application>
387 programs and also by other programs to configure or customize font
388 access.
389 </para>
390 <indexterm zone="fontconfig libfontconfig">
391 <primary sortas="c-libfontconfig">libfontconfig.so</primary>
392 </indexterm>
393 </listitem>
394 </varlistentry>
395
396 </variablelist>
397
398 </sect2>
399
400</sect1>
Note: See TracBrowser for help on using the repository browser.