]> granicus.if.org Git - docbook-dsssl/commit
In manpages output, emit warnings for notesources (footnote, etc.)
authorMichael Smith <xmldoc@users.sourceforge.net>
Tue, 19 Jun 2007 16:52:48 +0000 (16:52 +0000)
committerMichael Smith <xmldoc@users.sourceforge.net>
Tue, 19 Jun 2007 16:52:48 +0000 (16:52 +0000)
commit37cb341ed1baff2012f74c86f15031b4d955e685
tree1382ac539edd5aa45d07c62075171dd8eb23f7d2
parent18dc5c69ec65382d59e94dcf7acc5e31ac62a989
In manpages output, emit warnings for notesources (footnote, etc.)
that have something other than para as a child.

The numbered-with-hanging-indent formatting that's used for
rendering endnotes in the NOTES section of man pages places some
limits/assumptions on how the DocBook source is marked up; namely,
for notesources (footnote, annotation, etc.) that can contain
block-level children, if the they have a block-level child such as
a table or itemizedlist or orderedlist that is the first child of
a footnote, we have no way of rendering/indenting its content
properly in the endnotes list.

Thus, the manpages stylesheet not emits a warning message for that
case, and suggests the "fix" (which is to wrap the table or
itemizedlist or whatever in a para that has some preferatory text.
xsl/manpages/endnotes.xsl