...\" $Header: /cvs/OpenBSD/xenocara/lib/fontconfig/fc-cache/fc-cache.1,v 1.2 2007/10/27 20:00:20 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