[groff] 01/05: [tbl]: Annotate generated output more.

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit 456b672f5f1a45fc6e9def883e7d00de0f362fdb
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Fri Dec 29 22:13:18 2023 -0600

    [tbl]: Annotate generated output more.
    
    * src/preproc/tbl/table.cpp (table::compute_overall_width): Document the
      nroff-mode workarounds we do in *roff comments in the generated
      output.
---
 ChangeLog                 | 6 ++++++
 src/preproc/tbl/table.cpp | 6 ++++--
 2 files changed, 10 insertions(+), 2 deletions(-)

diff --git a/ChangeLog b/ChangeLog
index 3aea5a8ae..57d3f82fd 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,9 @@
+2023-12-29  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+       * src/preproc/tbl/table.cpp (table::compute_overall_width):
+       Document the nroff-mode workarounds we do in *roff comments in
+       the generated output.
+
 2023-12-29  G. Branden Robinson <g.branden.robinson@gmail.com>
 
        * tmac/an.tmac (an-end): Horizontal rules in nroff mode _always_
diff --git a/src/preproc/tbl/table.cpp b/src/preproc/tbl/table.cpp
index e5b7125c6..0c73a9005 100644
--- a/src/preproc/tbl/table.cpp
+++ b/src/preproc/tbl/table.cpp
@@ -2205,9 +2205,11 @@ void table::compute_overall_width()
   prints(".\\\" compute overall width\n");
   if (!(flags & GAP_EXPAND)) {
     if (left_separation)
-      printfs(".if n .ll -%1n\n", as_string(left_separation));
+      printfs(".if n .ll -%1n \\\" left separation\n",
+             as_string(left_separation));
     if (right_separation)
-      printfs(".if n .ll -%1n\n", as_string(right_separation));
+      printfs(".if n .ll -%1n \\\" right separation\n",
+             as_string(right_separation));
   }
   // Compute the amount of horizontal space available for expansion,
   // measuring every column _including_ those eligible for expansion.