groff 1.23.0 has difficulty with hyphenating a number of the entries in
the name column of these tables when rendering in 80-column terminals.
Setting a minimum width for this column gives it an easier time.

Reported-by: Lucas Nussbaum <lu...@debian.org>
Reported-at: https://bugs.debian.org/1042358
Signed-off-by: Colin Watson <cjwat...@ubuntu.com>
---
 build-aux/extract-ofp-fields | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/build-aux/extract-ofp-fields b/build-aux/extract-ofp-fields
index 808c6527d..449885981 100755
--- a/build-aux/extract-ofp-fields
+++ b/build-aux/extract-ofp-fields
@@ -322,7 +322,11 @@ def group_xml_to_nroff(group_node, fields):
         '.SS "Summary:"\n',
         ".TS\n",
         "tab(;);\n",
-        "l l l l l l l.\n",
+        # Hardcoding a width of 15 ens is a bit of a hack, but it's wide
+        # enough to avoid causing troff difficulty with hyphenating long
+        # identifiers, while still looking reasonable when formatted in wide
+        # terminals.
+        "lw15 l l l l l l.\n",
         "Name;Bytes;Mask;RW?;Prereqs;NXM/OXM?\n",
         "\_;\_;\_;\_;\_;\_\n",
     ]
-- 
2.39.2

_______________________________________________
dev mailing list
d...@openvswitch.org
https://mail.openvswitch.org/mailman/listinfo/ovs-dev

Reply via email to