diff options
Diffstat (limited to 'x11-fonts/fontconfig/files/fc-cache.1')
| -rw-r--r-- | x11-fonts/fontconfig/files/fc-cache.1 | 75 |
1 files changed, 75 insertions, 0 deletions
diff --git a/x11-fonts/fontconfig/files/fc-cache.1 b/x11-fonts/fontconfig/files/fc-cache.1 new file mode 100644 index 000000000..18809ffb1 --- /dev/null +++ b/x11-fonts/fontconfig/files/fc-cache.1 @@ -0,0 +1,75 @@ +.\" This manpage has been automatically generated by docbook2man +.\" from a DocBook document. This tool can be found at: +.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> +.\" Please send any bug reports, improvements, comments, patches, +.\" etc. to Steve Cheng <steve@ggi-project.org>. +.TH "FC-CACHE" "1" "12 November 2006" "" "" + +.SH NAME +fc-cache \- build font information cache files +.SH SYNOPSIS + +\fBfc-cache\fR [ \fB-fsvV?\fR ] [ \fB--force\fR ] [ \fB--system-only\fR ] [ \fB--verbose\fR ] [ \fB--version\fR ] [ \fB--help\fR ] [ \fB\fIdirs\fB\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. 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. +.TP +\fB-f --force \fR +Force re-generation of apparently up-to-date cache files, +overriding the timestamp checking. +.TP +\fB-s --system-only \fR +Only scan system-wide directories, omitting the places +located in the user's home directory. +.TP +\fB-v --verbose \fR +Display status information while busy. +.TP +\fB-? --help \fR +Show summary of options. +.TP +\fB-V --version \fR +Show version of the program and exit. +.TP +\fB\fIdirs\fB \fR +A list of directories to scan for fonts. +.SH "FILES" +.TP +\fB\fIfonts.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-list\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>\&. |