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

NAME

6       fc-cache - build font information cache files
7

SYNOPSIS

9       fc-cache  [  -fsvV?  ]  [  --force  ] [ --system-only ] [ --verbose ] [
10       --version ] [ --help ] [ dirs ]
11
12

DESCRIPTION

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

OPTIONS

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

FILES

54       fonts.cache-2
55              These files are generated by fc-cache and contain maps from file
56              names to font  properties.  They  are  read  by  the  fontconfig
57              library at application startup to locate appropriate fonts.
58

SEE ALSO

60       fc-list (1).
61
62       The  fontconfig  user's  guide, in HTML format: /usr/share/doc/fontcon‐
63       fig/fontconfig-user.html.
64

AUTHOR

66       This manual page was written by Keith Packard  <keithp@keithp.com>  and
67       Josselin Mouette <joss@debian.org>.
68
69
70
71                                  11 May 2007                      FC-CACHE(1)