1FC-CACHE(1)                                                        FC-CACHE(1)
2
3
4

NAME

6       fc-cache - build font information cache files
7

SYNOPSIS

9       fc-cache  [  -fsvVh ]  [ --force ]  [ --system-only ]  [ --verbose ]  [
10       --version ]  [ --help ]  [ dir... ]
11

DESCRIPTION

13       fc-cache scans the font directories  on  the  system  and  builds  font
14       information  cache  files  for  applications using fontconfig for their
15       font handling.
16
17       If directory arguments are not given, fc-cache uses each  directory  in
18       the  current  font  configuration.  Each  directory is scanned for font
19       files readable by FreeType. A cache is created which  contains  proper‐
20       ties  of  each font and the associated filename.  This cache is used to
21       speed up application startup when using the fontconfig library.
22
23       Note that fc-cache must be executed once per architecture  to  generate
24       font information customized for that architecture.
25

OPTIONS

27       This  program  follows  the  usual  GNU  command line syntax, with long
28       options starting with  two  dashes  (`-').  A  summary  of  options  is
29       included below.
30
31       -f     Force  re-generation of apparently up-to-date cache files, over‐
32              riding the timestamp checking.
33
34       -s     Only scan system-wide directories, omitting the  places  located
35              in the user's home directory.
36
37       -v     Display status information while busy.
38
39       -h     Show summary of options.
40
41       -V     Show version of the program and exit.
42
43       dir    Directory to scan for fonts.
44

FILES

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

SEE ALSO

52       fc-cat(1) fc-list(1) fc-match(1) fc-query(1) fc-scan(1)
53
54       The  fontconfig  user's  guide, in HTML format: /usr/share/doc/fontcon‐
55       fig/fontconfig-user.html.
56

AUTHOR

58       This manual page was written by Keith Packard  <keithp@keithp.com>  and
59       Josselin Mouette <joss@debian.org>.
60
61
62
63                                 Aug 13, 2008                      FC-CACHE(1)