From d241978412144650e73e9b635cf1869f8d4da2b9 Mon Sep 17 00:00:00 2001 From: Matthias Clasen Date: Fri, 3 Aug 2012 00:33:34 +0200 Subject: [PATCH] docs: Improve man page generation Use $(AM_V_GEN) for generating man pages, and set some parameters for the XSL stylesheets. Among other things, don't generate AUTHORS and COPYRIGHT sections. --- docs/reference/gio/Makefile.am | 10 +++++++++- docs/reference/glib/Makefile.am | 10 +++++++++- docs/reference/gobject/Makefile.am | 10 +++++++++- 3 files changed, 27 insertions(+), 3 deletions(-) diff --git a/docs/reference/gio/Makefile.am b/docs/reference/gio/Makefile.am index 7d2d2649a..6b4ab9e00 100644 --- a/docs/reference/gio/Makefile.am +++ b/docs/reference/gio/Makefile.am @@ -153,8 +153,16 @@ man_MANS = \ if ENABLE_MAN +XSLTPROC_FLAGS = \ + --nonet \ + --stringparam man.output.quietly 1 \ + --stringparam funcsynopsis.style ansi \ + --stringparam man.th.extra1.suppress 1 \ + --stringparam man.authors.section.enabled 0 \ + --stringparam man.copyright.section.enabled 0 + .xml.1: - @XSLTPROC@ -nonet http://docbook.sourceforge.net/release/xsl/current/manpages/docbook.xsl $< + $(AM_V_GEN) $(XSLTPROC) $(XSLTPROC_FLAGS) http://docbook.sourceforge.net/release/xsl/current/manpages/docbook.xsl $< dist-local-check-mans-enabled: if grep "Man generation disabled" $(man_MANS) >/dev/null; then $(RM) $(man_MANS); fi diff --git a/docs/reference/glib/Makefile.am b/docs/reference/glib/Makefile.am index d2a54f12b..7108aeb88 100644 --- a/docs/reference/glib/Makefile.am +++ b/docs/reference/glib/Makefile.am @@ -101,8 +101,16 @@ man_MANS = \ if ENABLE_MAN +XSLTPROC_FLAGS = \ + --nonet \ + --stringparam man.output.quietly 1 \ + --stringparam funcsynopsis.style ansi \ + --stringparam man.th.extra1.suppress 1 \ + --stringparam man.authors.section.enabled 0 \ + --stringparam man.copyright.section.enabled 0 + .xml.1: - @XSLTPROC@ -nonet http://docbook.sourceforge.net/release/xsl/current/manpages/docbook.xsl $< + $(AM_V_GEN) $(XSLTPROC) $(XSLTPROC_FLAGS) http://docbook.sourceforge.net/release/xsl/current/manpages/docbook.xsl $< dist-local-check-mans-enabled: if grep "Man generation disabled" $(man_MANS) >/dev/null; then $(RM) $(man_MANS); fi diff --git a/docs/reference/gobject/Makefile.am b/docs/reference/gobject/Makefile.am index 03eaa1671..96181f643 100644 --- a/docs/reference/gobject/Makefile.am +++ b/docs/reference/gobject/Makefile.am @@ -76,8 +76,16 @@ man_MANS = \ if ENABLE_MAN +XSLTPROC_FLAGS = \ + --nonet \ + --stringparam man.output.quietly 1 \ + --stringparam funcsynopsis.style ansi \ + --stringparam man.th.extra1.suppress 1 \ + --stringparam man.authors.section.enabled 0 \ + --stringparam man.copyright.section.enabled 0 + .xml.1: - @XSLTPROC@ -nonet http://docbook.sourceforge.net/release/xsl/current/manpages/docbook.xsl $< + $(AM_V_GEN) $(XSLTPROC) $(XSLTPROC_FLAGS) http://docbook.sourceforge.net/release/xsl/current/manpages/docbook.xsl $< dist-local-check-mans-enabled: if grep "Man generation disabled" $(man_MANS) >/dev/null; then $(RM) $(man_MANS); fi