[groff] 06/11: [me]: Clarify breadth of application of `ll` macro.

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit a61cd74ad38b7948f63784ae1373e572fcf12292
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Fri Aug 13 10:22:43 2021 +1000

    [me]: Clarify breadth of application of `ll` macro.
    
    * doc/meref.me: Document application of .ll macro only to the 3
      environments that me(7) uses, not any the user might create.
    * tmac/e.tmac (@C, xl, ll): Update comments.
    
    Fixes <https://savannah.gnu.org/bugs/?55060>.
---
 ChangeLog    | 10 ++++++++++
 doc/meref.me | 19 +++++++++++++++++--
 tmac/e.tmac  |  6 +++---
 3 files changed, 30 insertions(+), 5 deletions(-)

diff --git a/ChangeLog b/ChangeLog
index 524f4e0..de87665 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,5 +1,15 @@
 2021-08-13  G. Branden Robinson <g.branden.robinson@gmail.com>
 
+       [me]: Clarify breadth of application of `ll` macro.
+
+       * doc/meref.me: Document application of .ll macro only to the 3
+       environments that me(7) uses, not any the user might create.
+       * tmac/e.tmac (@C, xl, ll): Update comments.
+
+       Fixes <https://savannah.gnu.org/bugs/?55060>.
+
+2021-08-13  G. Branden Robinson <g.branden.robinson@gmail.com>
+
        * tmac/e.tmac (1c): Fix problem when combining multiple columns,
        footnotes, and return to single-column mode: do not place the
        single-column text below the footnote.  Space to the end of the
diff --git a/doc/meref.me b/doc/meref.me
index ca69009..4e675b8 100644
--- a/doc/meref.me
+++ b/doc/meref.me
@@ -1621,10 +1621,25 @@ because it only affects the current environment.
 .b .ll
 .i +N
 .DE
-Set line length in all environments
+Set line length in all environments used by
+.i me
 to
 .i N
-[6.0i].
+[6.0i].\**
+.(f
+\**
+.i me
+uses only the three environments of AT&T
+.i troff ,
+but in GNU
+.i troff ,
+the user can create additional ones.
+.
+.b .ll
+works like
+.b .xl
+for the latter.
+.)f
 This should not be used
 after output has begun,
 and particularly not in two-column output.
diff --git a/tmac/e.tmac b/tmac/e.tmac
index 5b39588..e27d514 100644
--- a/tmac/e.tmac
+++ b/tmac/e.tmac
@@ -113,7 +113,7 @@
 .\"            *** INTERNAL GP MACROS ***
 .
 .
-.de @C                 \" --- change ev's, taking info with us
+.de @C                 \" --- change environments, taking info with us
 .nr _S \\n(.s
 .nr _V \\n(.v
 .nr _F \\n(.f
@@ -514,10 +514,10 @@
 ..
 .
 .rn ll xl              \" *** special line length (local)
-.de ll                 \" *** line length (global to environments)
+.de ll
 .xl \\$1
 .lt \\$1
-.nr $l \\n(.l
+.nr $l \\n(.l          \" *** line length (copied among ev 0, 1, and 2)
 .if (\\n($m<=1):(\\n($l>\\n(_L) \
 .      nr _L \\n(.l
 ..