[groff] 07/12: src/preproc/tbl/table.cpp: Update comments.

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit 095bc02c953bc7dae01f20ffca1848d8bb28aa6a
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Wed Nov 17 07:09:06 2021 +1100

    src/preproc/tbl/table.cpp: Update comments.
    
    Better explain what we're protecting from interpretation by eqn(1).
---
 src/preproc/tbl/table.cpp | 8 +++++---
 1 file changed, 5 insertions(+), 3 deletions(-)

diff --git a/src/preproc/tbl/table.cpp b/src/preproc/tbl/table.cpp
index 46f1c1c..435ac6b 100644
--- a/src/preproc/tbl/table.cpp
+++ b/src/preproc/tbl/table.cpp
@@ -1855,7 +1855,7 @@ void table::init_output()
           ".in 0\n"
           ".\\}\n"
           "..\n"
-          // protect # in macro name against eqn
+          // Protect '#' in macro name from being interpreted by eqn.
           ".ig\n"
           ".EQ\n"
           "delim off\n"
@@ -2170,7 +2170,8 @@ void table::compute_expand_width()
   prints(".if \\n[" EXPAND_REG "]<0 \\{\\\n");
   entry_list->set_location();
   if (!(flags & NOWARN)) {
-    // protect ` and ' in warning message against eqn
+    // Protect characters in diagnostic message (especially :, [, ])
+    // from being interpreted by eqn.
     prints(".ig\n"
           ".EQ\n"
           "delim off\n"
@@ -2222,7 +2223,8 @@ void table::compute_separation_factor()
   prints(".ie \\n[" SEPARATION_FACTOR_REG "]<=0 \\{\\\n");
   entry_list->set_location();
   if (!(flags & NOWARN)) {
-    // protect ` and ' in warning message against eqn
+    // Protect characters in diagnostic message (especially :, [, ])
+    // from being interpreted by eqn.
     prints(".ig\n"
           ".EQ\n"
           "delim off\n"