Add rule to regenerate man pages from Docbook. (man_MANS): Add

2003-06-17  Matthias Clasen  <maclas@gmx.de>

	* docs/Makefile.am: Add rule to regenerate man pages from
	Docbook.
	(man_MANS): Add pango-querymodules.1.
	(content_files): Add pangoe-querymodules.xml.

	* docs/pango-querymodules.xml: New refentry.

	* docs/pango-querymodules.1: Man page generated from the .xml source.

	* docs/pango-docs.sgml: Include pango-querymodules.xml.

	* acinclude.m4 (JH_PATH_XML_CATALOG, JH_CHECK_XML_CATALOG): New
	macros to check for XML catalog contents and path, borrowed from
	gtk-doc.

	* configure.in: New option --enable-man to enable regeneration of
	man pages from Docbook, if the necessary tools are found.

4 files changed, 120 insertions, 1 deletions

diff --git a/docs/Makefile.am b/docs/Makefile.am
index 25889432..6650dea9 100644
--- a/docs/Makefile.am
+++ b/docs/Makefile.am
@@ -48,7 +48,8 @@ MKDB_OPTIONS=--sgml-mode --output-format=xml
 # Non-autogenerated SGML files to be included in $(DOC_MAIN_SGML_FILE)
 content_files =				\
 	pango_markup.sgml		\
-	version.xml
+	version.xml			\
+	pango-querymodules.xml
 
 # Images to copy into HTML directory
 HTML_IMAGES =				\
@@ -57,6 +58,15 @@ HTML_IMAGES =				\
 # Extra options to supply to gtkdoc-fixref
 FIXXREF_OPTIONS=
 
+man_MANS = pango-querymodules.1 
+
+if ENABLE_MAN
+
+%.1 : %.xml 
+	@XSLTPROC@ -nonet http://docbook.sourceforge.net/release/xsl/current/manpages/docbook.xsl $<
+
+endif
+
 include $(top_srcdir)/gtk-doc.make
 
 EXTRA_DIST +=				\
diff --git a/docs/pango-docs.sgml b/docs/pango-docs.sgml
index 0408a343..f78a86dd 100644
--- a/docs/pango-docs.sgml
+++ b/docs/pango-docs.sgml
@@ -17,6 +17,7 @@
 <!ENTITY pango-Xft-Fonts-and-Rendering SYSTEM "xml/xft-fonts.xml">
 <!ENTITY pango-OpenType-Font-Handling SYSTEM "xml/opentype.xml">
 <!ENTITY markup-format SYSTEM "pango_markup.sgml">
+<!ENTITY pango-querymodules SYSTEM "pango-querymodules.xml">
 <!ENTITY version SYSTEM "version.xml">
 ]>
 <book id="index">
@@ -53,6 +54,12 @@
     &pango-Modules;
     </chapter>
 
+  <chapter id="tools">
+    <title>Pango Tools</title>
+
+    &pango-querymodules;
+  </chapter>
+
   <index/>
 
 </book>
diff --git a/docs/pango-querymodules.1 b/docs/pango-querymodules.1
new file mode 100644
index 00000000..c7c34901
--- /dev/null
+++ b/docs/pango-querymodules.1
@@ -0,0 +1,49 @@
+.\"Generated by db2man.xsl. Don't modify this, modify the source.
+.de Sh \" Subsection
+.br
+.if t .Sp
+.ne 5
+.PP
+\fB\\$1\fR
+.PP
+..
+.de Sp \" Vertical space (when we can't use .PP)
+.if t .sp .5v
+.if n .sp
+..
+.de Ip \" List item
+.br
+.ie \\n(.$>=3 .ne \\$3
+.el .ne 3
+.IP "\\$1" \\$2
+..
+.TH "PANGO-QUERYMODULES" 1 "" "" ""
+.SH NAME
+pango-querymodules \- Module registration utility
+.SH "SYNOPSIS"
+
+.nf
+\fBpango-querymodules\fR [module...]
+.fi
+
+.SH "DESCRIPTION"
+
+.PP
+ \fBpango-querymodules\fR collects information about loadable modules for Pango and writes it to \fIstdout\fR\&.
+
+.PP
+If called without arguments, it looks for modules in the Pango module path\&.
+
+.PP
+If called with arguments, it looks for the specified modules\&. The arguments may be absolute or relative paths\&.
+
+.SH "ENVIRONMENT"
+
+.PP
+The Pango module path is specified by the key Pango/ModulesPath in the Pango config database, which is read from \fI\fIsysconfdir\fR/pango/pangorc\fR, \fI~/\&.pangorc\fR and the file specified in the environment variable \fBPANGO_RC_FILE\fR\&.
+
+.SH "BUGS"
+
+.PP
+None known yet\&.
+
diff --git a/docs/pango-querymodules.xml b/docs/pango-querymodules.xml
new file mode 100644
index 00000000..1677d92e
--- /dev/null
+++ b/docs/pango-querymodules.xml
@@ -0,0 +1,53 @@
+<refentry id="pango-querymodules">
+
+<refmeta>
+<refentrytitle>pango-querymodules</refentrytitle>
+<manvolnum>1</manvolnum>
+</refmeta>
+
+<refnamediv>
+<refname>pango-querymodules</refname>
+<refpurpose>Module registration utility</refpurpose>
+</refnamediv>
+
+<refsynopsisdiv>
+<cmdsynopsis>
+<command>pango-querymodules</command>
+<arg choice="opt" rep="repeat">module</arg>
+</cmdsynopsis>
+</refsynopsisdiv>
+
+<refsect1><title>Description</title>
+<para>
+<command>pango-querymodules</command> collects information about loadable 
+modules for Pango and writes it to <filename>stdout</filename>. 
+</para>
+<para>
+If called without arguments, it looks for modules in the Pango module path.  
+</para>
+<para>
+If called with arguments, it looks for the specified modules. The arguments
+may be absolute or relative paths.
+</para>
+</refsect1>
+
+<refsect1><title>Environment</title>
+<para>
+The Pango module path is specified by the key
+<literal>Pango/ModulesPath</literal> in the Pango config database, which is
+read from
+      <filename><replaceable>sysconfdir</replaceable>/pango/pangorc</filename>,
+      <filename>~/.pangorc</filename> and the file specified in the environment
+      variable <envar>PANGO_RC_FILE</envar>. 
+</para>
+</refsect1>
+
+<refsect1><title>Bugs</title>
+<para>
+None known yet.
+</para>
+</refsect1>
+
+</refentry>
+
+