Imported Upstream version 2.11.93
[platform/upstream/fontconfig.git] / fc-cache / fc-cache.1
index f111f86..e514779 100644 (file)
@@ -4,7 +4,7 @@
 fc-cache \- build font information cache files
 .SH SYNOPSIS
 .sp
-\fBfc-cache\fR [ \fB-frsvVh\fR ]  [ \fB--force\fR ]  [ \fB--really-force\fR ]  [ \fB--system-only\fR ]  [ \fB--verbose\fR ]  [ \fB--version\fR ]  [ \fB--help\fR ]  [ \fB\fIdir\fB\fR\fI...\fR ] 
+\fBfc-cache\fR [ \fB-EfrsvVh\fR ]  [ \fB--error-on-no-fonts\fR ]  [ \fB--force\fR ]  [ \fB--really-force\fR ]  [ \fB [ -y \fIdir\fB ]  [ --sysroot \fIdir\fB ] \fR ]  [ \fB--system-only\fR ]  [ \fB--verbose\fR ]  [ \fB--version\fR ]  [ \fB--help\fR ]  [ \fB\fIdir\fB\fR\fI...\fR ] 
 .SH "DESCRIPTION"
 .PP
 \fBfc-cache\fR scans the font directories on
@@ -28,6 +28,11 @@ This program follows the usual GNU command line syntax,
 with long options starting with two dashes (`-'). A summary of
 options is included below.
 .TP
+\fB-E\fR
+Raise an error if there are no fonts in
+\fB\fIdir\fB\fR or directories
+in the configuration if not given.
+.TP
 \fB-f\fR
 Force re-generation of apparently up-to-date cache files,
 overriding the timestamp checking.
@@ -42,6 +47,9 @@ located in the user's home directory.
 \fB-v\fR
 Display status information while busy.
 .TP
+\fB-y\fR
+Prepend \fB\fIdir\fB\fR to all paths for scanning.
+.TP
 \fB-h\fR
 Show summary of options.
 .TP
@@ -50,9 +58,12 @@ Show version of the program and exit.
 .TP
 \fB\fIdir\fB\fR
 Directory to scan for fonts.
+.SH "RETURN CODES"
+.PP
+\fBfc-cache\fR returns zero if the caches successfully generated. otherwise non-zero.
 .SH "FILES"
 .TP
-\fB\fI%cachdir%/*-%arch%\&.cache-2\fB\fR
+\fB\fI%cachedir%/*-%arch%\&.cache-%version%\fB\fR
 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