IABSD.fr/xenocara/lib/fontconfig/fc-cache/fc-cache.1

Branch : - branch - master - tag -

• Show log

  Commit

• Author : matthieu
  Date : 2007-10-27 20:00:20
  Hash : b66e17dd
  Message : Add a '-c' option to fc-cache to do a chroot before (re)building the font cache. Useful for builds with $DESTDIR set, to prepare a binary distribution.

• lib/fontconfig/fc-cache/fc-cache.1

• ...\" $Header: /home/cvs/xenocara/lib/fontconfig/fc-cache/Attic/fc-cache.1,v 1.2 2007/10/27 20:00:20 matthieu Exp $
  ...\"
  ...\"	transcript compatibility for postscript use.
  ...\"
  ...\"	synopsis:  .P! <file.ps>
  ...\"
  .de P!
  \\&.
  .fl			\" force out current output buffer
  \\!%PB
  \\!/showpage{}def
  ...\" the following is from Ken Flowers -- it prevents dictionary overflows
  \\!/tempdict 200 dict def tempdict begin
  .fl			\" prolog
  .sy cat \\$1\" bring in postscript file
  ...\" the following line matches the tempdict above
  \\!end % tempdict %
  \\!PE
  \\!.
  .sp \\$2u	\" move below the image
  ..
  .de pF
  .ie     \\*(f1 .ds f1 \\n(.f
  .el .ie \\*(f2 .ds f2 \\n(.f
  .el .ie \\*(f3 .ds f3 \\n(.f
  .el .ie \\*(f4 .ds f4 \\n(.f
  .el .tm ? font overflow
  .ft \\$1
  ..
  .de fP
  .ie     !\\*(f4 \{\
  .	ft \\*(f4
  .	ds f4\"
  '	br \}
  .el .ie !\\*(f3 \{\
  .	ft \\*(f3
  .	ds f3\"
  '	br \}
  .el .ie !\\*(f2 \{\
  .	ft \\*(f2
  .	ds f2\"
  '	br \}
  .el .ie !\\*(f1 \{\
  .	ft \\*(f1
  .	ds f1\"
  '	br \}
  .el .tm ? font underflow
  ..
  .ds f1\"
  .ds f2\"
  .ds f3\"
  .ds f4\"
  .ta 8n 16n 24n 32n 40n 48n 56n 64n 72n  
  .TH "fc-cache" "1" 
  .SH "NAME" 
  fc-cache \(em build font information cache files 
  .SH "SYNOPSIS" 
  .PP 
  \fBfc-cache\fR [\fB-cfsvV?\fP]  [\fB\-\-chroot root\fP]  [\fB\-\-force\fP]  [\fB\-\-system-only\fP]  [\fB\-\-verbose\fP]  [\fB\-\-version\fP]  [\fB\-\-help\fP]  [\fB\fIdirs\fR\fP]  
  .SH "DESCRIPTION" 
  .PP 
  \fBfc-cache\fR scans the font directories on 
  the system and builds font information cache files for 
  applications using fontconfig for their font handling\&. 
  .PP 
  If directory arguments are not given, 
  \fBfc-cache\fR 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\&. 
  .PP 
  Note that \fBfc-cache\fR must be executed 
  once per architecture to generate font information customized 
  for that architecture\&.  On a subsequent run, 
  \fBfc-cache\fR will augment the cache 
  information files with the information for the new 
  architecture\&.  
  .SH "OPTIONS" 
  .PP 
  This program follows the usual GNU command line syntax, 
  with long options starting with two dashes (`\-\&')\&.  A summary of 
  options is included below\&. 
  .IP "\fB-c root\fP 	  \fB\-\-chroot root\fP 	" 10 
  Change root directory into root  
  before starting\&. 
  .IP "\fB-f\fP           \fB\-\-force\fP         " 10 
  Force re-generation of apparently up-to-date cache files, 
  overriding the timestamp checking\&. 
  .IP "\fB-s\fP           \fB\-\-system-only\fP         " 10 
  Only scan system-wide directories, omitting the places 
  located in the user\&'s home directory\&. 
  .IP "\fB-v\fP           \fB\-\-verbose\fP         " 10 
  Display status information while busy\&. 
  .IP "\fB-?\fP           \fB\-\-help\fP         " 10 
  Show summary of options\&. 
  .IP "\fB-V\fP           \fB\-\-version\fP         " 10 
  Show version of the program and exit\&. 
  .IP "\fB\fIdirs\fR\fP         " 10 
  A list of directories to scan for fonts\&. 
  .SH "FILES" 
  .IP "\fBfonts\&.cache-2\fP" 10 
  These files are generated by \fBfc-cache\fR             and contain maps from file names to font properties\&. They are 
  read by the fontconfig library at application startup to locate 
  appropriate fonts\&. 
  .SH "SEE ALSO" 
  .PP 
  \fBfc-list\fR (1)\&. 
  .PP 
  The fontconfig user\&'s guide, in HTML format: 
  \fB/usr/share/doc/fontconfig/fontconfig-user\&.html\fP\&. 
  .SH "AUTHOR" 
  .PP 
  This manual page was written by Keith Packard 
  keithp@keithp\&.com and Josselin Mouette joss@debian\&.org\&. 
  ...\" created by instant / docbook-to-man, Tue 16 Oct 2007, 23:05