[groff] 23/78: groff(7): Add "Punning names" section.

[G. Branden Robinson]

gbranden pushed a commit to branch branden-2023-04-07
in repository groff.

commit a333d4c64380a3acd0a8cff718a3ecf6676d31cd
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Sat Apr 1 14:24:28 2023 -0500

    groff(7): Add "Punning names" section.
    
    We have a "Diversions" section for it to follow now.
---
 man/groff.7.man | 52 +++++++++++++++++++++++++++-------------------------
 1 file changed, 27 insertions(+), 25 deletions(-)

diff --git a/man/groff.7.man b/man/groff.7.man
index 04afc7daf..9f9bf46c0 100644
--- a/man/groff.7.man
+++ b/man/groff.7.man
@@ -5363,31 +5363,6 @@ and aliasing
 .\" END Keep (roughly) parallel with groff.texi node "Strings".
 .
 .
-.\" We don't have a "Diversions" section for this to follow yet.  When
-.\" we do, it should become part of a "Punning Names" section.  See
-.\" groff.texi.
-.ig
-.P
-Macros,
-strings,
-and diversions share a name space;
-see section \[lq]Identifiers\[rq] above.
-.
-Internally,
-the same mechanism is used to store them.
-.
-You can thus call a macro with string interpolation syntax and vice
-versa.
-.
-Interpolating a string does not hide existing macro arguments.
-.
-The sequence
-.B \[rs]\[rs]
-can be placed at the end of a line in a macro definition or,
-within a macro definition,
-immediately after the interpolation of a macro as a string to suppress
-the effect of a newline.
-..
 .
 .
 .\" ====================================================================
@@ -6821,6 +6796,33 @@ requests reprocess diversions.
 .
 .
 .\" ====================================================================
+.SH "Punning names"
+.\" ====================================================================
+.
+.\" BEGIN Keep (roughly) parallel with groff.texi node "Punning names".
+Macros,
+strings,
+and diversions share a name space;
+see section \[lq]Identifiers\[rq] above.
+.
+Internally,
+the same mechanism is used to store them.
+.
+You can thus call a macro with string interpolation syntax and vice
+versa.
+.
+Interpolating a string does not hide existing macro arguments.
+.
+The sequence
+.B \[rs]\[rs]
+can be placed at the end of a line in a macro definition or,
+within a macro definition,
+immediately after the interpolation of a macro as a string to suppress
+the effect of a newline.
+.\" END Keep (roughly) parallel with groff.texi node "Punning names".
+.
+.
+.\" ====================================================================
 .SH Environments
 .\" ====================================================================
 .