huschi.net

FC-CACHE(1)                                                        FC-CACHE(1)

NAME
       fc-cache - build font information cache files
SYNOPSIS
       fc-cache  [  -EfrsvVh  ]   [  --error-on-no-fonts  ]   [  --force  ]  [
       --really-force ]  [  [ -y dir ]  [ --sysroot dir ]  ]  [  --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 proper-
       ties 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.
       -E     Raise an error if there are no fonts in dir  or  directories  in
              the configuration if not given.
       -f     Force  re-generation of apparently up-to-date cache files, over-
              riding 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.
       -y     Prepend dir to all paths for scanning.
       -h     Show summary of options.
       -V     Show version of the program and exit.
       dir    Directory to scan for fonts.
RETURN CODES
       fc-cache  returns  zero if the caches successfully generated. otherwise
       non-zero.
FILES
       %cachedir%/*-%arch%.cache-%version%
              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/fontcon-
       fig/fontconfig-user.html.
AUTHOR
       This  manual  page was written by Keith Packard <keithp AT keithp.com> and
       Josselin Mouette <joss AT debian.org>.

                                 Aug 13, 2008                      FC-CACHE(1)