Bug 312907

I originally reported this as <http://bugs.debian.org/696694>:

Package: valgrind
Version: 1:3.7.0-6
Severity: normal

Dear Maintainer,

This piece of valgrind(1):

,----
| SGCHECK OPTIONS
|        <xi:include></xi:include>.SH "BBV OPTIONS"
`----

which is represented in valgrind.1 as:

,----
| .SH "SGCHECK OPTIONS"
| <xi:include></xi:include>.SH "BBV OPTIONS"
`----

is broken so badly that it screws up the headings.

This is caused by an attempt to XInclude an element which is commented
out, combined with the docbook-xsl manpage stylesheets not handling
failed XIncludes.  Here are the offending passages:

,----[ doc/xml/valgrind-manpage.xml ]
| <refsect1 id="sgcheck-options">
| <title>SGcheck Options</title>
| 
| <xi:include href="../../exp-sgcheck/docs/sg-manual.xml" 
|             xpointer="sg.opts.list"
|             xmlns:xi="http://www.w3.org/2001/XInclude" />
| 
| </refsect1>
`----

,----[ exp-sgcheck/docs/sg-manual.xml ]
| <sect1 id="sg-manual.options" xreflabel="SGCheck Command-line Options">
| <title>SGCheck Command-line Options</title>
| 
| <para>There are no SGCheck-specific command-line options at present.</para>
| <!--
| <para>SGCheck-specific command-line options are:</para>
| 
| 
| <variablelist id="sg.opts.list">
| </variablelist>
| -->
`----


(I reported the problem with docbook-xsl as
<http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=694510> some time ago,
and then forgot to report where I'd actually run into it...)