source: general/graphlib/fontconfig.xml@ 5811f7e

10.0 10.1 11.0 11.1 11.2 11.3 12.0 12.1 12.2 7.10 7.4 7.5 7.6 7.6-blfs 7.6-systemd 7.7 7.8 7.9 8.0 8.1 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind gimp3 gnome kde5-13430 kde5-14269 kde5-14686 kea ken/TL2024 ken/inkscape-core-mods ken/tuningfonts krejzi/svn lazarus lxqt nosym perl-modules plabs/newcss plabs/python-mods python3.11 qt5new rahul/power-profiles-daemon renodr/vulkan-addition systemd-11177 systemd-13485 trunk upgradedb xry111/for-12.3 xry111/intltool xry111/llvm18 xry111/soup3 xry111/spidermonkey128 xry111/test-20220226 xry111/xf86-video-removal
Last change on this file since 5811f7e was 5811f7e, checked in by Krejzi <krejzi@…>, 12 years ago

Mark some packages as 7.2 checked. Part 3 - Graphics Libraries.

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

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