<!-- * - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -->
<!-- * 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) -->
<!-- * - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -->
+<!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">
&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>
******************************************************************** -->
+<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>
--- /dev/null
+<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>
--- /dev/null
+<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>