[ovs-dev] [PATCHv2] python: Fix nroff indentation for <dl> after <h1>.

Joe Stringer joe at ovn.org
Fri Jan 6 20:41:20 UTC 2017


On 5 January 2017 at 20:16, Ben Pfaff <blp at ovn.org> wrote:
> On Thu, Jan 05, 2017 at 06:09:35PM -0800, Joe Stringer wrote:
>> When XML is used for writing manpages, in the case that there is a <h1>
>> tag followed by <dl>, the nroff python utility indents the <dl> tag (and
>> children) an extra level which is unnecessary and makes the formatting
>> inconsistent between manpages written directly in nroff vs manpages
>> written in XML and converted to nroff. Fix the indentation by removing
>> the extraneous .RS / .RE tags added to generated nroff in this case.
>>
>> This fixes the formatting of ovn/utilities/ovn-nbctl.8 man page.
>>
>> Signed-off-by: Joe Stringer <joe at ovn.org>
>
> nroff sucks so much.
>
> I suspect that this should actually apply to all h*, not just to h1.
> None of the headings imply indentation.
>
> Acked-by: Ben Pfaff <blp at ovn.org>

I updated this to work the same for all headers, and pushed to master. Thanks.


More information about the dev mailing list