- generate manual pages for the tools from their sgml sources,

- unbreak Makefiles.am so that if the nroff man pages are present they
  get installed, even without docbook tools.

2 files changed, 116 insertions, 2 deletions

diff --git a/lib/fontconfig/fc-cache/Makefile.am b/lib/fontconfig/fc-cache/Makefile.am
index 55c43d820..225b50a45 100644
--- a/lib/fontconfig/fc-cache/Makefile.am
+++ b/lib/fontconfig/fc-cache/Makefile.am
@@ -41,10 +41,10 @@ EXTRA_DIST=fc-cache.sgml
 
 fc_cache_LDADD = ${top_builddir}/src/libfontconfig.la $(FREETYPE_LIBS) $(LIBXML2_LIBS) $(EXPAT_LIBS)
 
-if USEDOCBOOK
-
 man_MANS=fc-cache.1
 
+if USEDOCBOOK
+
 ${man_MANS}: ${SGML}	
 	$(RM) $@
 	$(DOC2MAN) ${SGML}
diff --git a/lib/fontconfig/fc-cache/fc-cache.1 b/lib/fontconfig/fc-cache/fc-cache.1
new file mode 100644
index 000000000..30cb5308a
--- /dev/null
+++ b/lib/fontconfig/fc-cache/fc-cache.1
@@ -0,0 +1,114 @@
+...\" $Header: /cvs/OpenBSD/xenocara/lib/fontconfig/fc-cache/fc-cache.1,v 1.1 2007/05/05 10:32:29 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-fsvV?\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-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, Sat 05 May 2007, 11:42