"fc-cache"("1") manual page

Table of Contents

##

Name

fc-cache -- build font information cache files

## Synopsis

fc-cache [-fsvV?] [--force] [--system-only] [--verbose] [--version] [--help] [dirs]

## 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.

## 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
  Force re-generation of apparently up-to-date cache files, overriding the timestamp checking.
-s --system-only
  Only scan system-wide directories, omitting the places located in the user's home directory.
-v --verbose
  Display status information while busy.
-? --help
  Show summary of options.
-V --version
  Show version of the program and exit.
dirs
  A list of directories to scan for fonts.

## Files

fonts.cache-1
  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-list (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.