2010-03-25 15:45:57 -06:00
|
|
|
|
.\\" auto-generated by docbook2man-spec $Revision: 1.4 $
|
|
|
|
|
.TH "FC-CACHE" "1" "Aug 13, 2008" "" ""
|
2009-04-05 10:43:35 -06:00
|
|
|
|
.SH NAME
|
|
|
|
|
fc-cache \- build font information cache files
|
|
|
|
|
.SH SYNOPSIS
|
2010-03-25 15:45:57 -06:00
|
|
|
|
.sp
|
|
|
|
|
\fBfc-cache\fR [ \fB-fsvVh\fR ] [ \fB--force\fR ] [ \fB--system-only\fR ] [ \fB--verbose\fR ] [ \fB--version\fR ] [ \fB--help\fR ] [ \fB\fIdir\fB\fR\fI...\fR ]
|
2009-04-05 10:43:35 -06:00
|
|
|
|
.SH "DESCRIPTION"
|
|
|
|
|
.PP
|
|
|
|
|
\fBfc-cache\fR scans the font directories on
|
|
|
|
|
the system and builds font information cache files for
|
|
|
|
|
applications using fontconfig for their font handling.
|
|
|
|
|
.PP
|
|
|
|
|
If directory arguments are not given,
|
|
|
|
|
\fBfc-cache\fR uses each directory in the
|
|
|
|
|
current font configuration. Each directory is scanned for
|
2010-03-25 15:45:57 -06:00
|
|
|
|
font files readable by FreeType. A cache is created which
|
2009-04-05 10:43:35 -06:00
|
|
|
|
contains properties of each font and the associated filename.
|
|
|
|
|
This cache is used to speed up application startup when using
|
|
|
|
|
the fontconfig library.
|
|
|
|
|
.PP
|
|
|
|
|
Note that \fBfc-cache\fR must be executed
|
|
|
|
|
once per architecture to generate font information customized
|
2010-03-25 15:45:57 -06:00
|
|
|
|
for that architecture.
|
2009-04-05 10:43:35 -06:00
|
|
|
|
.SH "OPTIONS"
|
|
|
|
|
.PP
|
|
|
|
|
This program follows the usual GNU command line syntax,
|
2010-03-25 15:45:57 -06:00
|
|
|
|
with long options starting with two dashes (`-'). A summary of
|
2009-04-05 10:43:35 -06:00
|
|
|
|
options is included below.
|
|
|
|
|
.TP
|
2010-03-25 15:45:57 -06:00
|
|
|
|
\fB-f\fR
|
2009-04-05 10:43:35 -06:00
|
|
|
|
Force re-generation of apparently up-to-date cache files,
|
|
|
|
|
overriding the timestamp checking.
|
|
|
|
|
.TP
|
2010-03-25 15:45:57 -06:00
|
|
|
|
\fB-s\fR
|
2009-04-05 10:43:35 -06:00
|
|
|
|
Only scan system-wide directories, omitting the places
|
|
|
|
|
located in the user's home directory.
|
|
|
|
|
.TP
|
2010-03-25 15:45:57 -06:00
|
|
|
|
\fB-v\fR
|
2009-04-05 10:43:35 -06:00
|
|
|
|
Display status information while busy.
|
|
|
|
|
.TP
|
2010-03-25 15:45:57 -06:00
|
|
|
|
\fB-h\fR
|
2009-04-05 10:43:35 -06:00
|
|
|
|
Show summary of options.
|
|
|
|
|
.TP
|
2010-03-25 15:45:57 -06:00
|
|
|
|
\fB-V\fR
|
2009-04-05 10:43:35 -06:00
|
|
|
|
Show version of the program and exit.
|
|
|
|
|
.TP
|
2010-03-25 15:45:57 -06:00
|
|
|
|
\fB\fIdir\fB\fR
|
|
|
|
|
Directory to scan for fonts.
|
2009-04-05 10:43:35 -06:00
|
|
|
|
.SH "FILES"
|
|
|
|
|
.TP
|
2010-03-25 15:45:57 -06:00
|
|
|
|
\fB\fI%cachdir%/*-%arch%\&.cache-2\fB\fR
|
2009-04-05 10:43:35 -06:00
|
|
|
|
These files are generated by \fBfc-cache\fR
|
|
|
|
|
and contain maps from file names to font properties. They are
|
|
|
|
|
read by the fontconfig library at application startup to locate
|
|
|
|
|
appropriate fonts.
|
|
|
|
|
.SH "SEE ALSO"
|
|
|
|
|
.PP
|
2010-03-25 15:45:57 -06:00
|
|
|
|
\fBfc-cat\fR(1)
|
|
|
|
|
\fBfc-list\fR(1)
|
|
|
|
|
\fBfc-match\fR(1)
|
|
|
|
|
\fBfc-query\fR(1)
|
|
|
|
|
\fBfc-scan\fR(1)
|
2009-04-05 10:43:35 -06:00
|
|
|
|
.PP
|
|
|
|
|
The fontconfig user's guide, in HTML format:
|
|
|
|
|
\fI/usr/share/doc/fontconfig/fontconfig-user.html\fR\&.
|
|
|
|
|
.SH "AUTHOR"
|
|
|
|
|
.PP
|
|
|
|
|
This manual page was written by Keith Packard
|
|
|
|
|
<keithp@keithp.com> and Josselin Mouette <joss@debian.org>\&.
|
2010-03-25 15:45:57 -06:00
|
|
|
|
...\" $Header: /home/cvs/xenocara/lib/fontconfig/fc-cache/Attic/fc-cache.1,v 1.4 2010/03/25 21:45:59 matthieu Exp $
|
2007-05-05 04:32:29 -06:00
|
|
|
|
...\"
|
|
|
|
|
...\" transcript compatibility for postscript use.
|
|
|
|
|
...\"
|
|
|
|
|
...\" synopsis: .P! <file.ps>
|
|
|
|
|
...\"
|
|
|
|
|
.de P!
|
|
|
|
|
\\&.
|
|
|
|
|
.fl \" force out current output buffer
|
|
|
|
|
\\!%PB
|
|
|
|
|
\\!/showpage{}def
|
|
|
|
|
...\" the following is from Ken Flowers -- it prevents dictionary overflows
|
|
|
|
|
\\!/tempdict 200 dict def tempdict begin
|
|
|
|
|
.fl \" prolog
|
|
|
|
|
.sy cat \\$1\" bring in postscript file
|
|
|
|
|
...\" the following line matches the tempdict above
|
|
|
|
|
\\!end % tempdict %
|
|
|
|
|
\\!PE
|
|
|
|
|
\\!.
|
|
|
|
|
.sp \\$2u \" move below the image
|
|
|
|
|
..
|
|
|
|
|
.de pF
|
|
|
|
|
.ie \\*(f1 .ds f1 \\n(.f
|
|
|
|
|
.el .ie \\*(f2 .ds f2 \\n(.f
|
|
|
|
|
.el .ie \\*(f3 .ds f3 \\n(.f
|
|
|
|
|
.el .ie \\*(f4 .ds f4 \\n(.f
|
|
|
|
|
.el .tm ? font overflow
|
|
|
|
|
.ft \\$1
|
|
|
|
|
..
|
|
|
|
|
.de fP
|
|
|
|
|
.ie !\\*(f4 \{\
|
|
|
|
|
. ft \\*(f4
|
|
|
|
|
. ds f4\"
|
|
|
|
|
' br \}
|
|
|
|
|
.el .ie !\\*(f3 \{\
|
|
|
|
|
. ft \\*(f3
|
|
|
|
|
. ds f3\"
|
|
|
|
|
' br \}
|
|
|
|
|
.el .ie !\\*(f2 \{\
|
|
|
|
|
. ft \\*(f2
|
|
|
|
|
. ds f2\"
|
|
|
|
|
' br \}
|
|
|
|
|
.el .ie !\\*(f1 \{\
|
|
|
|
|
. ft \\*(f1
|
|
|
|
|
. ds f1\"
|
|
|
|
|
' br \}
|
|
|
|
|
.el .tm ? font underflow
|
|
|
|
|
..
|
|
|
|
|
.ds f1\"
|
|
|
|
|
.ds f2\"
|
|
|
|
|
.ds f3\"
|
|
|
|
|
.ds f4\"
|
|
|
|
|
.ta 8n 16n 24n 32n 40n 48n 56n 64n 72n
|
|
|
|
|
.TH "fc-cache" "1"
|
|
|
|
|
.SH "NAME"
|
|
|
|
|
fc-cache \(em build font information cache files
|
|
|
|
|
.SH "SYNOPSIS"
|
|
|
|
|
.PP
|
2007-10-27 14:00:20 -06:00
|
|
|
|
\fBfc-cache\fR [\fB-cfsvV?\fP] [\fB\-\-chroot root\fP] [\fB\-\-force\fP] [\fB\-\-system-only\fP] [\fB\-\-verbose\fP] [\fB\-\-version\fP] [\fB\-\-help\fP] [\fB\fIdirs\fR\fP]
|
2007-05-05 04:32:29 -06:00
|
|
|
|
.SH "DESCRIPTION"
|
|
|
|
|
.PP
|
|
|
|
|
\fBfc-cache\fR scans the font directories on
|
|
|
|
|
the system and builds font information cache files for
|
|
|
|
|
applications using fontconfig for their font handling\&.
|
|
|
|
|
.PP
|
|
|
|
|
If directory arguments are not given,
|
|
|
|
|
\fBfc-cache\fR uses each directory in the
|
|
|
|
|
current font configuration\&. Each directory is scanned for
|
|
|
|
|
font files readable by FreeType\&. A cache is created which
|
|
|
|
|
contains properties of each font and the associated filename\&.
|
|
|
|
|
This cache is used to speed up application startup when using
|
|
|
|
|
the fontconfig library\&.
|
|
|
|
|
.PP
|
|
|
|
|
Note that \fBfc-cache\fR must be executed
|
|
|
|
|
once per architecture to generate font information customized
|
|
|
|
|
for that architecture\&. On a subsequent run,
|
|
|
|
|
\fBfc-cache\fR will augment the cache
|
|
|
|
|
information files with the information for the new
|
|
|
|
|
architecture\&.
|
|
|
|
|
.SH "OPTIONS"
|
|
|
|
|
.PP
|
|
|
|
|
This program follows the usual GNU command line syntax,
|
|
|
|
|
with long options starting with two dashes (`\-\&')\&. A summary of
|
|
|
|
|
options is included below\&.
|
2007-10-27 14:00:20 -06:00
|
|
|
|
.IP "\fB-c root\fP \fB\-\-chroot root\fP " 10
|
|
|
|
|
Change root directory into root
|
|
|
|
|
before starting\&.
|
2007-05-05 04:32:29 -06:00
|
|
|
|
.IP "\fB-f\fP \fB\-\-force\fP " 10
|
|
|
|
|
Force re-generation of apparently up-to-date cache files,
|
|
|
|
|
overriding the timestamp checking\&.
|
|
|
|
|
.IP "\fB-s\fP \fB\-\-system-only\fP " 10
|
|
|
|
|
Only scan system-wide directories, omitting the places
|
|
|
|
|
located in the user\&'s home directory\&.
|
|
|
|
|
.IP "\fB-v\fP \fB\-\-verbose\fP " 10
|
|
|
|
|
Display status information while busy\&.
|
|
|
|
|
.IP "\fB-?\fP \fB\-\-help\fP " 10
|
|
|
|
|
Show summary of options\&.
|
|
|
|
|
.IP "\fB-V\fP \fB\-\-version\fP " 10
|
|
|
|
|
Show version of the program and exit\&.
|
|
|
|
|
.IP "\fB\fIdirs\fR\fP " 10
|
|
|
|
|
A list of directories to scan for fonts\&.
|
|
|
|
|
.SH "FILES"
|
|
|
|
|
.IP "\fBfonts\&.cache-2\fP" 10
|
|
|
|
|
These files are generated by \fBfc-cache\fR and contain maps from file names to font properties\&. They are
|
|
|
|
|
read by the fontconfig library at application startup to locate
|
|
|
|
|
appropriate fonts\&.
|
|
|
|
|
.SH "SEE ALSO"
|
|
|
|
|
.PP
|
|
|
|
|
\fBfc-list\fR (1)\&.
|
|
|
|
|
.PP
|
|
|
|
|
The fontconfig user\&'s guide, in HTML format:
|
|
|
|
|
\fB/usr/share/doc/fontconfig/fontconfig-user\&.html\fP\&.
|
|
|
|
|
.SH "AUTHOR"
|
|
|
|
|
.PP
|
|
|
|
|
This manual page was written by Keith Packard
|
|
|
|
|
keithp@keithp\&.com and Josselin Mouette joss@debian\&.org\&.
|
2007-10-27 14:00:20 -06:00
|
|
|
|
...\" created by instant / docbook-to-man, Tue 16 Oct 2007, 23:05
|