[groff] 19/38: [man]: Clarify comments.

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit 8dba3087a4a99ab31210e837bd1cc0a8f639c5f6
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Wed Mar 20 11:16:22 2024 -0500

    [man]: Clarify comments.
    
    * tmac/an-ext.tmac:
    * tmac/an.tmac: Do it.
---
 tmac/an-ext.tmac | 5 ++++-
 tmac/an.tmac     | 4 ++--
 2 files changed, 6 insertions(+), 3 deletions(-)

diff --git a/tmac/an-ext.tmac b/tmac/an-ext.tmac
index 44af47db9..80186ce22 100644
--- a/tmac/an-ext.tmac
+++ b/tmac/an-ext.tmac
@@ -154,7 +154,10 @@
 .de TQ
 .  br
 .  ns
-.  TP \\$1\" We do not quote the argument, so that the caller can.
+.  \" Do not quote the argument to `TP`; the user might specify
+.  \" their own, for multi-word tags or to exercise AT&T troff quoting
+.  \" rules.
+.  TP \\$1\"
 ..
 .
 .
diff --git a/tmac/an.tmac b/tmac/an.tmac
index 3cfdc2a84..2b3682408 100644
--- a/tmac/an.tmac
+++ b/tmac/an.tmac
@@ -170,8 +170,8 @@
 .de an-reset-paragraph-spacing
 .  ie \\n[.$] .nr PD (v;\\$1)
 .  el         .nr PD (.4v >? \n[.V])
-.  \" Restore spacing to handle a "belated" call immediately after a
-.  \" paragraphing macro (`P`, `HP`, or `IP` with no marker argument).
+.  \" Restore spacing to handle a "belated" `PD` call immediately after
+.  \" a paragraphing macro (`P`, `HP`, or `IP` with no marker argument).
 .  rs
 ..
 .