188 lines
5.7 KiB
Groff
188 lines
5.7 KiB
Groff
.\\" auto-generated by docbook2man-spec $Revision: 1.4 $
|
||
.TH "FC-CACHE" "1" "Aug 13, 2008" "" ""
|
||
.SH NAME
|
||
fc-cache \- build font information cache files
|
||
.SH SYNOPSIS
|
||
.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 ]
|
||
.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.
|
||
.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.
|
||
.TP
|
||
\fB-f\fR
|
||
Force re-generation of apparently up-to-date cache files,
|
||
overriding the timestamp checking.
|
||
.TP
|
||
\fB-s\fR
|
||
Only scan system-wide directories, omitting the places
|
||
located in the user's home directory.
|
||
.TP
|
||
\fB-v\fR
|
||
Display status information while busy.
|
||
.TP
|
||
\fB-h\fR
|
||
Show summary of options.
|
||
.TP
|
||
\fB-V\fR
|
||
Show version of the program and exit.
|
||
.TP
|
||
\fB\fIdir\fB\fR
|
||
Directory to scan for fonts.
|
||
.SH "FILES"
|
||
.TP
|
||
\fB\fI%cachdir%/*-%arch%\&.cache-2\fB\fR
|
||
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-cat\fR(1)
|
||
\fBfc-list\fR(1)
|
||
\fBfc-match\fR(1)
|
||
\fBfc-query\fR(1)
|
||
\fBfc-scan\fR(1)
|
||
.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>\&.
|
||
...\" $Header: /home/cvs/xenocara/lib/fontconfig/fc-cache/Attic/fc-cache.1,v 1.4 2010/03/25 21:45:59 matthieu Exp $
|
||
...\"
|
||
...\" 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
|
||
\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]
|
||
.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\&.
|
||
.IP "\fB-c root\fP \fB\-\-chroot root\fP " 10
|
||
Change root directory into root
|
||
before starting\&.
|
||
.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\&.
|
||
...\" created by instant / docbook-to-man, Tue 16 Oct 2007, 23:05
|