|
Packit |
352660 |
.\" auto-generated by docbook2man-spec from docbook-utils package
|
|
Packit |
352660 |
.TH "FC-CACHE" "1" "Aug 13, 2008" "" ""
|
|
Packit |
352660 |
.SH NAME
|
|
Packit |
352660 |
fc-cache \- build font information cache files
|
|
Packit |
352660 |
.SH SYNOPSIS
|
|
Packit |
352660 |
.sp
|
|
Packit |
352660 |
\fBfc-cache\fR [ \fB-EfrsvVh\fR ] [ \fB--error-on-no-fonts\fR ] [ \fB--force\fR ] [ \fB--really-force\fR ] [ \fB [ -y \fIdir\fB ] [ --sysroot \fIdir\fB ] \fR ] [ \fB--system-only\fR ] [ \fB--verbose\fR ] [ \fB--version\fR ] [ \fB--help\fR ] [ \fB\fIdir\fB\fR\fI...\fR ]
|
|
Packit |
352660 |
.SH "DESCRIPTION"
|
|
Packit |
352660 |
.PP
|
|
Packit |
352660 |
\fBfc-cache\fR scans the font directories on
|
|
Packit |
352660 |
the system and builds font information cache files for
|
|
Packit |
352660 |
applications using fontconfig for their font handling.
|
|
Packit |
352660 |
.PP
|
|
Packit |
352660 |
If directory arguments are not given,
|
|
Packit |
352660 |
\fBfc-cache\fR uses each directory in the
|
|
Packit |
352660 |
current font configuration. Each directory is scanned for
|
|
Packit |
352660 |
font files readable by FreeType. A cache is created which
|
|
Packit |
352660 |
contains properties of each font and the associated filename.
|
|
Packit |
352660 |
This cache is used to speed up application startup when using
|
|
Packit |
352660 |
the fontconfig library.
|
|
Packit |
352660 |
.PP
|
|
Packit |
352660 |
Note that \fBfc-cache\fR must be executed
|
|
Packit |
352660 |
once per architecture to generate font information customized
|
|
Packit |
352660 |
for that architecture.
|
|
Packit |
352660 |
.SH "OPTIONS"
|
|
Packit |
352660 |
.PP
|
|
Packit |
352660 |
This program follows the usual GNU command line syntax,
|
|
Packit |
352660 |
with long options starting with two dashes (`-'). A summary of
|
|
Packit |
352660 |
options is included below.
|
|
Packit |
352660 |
.TP
|
|
Packit |
352660 |
\fB-E\fR
|
|
Packit |
352660 |
Raise an error if there are no fonts in
|
|
Packit |
352660 |
\fB\fIdir\fB\fR or directories
|
|
Packit |
352660 |
in the configuration if not given.
|
|
Packit |
352660 |
.TP
|
|
Packit |
352660 |
\fB-f\fR
|
|
Packit |
352660 |
Force re-generation of apparently up-to-date cache files,
|
|
Packit |
352660 |
overriding the timestamp checking.
|
|
Packit |
352660 |
.TP
|
|
Packit |
352660 |
\fB-r\fR
|
|
Packit |
352660 |
Erase all existing cache files and rescan.
|
|
Packit |
352660 |
.TP
|
|
Packit |
352660 |
\fB-s\fR
|
|
Packit |
352660 |
Only scan system-wide directories, omitting the places
|
|
Packit |
352660 |
located in the user's home directory.
|
|
Packit |
352660 |
.TP
|
|
Packit |
352660 |
\fB-v\fR
|
|
Packit |
352660 |
Display status information while busy.
|
|
Packit |
352660 |
.TP
|
|
Packit |
352660 |
\fB-y\fR
|
|
Packit |
352660 |
Prepend \fB\fIdir\fB\fR to all paths for scanning.
|
|
Packit |
352660 |
.TP
|
|
Packit |
352660 |
\fB-h\fR
|
|
Packit |
352660 |
Show summary of options.
|
|
Packit |
352660 |
.TP
|
|
Packit |
352660 |
\fB-V\fR
|
|
Packit |
352660 |
Show version of the program and exit.
|
|
Packit |
352660 |
.TP
|
|
Packit |
352660 |
\fB\fIdir\fB\fR
|
|
Packit |
352660 |
Directory to scan for fonts.
|
|
Packit |
352660 |
.SH "RETURN CODES"
|
|
Packit |
352660 |
.PP
|
|
Packit |
352660 |
\fBfc-cache\fR returns zero if the caches successfully generated. otherwise non-zero.
|
|
Packit |
352660 |
.SH "FILES"
|
|
Packit |
352660 |
.TP
|
|
Packit |
352660 |
\fB\fI%cachedir%/*-%arch%\&.cache-%version%\fB\fR
|
|
Packit |
352660 |
These files are generated by \fBfc-cache\fR
|
|
Packit |
352660 |
and contain maps from file names to font properties. They are
|
|
Packit |
352660 |
read by the fontconfig library at application startup to locate
|
|
Packit |
352660 |
appropriate fonts.
|
|
Packit |
352660 |
.SH "SEE ALSO"
|
|
Packit |
352660 |
.PP
|
|
Packit |
352660 |
\fBfc-cat\fR(1)
|
|
Packit |
352660 |
\fBfc-list\fR(1)
|
|
Packit |
352660 |
\fBfc-match\fR(1)
|
|
Packit |
352660 |
\fBfc-pattern\fR(1)
|
|
Packit |
352660 |
\fBfc-query\fR(1)
|
|
Packit |
352660 |
\fBfc-scan\fR(1)
|
|
Packit |
352660 |
.PP
|
|
Packit |
352660 |
The fontconfig user's guide, in HTML format:
|
|
Packit |
352660 |
\fI/usr/share/doc/fontconfig/fontconfig-user.html\fR\&.
|
|
Packit |
352660 |
.SH "AUTHOR"
|
|
Packit |
352660 |
.PP
|
|
Packit |
352660 |
This manual page was written by Keith Packard
|
|
Packit |
352660 |
<keithp@keithp.com> and Josselin Mouette <joss@debian.org>\&.
|