[ovs-dev] [PATCH] python: Fix nroff indentation for XML <dd>.

Ben Pfaff blp at ovn.org
Fri Jan 6 01:08:35 UTC 2017


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 <joe at ovn.org>

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.?

If the real solution is just to delete two lines then I'm all for it.


More information about the dev mailing list