From 892fe105075787bbfaad4b7b8edad9f9444dd441 Mon Sep 17 00:00:00 2001
From: Michael Smith <xmldoc@users.sourceforge.net>
Date: Sun, 22 Jul 2007 12:19:19 +0000
Subject: [PATCH] Added the man.authors.section.enabled and
 man.copyright.section.enabled parameters. Set those to zero when you want to
 suppress display of the auto-generated AUTHORS and COPYRIGHT sections. Closes
 request #1467806. Thanks to Daniel Leidert.

---
 xsl/manpages/docbook.xsl                     | 16 ++--
 xsl/manpages/param.ent                       | 86 ++++++++++----------
 xsl/manpages/param.xweb                      | 81 +++++++++---------
 xsl/params/man.authors.section.enabled.xml   | 46 +++++++++++
 xsl/params/man.copyright.section.enabled.xml | 46 +++++++++++
 5 files changed, 190 insertions(+), 85 deletions(-)
 create mode 100644 xsl/params/man.authors.section.enabled.xml
 create mode 100644 xsl/params/man.copyright.section.enabled.xml

diff --git a/xsl/manpages/docbook.xsl b/xsl/manpages/docbook.xsl
index 2e8292ab5..b43e9b119 100644
--- a/xsl/manpages/docbook.xsl
+++ b/xsl/manpages/docbook.xsl
@@ -233,15 +233,19 @@
       <!-- * - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -->
       <!-- * AUTHOR section -->
       <!-- * - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -->
-      <xsl:call-template name="author.section">
-        <xsl:with-param name="info" select="$info"/>
-      </xsl:call-template>
+      <xsl:if test="not($man.authors.section.enabled = 0)">
+        <xsl:call-template name="author.section">
+          <xsl:with-param name="info" select="$info"/>
+        </xsl:call-template>
+      </xsl:if>
       <!-- * - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -->
       <!-- * COPYRIGHT section -->
       <!-- * - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -->
-      <xsl:call-template name="copyright.section">
-        <xsl:with-param name="info" select="$info"/>
-      </xsl:call-template>
+      <xsl:if test="not($man.copyright.section.enabled = 0)">
+        <xsl:call-template name="copyright.section">
+          <xsl:with-param name="info" select="$info"/>
+        </xsl:call-template>
+      </xsl:if>
       <!-- * - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -->
       <!-- * NOTES list (only if user wants endnotes numbered and/or listed) -->
       <!-- * - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -->
diff --git a/xsl/manpages/param.ent b/xsl/manpages/param.ent
index 2e4c45e08..7441d53ed 100644
--- a/xsl/manpages/param.ent
+++ b/xsl/manpages/param.ent
@@ -1,57 +1,59 @@
+<!ENTITY man.authors.section.enabled SYSTEM "../params/man.authors.section.enabled.xml">
+<!ENTITY man.break.after.slash SYSTEM "../params/man.break.after.slash.xml">
+<!ENTITY man.charmap.enabled SYSTEM "../params/man.charmap.enabled.xml">
+<!ENTITY man.charmap.subset.profile SYSTEM "../params/man.charmap.subset.profile.xml">
+<!ENTITY man.charmap.uri SYSTEM "../params/man.charmap.uri.xml">
+<!ENTITY man.charmap.use.subset SYSTEM "../params/man.charmap.use.subset.xml">
+<!ENTITY man.copyright.section.enabled SYSTEM "../params/man.copyright.section.enabled.xml">
+<!ENTITY man.endnotes.are.numbered SYSTEM "../params/man.endnotes.are.numbered.xml">
+<!ENTITY man.endnotes.list.enabled SYSTEM "../params/man.endnotes.list.enabled.xml">
+<!ENTITY man.endnotes.list.heading SYSTEM "../params/man.endnotes.list.heading.xml">
+<!ENTITY man.font.funcprototype SYSTEM "../params/man.font.funcprototype.xml">
+<!ENTITY man.font.funcsynopsisinfo SYSTEM "../params/man.font.funcsynopsisinfo.xml">
+<!ENTITY man.font.table.headings SYSTEM "../params/man.font.table.headings.xml">
+<!ENTITY man.font.table.title SYSTEM "../params/man.font.table.title.xml">
+<!ENTITY man.hyphenate.computer.inlines SYSTEM "../params/man.hyphenate.computer.inlines.xml">
+<!ENTITY man.hyphenate.filenames SYSTEM "../params/man.hyphenate.filenames.xml">
 <!ENTITY man.hyphenate SYSTEM "../params/man.hyphenate.xml">
 <!ENTITY man.hyphenate.urls SYSTEM "../params/man.hyphenate.urls.xml">
-<!ENTITY man.hyphenate.filenames SYSTEM "../params/man.hyphenate.filenames.xml">
-<!ENTITY man.hyphenate.computer.inlines SYSTEM "../params/man.hyphenate.computer.inlines.xml">
-<!ENTITY man.justify SYSTEM "../params/man.justify.xml">
-<!ENTITY man.break.after.slash SYSTEM "../params/man.break.after.slash.xml">
-<!ENTITY man.indent.width SYSTEM "../params/man.indent.width.xml">
-<!ENTITY man.indent.refsect SYSTEM "../params/man.indent.refsect.xml">
 <!ENTITY man.indent.blurbs SYSTEM "../params/man.indent.blurbs.xml">
 <!ENTITY man.indent.lists SYSTEM "../params/man.indent.lists.xml">
+<!ENTITY man.indent.refsect SYSTEM "../params/man.indent.refsect.xml">
 <!ENTITY man.indent.verbatims SYSTEM "../params/man.indent.verbatims.xml">
-<!ENTITY man.endnotes.list.enabled SYSTEM "../params/man.endnotes.list.enabled.xml">
-<!ENTITY man.endnotes.list.heading SYSTEM "../params/man.endnotes.list.heading.xml">
-<!ENTITY man.endnotes.are.numbered SYSTEM "../params/man.endnotes.are.numbered.xml">
+<!ENTITY man.indent.width SYSTEM "../params/man.indent.width.xml">
+<!ENTITY man.justify SYSTEM "../params/man.justify.xml">
 <!ENTITY man.links.are.underlined SYSTEM "../params/man.links.are.underlined.xml">
+<!ENTITY man.output.base.dir SYSTEM "../params/man.output.base.dir.xml">
+<!ENTITY man.output.encoding SYSTEM "../params/man.output.encoding.xml">
+<!ENTITY man.output.in.separate.dir SYSTEM "../params/man.output.in.separate.dir.xml">
+<!ENTITY man.output.lang.in.name.enabled SYSTEM "../params/man.output.lang.in.name.enabled.xml">
+<!ENTITY man.output.manifest.enabled SYSTEM "../params/man.output.manifest.enabled.xml">
+<!ENTITY man.output.manifest.filename SYSTEM "../params/man.output.manifest.filename.xml">
+<!ENTITY man.output.quietly SYSTEM "../params/man.output.quietly.xml">
+<!ENTITY man.output.subdirs.enabled SYSTEM "../params/man.output.subdirs.enabled.xml">
+<!ENTITY man.segtitle.suppress SYSTEM "../params/man.segtitle.suppress.xml">
+<!ENTITY man.string.subst.map.local.post SYSTEM "../params/man.string.subst.map.local.post.xml">
 <!ENTITY man.string.subst.map.local.pre SYSTEM "../params/man.string.subst.map.local.pre.xml">
 <!ENTITY man.string.subst.map SYSTEM "../params/man.string.subst.map.xml">
-<!ENTITY man.string.subst.map.local.post SYSTEM "../params/man.string.subst.map.local.post.xml">
-<!ENTITY man.charmap.enabled SYSTEM "../params/man.charmap.enabled.xml">
-<!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 man.subheading.divider.enabled SYSTEM "../params/man.subheading.divider.enabled.xml">
+<!ENTITY man.subheading.divider SYSTEM "../params/man.subheading.divider.xml">
+<!ENTITY man.table.footnotes.divider SYSTEM "../params/man.table.footnotes.divider.xml">
+<!ENTITY man.th.extra1.suppress SYSTEM "../params/man.th.extra1.suppress.xml">
+<!ENTITY man.th.extra2.max.length SYSTEM "../params/man.th.extra2.max.length.xml">
+<!ENTITY man.th.extra2.suppress SYSTEM "../params/man.th.extra2.suppress.xml">
+<!ENTITY man.th.extra3.max.length SYSTEM "../params/man.th.extra3.max.length.xml">
+<!ENTITY man.th.extra3.suppress SYSTEM "../params/man.th.extra3.suppress.xml">
+<!ENTITY man.th.title.max.length SYSTEM "../params/man.th.title.max.length.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">
-<!ENTITY refentry.version.profile.enabled SYSTEM "../params/refentry.version.profile.enabled.xml">
-<!ENTITY refentry.source.name.suppress SYSTEM "../params/refentry.source.name.suppress.xml">
-<!ENTITY refentry.version.suppress SYSTEM "../params/refentry.version.suppress.xml">
 <!ENTITY refentry.date.profile SYSTEM "../params/refentry.date.profile.xml">
 <!ENTITY refentry.manual.fallback.profile SYSTEM "../params/refentry.manual.fallback.profile.xml">
+<!ENTITY refentry.manual.profile.enabled SYSTEM "../params/refentry.manual.profile.enabled.xml">
 <!ENTITY refentry.manual.profile SYSTEM "../params/refentry.manual.profile.xml">
+<!ENTITY refentry.meta.get.quietly SYSTEM "../params/refentry.meta.get.quietly.xml">
 <!ENTITY refentry.source.fallback.profile SYSTEM "../params/refentry.source.fallback.profile.xml">
+<!ENTITY refentry.source.name.profile.enabled SYSTEM "../params/refentry.source.name.profile.enabled.xml">
 <!ENTITY refentry.source.name.profile SYSTEM "../params/refentry.source.name.profile.xml">
+<!ENTITY refentry.source.name.suppress SYSTEM "../params/refentry.source.name.suppress.xml">
+<!ENTITY refentry.version.profile.enabled SYSTEM "../params/refentry.version.profile.enabled.xml">
 <!ENTITY refentry.version.profile SYSTEM "../params/refentry.version.profile.xml">
-<!ENTITY man.th.title.max.length SYSTEM "../params/man.th.title.max.length.xml">
-<!ENTITY man.th.extra2.max.length SYSTEM "../params/man.th.extra2.max.length.xml">
-<!ENTITY man.th.extra3.max.length SYSTEM "../params/man.th.extra3.max.length.xml">
-<!ENTITY man.th.extra1.suppress SYSTEM "../params/man.th.extra1.suppress.xml">
-<!ENTITY man.th.extra2.suppress SYSTEM "../params/man.th.extra2.suppress.xml">
-<!ENTITY man.th.extra3.suppress SYSTEM "../params/man.th.extra3.suppress.xml">
-<!ENTITY man.output.quietly SYSTEM "../params/man.output.quietly.xml">
-<!ENTITY man.output.manifest.enabled SYSTEM "../params/man.output.manifest.enabled.xml">
-<!ENTITY man.output.manifest.filename SYSTEM "../params/man.output.manifest.filename.xml">
-<!ENTITY man.output.encoding SYSTEM "../params/man.output.encoding.xml">
-<!ENTITY man.output.in.separate.dir SYSTEM "../params/man.output.in.separate.dir.xml">
-<!ENTITY man.output.lang.in.name.enabled SYSTEM "../params/man.output.lang.in.name.enabled.xml">
-<!ENTITY man.output.base.dir SYSTEM "../params/man.output.base.dir.xml">
-<!ENTITY man.output.subdirs.enabled SYSTEM "../params/man.output.subdirs.enabled.xml">
-<!ENTITY man.subheading.divider SYSTEM "../params/man.subheading.divider.xml">
-<!ENTITY man.subheading.divider.enabled SYSTEM "../params/man.subheading.divider.enabled.xml">
-<!ENTITY man.table.footnotes.divider SYSTEM "../params/man.table.footnotes.divider.xml">
-<!ENTITY man.segtitle.suppress SYSTEM "../params/man.segtitle.suppress.xml">
-<!ENTITY man.font.funcprototype SYSTEM "../params/man.font.funcprototype.xml">
-<!ENTITY man.font.funcsynopsisinfo SYSTEM "../params/man.font.funcsynopsisinfo.xml">
-<!ENTITY man.font.table.headings SYSTEM "../params/man.font.table.headings.xml">
-<!ENTITY man.font.table.title SYSTEM "../params/man.font.table.title.xml">
+<!ENTITY refentry.version.suppress SYSTEM "../params/refentry.version.suppress.xml">
diff --git a/xsl/manpages/param.xweb b/xsl/manpages/param.xweb
index 4612874ff..46b683ff7 100644
--- a/xsl/manpages/param.xweb
+++ b/xsl/manpages/param.xweb
@@ -53,6 +53,11 @@
 &man.font.funcsynopsisinfo;
 &man.font.table.headings;
 &man.font.table.title;
+  </reference>
+  <reference xml:id="authors">
+  <title>AUTHORS and COPYRIGHT sections</title>
+  &man.authors.section.enabled;
+  &man.copyright.section.enabled;
   </reference>
   <reference xml:id="endnotes">
   <title>Endnotes and link handling</title>
@@ -140,63 +145,65 @@
 
      ******************************************************************** -->
 
+<src:fragref linkend="man.authors.section.enabled.frag"/>
 <src:fragref linkend="man.break.after.slash.frag"/>
+<src:fragref linkend="man.charmap.enabled.frag"/>
+<src:fragref linkend="man.charmap.subset.profile.frag"/>
+<src:fragref linkend="man.charmap.uri.frag"/>
+<src:fragref linkend="man.charmap.use.subset.frag"/>
+<src:fragref linkend="man.copyright.section.enabled.frag"/>
+<src:fragref linkend="man.endnotes.are.numbered.frag"/>
+<src:fragref linkend="man.endnotes.list.enabled.frag"/>
+<src:fragref linkend="man.endnotes.list.heading.frag"/>
+<src:fragref linkend="man.font.funcprototype.frag"/>
+<src:fragref linkend="man.font.funcsynopsisinfo.frag"/>
+<src:fragref linkend="man.font.table.headings.frag"/>
+<src:fragref linkend="man.font.table.title.frag"/>
+<src:fragref linkend="man.hyphenate.computer.inlines.frag"/>
+<src:fragref linkend="man.hyphenate.filenames.frag"/>
 <src:fragref linkend="man.hyphenate.frag"/>
 <src:fragref linkend="man.hyphenate.urls.frag"/>
-<src:fragref linkend="man.hyphenate.filenames.frag"/>
-<src:fragref linkend="man.hyphenate.computer.inlines.frag"/>
-<src:fragref linkend="man.justify.frag"/>
-<src:fragref linkend="man.indent.width.frag"/>
-<src:fragref linkend="man.indent.refsect.frag"/>
 <src:fragref linkend="man.indent.blurbs.frag"/>
 <src:fragref linkend="man.indent.lists.frag"/>
+<src:fragref linkend="man.indent.refsect.frag"/>
 <src:fragref linkend="man.indent.verbatims.frag"/>
-<src:fragref linkend="man.font.funcprototype.frag"/>
-<src:fragref linkend="man.font.funcsynopsisinfo.frag"/>
-<src:fragref linkend="man.font.table.headings.frag"/>
-<src:fragref linkend="man.font.table.title.frag"/>
-<src:fragref linkend="man.output.manifest.enabled.frag"/>
-<src:fragref linkend="man.output.manifest.filename.frag"/>
-<src:fragref linkend="man.output.quietly.frag"/>
+<src:fragref linkend="man.indent.width.frag"/>
+<src:fragref linkend="man.justify.frag"/>
+<src:fragref linkend="man.links.are.underlined.frag"/>
+<src:fragref linkend="man.output.base.dir.frag"/>
 <src:fragref linkend="man.output.encoding.frag"/>
 <src:fragref linkend="man.output.in.separate.dir.frag"/>
 <src:fragref linkend="man.output.lang.in.name.enabled.frag"/>
-<src:fragref linkend="man.output.base.dir.frag"/>
+<src:fragref linkend="man.output.manifest.enabled.frag"/>
+<src:fragref linkend="man.output.manifest.filename.frag"/>
+<src:fragref linkend="man.output.quietly.frag"/>
 <src:fragref linkend="man.output.subdirs.enabled.frag"/>
-<src:fragref linkend="man.string.subst.map.local.pre.frag"/>
+<src:fragref linkend="man.segtitle.suppress.frag"/>
 <src:fragref linkend="man.string.subst.map.frag"/>
 <src:fragref linkend="man.string.subst.map.local.post.frag"/>
-<src:fragref linkend="man.endnotes.list.enabled.frag"/>
-<src:fragref linkend="man.endnotes.list.heading.frag"/>
-<src:fragref linkend="man.endnotes.are.numbered.frag"/>
-<src:fragref linkend="man.links.are.underlined.frag"/>
-<src:fragref linkend="man.charmap.enabled.frag"/>
-<src:fragref linkend="man.charmap.uri.frag"/>
-<src:fragref linkend="man.charmap.use.subset.frag"/>
-<src:fragref linkend="man.charmap.subset.profile.frag"/>
-<src:fragref linkend="man.segtitle.suppress.frag"/>
-<src:fragref linkend="man.table.footnotes.divider.frag"/>
-<src:fragref linkend="man.subheading.divider.frag"/>
+<src:fragref linkend="man.string.subst.map.local.pre.frag"/>
 <src:fragref linkend="man.subheading.divider.enabled.frag"/>
+<src:fragref linkend="man.subheading.divider.frag"/>
+<src:fragref linkend="man.table.footnotes.divider.frag"/>
+<src:fragref linkend="man.th.extra1.suppress.frag"/>
+<src:fragref linkend="man.th.extra2.max.length.frag"/>
+<src:fragref linkend="man.th.extra2.suppress.frag"/>
+<src:fragref linkend="man.th.extra3.max.length.frag"/>
+<src:fragref linkend="man.th.extra3.suppress.frag"/>
+<src:fragref linkend="man.th.title.max.length.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"/>
-<src:fragref linkend="refentry.source.name.suppress.frag"/>
-<src:fragref linkend="refentry.version.suppress.frag"/>
 <src:fragref linkend="refentry.date.profile.frag"/>
 <src:fragref linkend="refentry.manual.fallback.profile.frag"/>
+<src:fragref linkend="refentry.manual.profile.enabled.frag"/>
 <src:fragref linkend="refentry.manual.profile.frag"/>
+<src:fragref linkend="refentry.meta.get.quietly.frag"/>
 <src:fragref linkend="refentry.source.fallback.profile.frag"/>
+<src:fragref linkend="refentry.source.name.profile.enabled.frag"/>
 <src:fragref linkend="refentry.source.name.profile.frag"/>
+<src:fragref linkend="refentry.source.name.suppress.frag"/>
+<src:fragref linkend="refentry.version.profile.enabled.frag"/>
 <src:fragref linkend="refentry.version.profile.frag"/>
-<src:fragref linkend="man.th.title.max.length.frag"/>
-<src:fragref linkend="man.th.extra2.max.length.frag"/>
-<src:fragref linkend="man.th.extra3.max.length.frag"/>
-<src:fragref linkend="man.th.extra1.suppress.frag"/>
-<src:fragref linkend="man.th.extra2.suppress.frag"/>
-<src:fragref linkend="man.th.extra3.suppress.frag"/>
+<src:fragref linkend="refentry.version.suppress.frag"/>
 </xsl:stylesheet>
     </src:fragment>
 
diff --git a/xsl/params/man.authors.section.enabled.xml b/xsl/params/man.authors.section.enabled.xml
new file mode 100644
index 000000000..73cb63782
--- /dev/null
+++ b/xsl/params/man.authors.section.enabled.xml
@@ -0,0 +1,46 @@
+<refentry xmlns="http://docbook.org/ns/docbook"
+          xmlns:xlink="http://www.w3.org/1999/xlink"
+          xmlns:xi="http://www.w3.org/2001/XInclude"
+          xmlns:src="http://nwalsh.com/xmlns/litprog/fragment"
+          xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
+          version="5.0" xml:id="man.authors.section.enabled">
+<refmeta>
+<refentrytitle>man.authors.section.enabled</refentrytitle>
+<refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>man.authors.section.enabled</refname>
+<refpurpose>Display auto-generated AUTHORS section?</refpurpose>
+</refnamediv>
+<refsynopsisdiv>
+<src:fragment xml:id="man.authors.section.enabled.frag">
+<xsl:param name="man.authors.section.enabled">1</xsl:param>
+</src:fragment>
+</refsynopsisdiv>
+<refsection><info><title>Description</title></info>
+
+<para>If the value of
+<parameter>man.authors.section.enabled</parameter> is non-zero
+(the default), then an <literal>AUTHORS</literal> section is
+generated near the end of each man page. The output of the
+<literal>AUTHORS</literal> section is assembled from any
+<tag>author</tag>, <tag>editor</tag>, and <tag>othercredit</tag>
+metadata found in the contents of the child <tag>info</tag> or
+<tag>refentryinfo</tag> (if any) of the <tag>refentry</tag>
+itself, or from any <tag>author</tag>, <tag>editor</tag>, and
+<tag>othercredit</tag> metadata that may appear in <tag>info</tag>
+contents of any ancestors of the <tag>refentry</tag>.</para>
+
+<para>If the value of
+<parameter>man.authors.section.enabled</parameter> is zero, the
+the auto-generated <literal>AUTHORS</literal> section is
+suppressed.</para>
+
+<para>Set the value of
+  <parameter>man.authors.section.enabled</parameter> to zero if
+  you want to have a manually created <literal>AUTHORS</literal>
+  section in your source, and you want it to appear in output
+  instead of the auto-generated <literal>AUTHORS</literal>
+  section.</para>
+</refsection>
+</refentry>
diff --git a/xsl/params/man.copyright.section.enabled.xml b/xsl/params/man.copyright.section.enabled.xml
new file mode 100644
index 000000000..9e8358761
--- /dev/null
+++ b/xsl/params/man.copyright.section.enabled.xml
@@ -0,0 +1,46 @@
+<refentry xmlns="http://docbook.org/ns/docbook"
+          xmlns:xlink="http://www.w3.org/1999/xlink"
+          xmlns:xi="http://www.w3.org/2001/XInclude"
+          xmlns:src="http://nwalsh.com/xmlns/litprog/fragment"
+          xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
+          version="5.0" xml:id="man.copyright.section.enabled">
+<refmeta>
+<refentrytitle>man.copyright.section.enabled</refentrytitle>
+<refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>man.copyright.section.enabled</refname>
+<refpurpose>Display auto-generated COPYRIGHT section?</refpurpose>
+</refnamediv>
+<refsynopsisdiv>
+<src:fragment xml:id="man.copyright.section.enabled.frag">
+<xsl:param name="man.copyright.section.enabled">1</xsl:param>
+</src:fragment>
+</refsynopsisdiv>
+<refsection><info><title>Description</title></info>
+
+<para>If the value of
+<parameter>man.copyright.section.enabled</parameter> is non-zero
+(the default), then a <literal>COPYRIGHT</literal> section is
+generated near the end of each man page. The output of the
+<literal>COPYRIGHT</literal> section is assembled from any
+<tag>copyright</tag> and <tag>legalnotice</tag> metadata found in
+the contents of the child <tag>info</tag> or
+<tag>refentryinfo</tag> (if any) of the <tag>refentry</tag>
+itself, or from any <tag>copyright</tag> and
+<tag>legalnotice</tag> metadata that may appear in <tag>info</tag>
+contents of any ancestors of the <tag>refentry</tag>.</para>
+
+<para>If the value of
+<parameter>man.copyright.section.enabled</parameter> is zero, the
+the auto-generated <literal>COPYRIGHT</literal> section is
+suppressed.</para>
+
+<para>Set the value of
+  <parameter>man.copyright.section.enabled</parameter> to zero if
+  you want to have a manually created <literal>COPYRIGHT</literal>
+  section in your source, and you want it to appear in output
+  instead of the auto-generated <literal>COPYRIGHT</literal>
+  section.</para>
+</refsection>
+</refentry>
-- 
2.40.0