From: Jeff King <peff@peff.net>
Date: Fri, 12 Aug 2016 07:10:27 GMT
Subject: Re: [PATCH v5 04/12] doc: revisions: give headings for the two and three dot notations
Message-ID: <20160812071026.gkpyxksl2kr3zhlv@sigill.intra.peff.net>
In-Reply-To: <20160812070749.2920-5-philipoakley@iee.org>

On Fri, Aug 12, 2016 at 08:07:41AM +0100, Philip Oakley wrote:

> We do not quote the notation within the headings as the asciidoc ->
> docbook -> groff man viewer toolchain, particularly the docbook-groff
> step, does not cope with two font changes, failing to return the heading
> font to bold after the quotation of the notation.
> [...]
> The docbook folks have confirmed that \fP would only work across one
> level, so they cannot use it for their XSLT conversion which must be
> multi-level, so they always return to the default font.

Thanks for digging into the root cause. I think your workaround (to
avoid quoted bits in headers) is reasonable, and a rule we can keep in
mind for future patches.

-Peff