2
0
mirror of https://github.com/openvswitch/ovs synced 2025-09-05 00:35:33 +00:00

docs: handle multi line headers for nroff

Before the fix, headers split into multiple lines were producing bogus
quote characters in nroff output and failed to indent headers properly.

Specifically, it fixes a header and its indentation in
ovn-architecture(7).

Signed-off-by: Ihar Hrachyshka <ihrachys@redhat.com>
Signed-off-by: Ben Pfaff <blp@ovn.org>
This commit is contained in:
Ihar Hrachyshka
2020-02-13 12:27:27 -05:00
committed by Ben Pfaff
parent c724012970
commit 3865b07409

View File

@@ -290,6 +290,11 @@ fillval = .2
\\}"""
def flatten_header(s):
s = s.strip()
return re.sub(r'\s+', ' ', s)
def block_xml_to_nroff(nodes, para='.PP'):
HEADER_TAGS = ('h1', 'h2', 'h3', 'h4')
s = ''
@@ -373,7 +378,9 @@ def block_xml_to_nroff(nodes, para='.PP'):
to_upper = node.tagName == 'h1'
s += ".%s \"" % nroffTag
for child_node in node.childNodes:
s += inline_xml_to_nroff(child_node, font, to_upper)
s += flatten_header(
inline_xml_to_nroff(child_node, font, to_upper)
)
s += "\"\n"
elif node.tagName == 'pre':
fixed = node.getAttribute('fixed')