Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
FC-CACHE(1)							   FC-CACHE(1)

NAME
       fc-cache	- build	font information cache files

SYNOPSIS
       fc-cache	 [  -EfrsvVh  ]	 [ --error-on-no-fonts ]  [ --force ]  [ --re-
       ally-force ]  [	[ -y dir ]  [ --sysroot	dir ]  ]  [ --system-only ]  [
       --verbose ]  [ --version	]  [ --help ]  [ dir...	]

DESCRIPTION
       fc-cache	 scans	the font directories on	the system and builds font in-
       formation 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  op-
       tions  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 li-
	      brary 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@keithp.com> and
       Josselin	Mouette	<joss@debian.org>.

				 Aug 13, 2008			   FC-CACHE(1)

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | RETURN CODES | FILES | SEE ALSO | AUTHOR

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=fc-cache&manpath=FreeBSD+12.1-RELEASE+and+Ports>

home | help