source: general/graphlib/fontconfig.xml@ 8dfc5c3

10.0 10.1 11.0 11.1 11.2 11.3 12.0 12.1 8.1 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind kea ken/TL2024 ken/inkscape-core-mods ken/tuningfonts lazarus lxqt perl-modules plabs/newcss plabs/python-mods python3.11 qt5new rahul/power-profiles-daemon renodr/vulkan-addition trunk upgradedb xry111/intltool xry111/llvm18 xry111/soup3 xry111/test-20220226 xry111/xf86-video-removal
Last change on this file since 8dfc5c3 was 8dfc5c3, checked in by Krejzi <krejzi@…>, 7 years ago

Fix some URLs

  • Switch to ​https:// scheme where possible to avoid redirects
  • Unify all kernel.org, Sourceforge and GNU URLs
  • Fix python and perl module URLs to be consistent
  • Fix github provided URLs to properly download tarballs instead of vFOO.tar.gz
  • Use upstream locations for some packages or better/shorter URLs if available
  • Add ​https:// URLs for gnupg packages

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