On 5 January 2017 at 17:08, Ben Pfaff <[email protected]> wrote:
> On Thu, Jan 05, 2017 at 03:48:22PM -0800, Joe Stringer wrote:
>> When XML is used for writing manpages, the nroff python utility indents
>> the <dd> tags 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.
>>
>> Signed-off-by: Joe Stringer <[email protected]>
>
> I've found that there are landmines in this area.  Did you look around
> at a few manpages to make sure that this doesn't cause funny behavior in
> some cases, in situations like multiple paragraphs in <dd>s, or <dl>s
> nested in <ul>s or vice versa, etc.?

Looks like it does cause trouble with these.

What I was trying to achieve, was that if the <dl> is directly nested
under a toplevel header (that is, 'h1'), it should only indent one
level rather than two.

You're right, this version breaks a bunch of other cases; let me
revise to make it only take effect in this case I'd like to fix.
_______________________________________________
dev mailing list
[email protected]
https://mail.openvswitch.org/mailman/listinfo/ovs-dev

Reply via email to