[groff] 06/09: man/groff_diff.7.man: Document \k( and \k[].

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit acb8c3521bc034584e2d2234123d1a3c9a86a9d2
Author: G. Branden Robinson <address@hidden>
AuthorDate: Thu Apr 30 06:11:29 2020 +1000

    man/groff_diff.7.man: Document \k( and \k[].
    
    Document the '(' and '[]' forms of the \k escape.  The presence of '\k('
    as a groff difference is not an error; CSTR #54 does not admit this
    syntax form.
    
    man/groff.7.man: Synchronize \k description wording with groff_diff(7).
    Also eliminate '\~\c' antipattern (when not needed in an input trap) in
    favor of better macro usage.
---
 man/groff.7.man      | 11 ++++++-----
 man/groff_diff.7.man |  9 +++++++++
 2 files changed, 15 insertions(+), 5 deletions(-)

diff --git a/man/groff.7.man b/man/groff.7.man
index f53ba9b..b9a1eb5 100644
--- a/man/groff.7.man
+++ b/man/groff.7.man
@@ -3201,18 +3201,19 @@ Set height of current font to
 .
 .TP
 .ESC k r
-Mark horizontal input place in one-character register\~\c
+Mark horizontal position in one-character
+.RI register\~ r .
 .IR r .
 .
 .TP
 .ESC k( rg
-Mark horizontal input place in two-character register
-.IR rg .
+Mark horizontal position in two-character
+.RI register\~ rg .
 .
 .TP
 .ESC[] k reg
-Mark horizontal input place in register with arbitrarily long name
-.IR reg .
+Mark horizontal position in register with arbitrarily long
+.RI name\~ reg .
 .
 .TP
 .ESCq l Nc
diff --git a/man/groff_diff.7.man b/man/groff_diff.7.man
index dd24883..ca0d26e 100644
--- a/man/groff_diff.7.man
+++ b/man/groff_diff.7.man
@@ -382,6 +382,15 @@ switches back to the previous font family (note that
 won't work; it selects font family \[oq]P\[cq] instead).
 .
 .TP
+.BI \[rs]k( rg
+.TQ
+.BI \[rs]k[ reg ]
+Mark horizontal position in register with two-character
+.RI name\~ rg
+or arbitrarily long
+.RI name\~ reg .
+.
+.TP
 .BI \[rs]m x
 .TQ
 .BI \[rs]m( xx