From af91d4da42e0af733538d923a2514bf6a6bd3e73 Mon Sep 17 00:00:00 2001
From: Michael Smith <xmldoc@users.sourceforge.net>
Date: Mon, 24 Apr 2006 05:52:56 +0000
Subject: [PATCH] Added refentry.meta.get.quietly param.

If zero (the default), notes and warnings about "missing" markup
are generated during gathering of refentry metadata. If non-zero,
the metadata is gathered "quietly" -- that is, the notes and
warnings are suppressed.

NOTE: If you are processing a large amount of refentry content,
      you may be able to speed up processing significantly by
      setting a non-zero value for refentry.meta.get.quietly.
---
 xsl/common/refentry.xsl                  |  2 --
 xsl/manpages/param.ent                   |  1 +
 xsl/manpages/param.xweb                  |  2 ++
 xsl/params/refentry.meta.get.quietly.xml | 32 ++++++++++++++++++++++++
 4 files changed, 35 insertions(+), 2 deletions(-)
 create mode 100644 xsl/params/refentry.meta.get.quietly.xml

diff --git a/xsl/common/refentry.xsl b/xsl/common/refentry.xsl
index 1f663a80b..73752bbed 100644
--- a/xsl/common/refentry.xsl
+++ b/xsl/common/refentry.xsl
@@ -17,8 +17,6 @@
 
 <!-- ==================================================================== -->
 
-<xsl:param name="refentry.meta.get.quietly" select="0"/>
-
 <doc:reference xmlns="">
   <referenceinfo>
     <releaseinfo role="meta">
diff --git a/xsl/manpages/param.ent b/xsl/manpages/param.ent
index 1ecb8f12d..cdf535c94 100644
--- a/xsl/manpages/param.ent
+++ b/xsl/manpages/param.ent
@@ -15,6 +15,7 @@
 <!ENTITY man.charmap.use.subset SYSTEM "../params/man.charmap.use.subset.xml">
 <!ENTITY man.charmap.uri SYSTEM "../params/man.charmap.uri.xml">
 <!ENTITY man.charmap.subset.profile SYSTEM "../params/man.charmap.subset.profile.xml">
+<!ENTITY refentry.meta.get.quietly SYSTEM "../params/refentry.meta.get.quietly.xml">
 <!ENTITY refentry.date.profile.enabled SYSTEM "../params/refentry.date.profile.enabled.xml">
 <!ENTITY refentry.manual.profile.enabled SYSTEM "../params/refentry.manual.profile.enabled.xml">
 <!ENTITY refentry.source.name.profile.enabled SYSTEM "../params/refentry.source.name.profile.enabled.xml">
diff --git a/xsl/manpages/param.xweb b/xsl/manpages/param.xweb
index a81d69371..c8a9e7b28 100644
--- a/xsl/manpages/param.xweb
+++ b/xsl/manpages/param.xweb
@@ -59,6 +59,7 @@
   </reference>
   <reference id="refmeta">
   <title>Refentry metadata gathering</title>
+&refentry.meta.get.quietly;
 &refentry.date.profile;
 &refentry.date.profile.enabled;
 &refentry.manual.profile;
@@ -133,6 +134,7 @@
 <src:fragref linkend="man.subheading.divider.frag"/>
 <src:fragref linkend="man.subheading.divider.enabled.frag"/>
 <src:fragref linkend="refentry.date.profile.enabled.frag"/>
+<src:fragref linkend="refentry.meta.get.quietly.frag"/>
 <src:fragref linkend="refentry.manual.profile.enabled.frag"/>
 <src:fragref linkend="refentry.source.name.profile.enabled.frag"/>
 <src:fragref linkend="refentry.version.profile.enabled.frag"/>
diff --git a/xsl/params/refentry.meta.get.quietly.xml b/xsl/params/refentry.meta.get.quietly.xml
new file mode 100644
index 000000000..04d75f424
--- /dev/null
+++ b/xsl/params/refentry.meta.get.quietly.xml
@@ -0,0 +1,32 @@
+<refentry id="refentry.meta.get.quietly">
+<refmeta>
+<refentrytitle>refentry.meta.get.quietly</refentrytitle>
+
+</refmeta>
+<refnamediv>
+<refname>refentry.meta.get.quietly</refname>
+<refpurpose>Suppress notes and warnings when gathering refentry metadata?</refpurpose>
+</refnamediv>
+
+<refsynopsisdiv>
+<src:fragment id='refentry.meta.get.quietly.frag'>
+<xsl:param name="refentry.meta.get.quietly" select="0"/>
+</src:fragment>
+</refsynopsisdiv>
+
+<refsect1><title>Description</title>
+
+<para>If zero (the default), notes and warnings about “missing” markup
+are generated during gathering of refentry metadata. If non-zero, the
+metadata is gathered “quietly” -- that is, the notes and warnings are
+suppressed.</para>
+
+<tip>
+  <para>If you are processing a large amount of <tag>refentry</tag>
+  content, you may be able to speed up processing significantly by
+  setting a non-zero value for
+  <parameter>refentry.meta.get.quietly</parameter>.</para>
+</tip>
+
+</refsect1>
+</refentry>
-- 
2.40.0