NAME

       fc-cache - build font information cache files

SYNOPSIS

       fc-cache [ -frsvVh ]  [ --force ]  [ --really-force ]  [ --system-only ]  [ --verbose ]  [ --version ]  [
       --help ]  [ dir... ]

DESCRIPTION

       fc-cache scans the  font  directories  on  the  system  and  builds  font  information  cache  files  for
       applications using fontconfig for their font handling.

       If  directory  arguments  are  not given, fc-cache 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.

       Note that fc-cache must be executed once per architecture to generate  font  information  customized  for
       that architecture.

OPTIONS

       This program follows the usual GNU command line syntax, with long options starting with two dashes (`-').
       A summary of options is included below.

       -f     Force re-generation of apparently up-to-date cache files, overriding the timestamp checking.

       -r     Erase all existing cache files and rescan.

       -s     Only scan system-wide directories, omitting the places located in the user's home directory.

       -v     Display status information while busy.

       -h     Show summary of options.

       -V     Show version of the program and exit.

       dir    Directory to scan for fonts.

FILES

       %cachdir%/*-%arch%.cache-2
              These files are generated by fc-cache and contain maps from file names to  font  properties.  They
              are read by the fontconfig library at application startup to locate appropriate fonts.

SEE ALSO

       fc-cat(1) fc-list(1) fc-match(1) fc-pattern(1) fc-query(1) fc-scan(1)

       The fontconfig user's guide, in HTML format: /usr/share/doc/fontconfig/fontconfig-user.html.

AUTHOR

       This manual page was written by Keith Packard <keithp@keithp.com> and Josselin Mouette <joss@debian.org>.

                                                  Aug 13, 2008                                       FC-CACHE(1)