[groff] 07/09: doc/groff.texi: Comment out ms "Bell localisms".

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit 15f8e92da319d853c7583b1288542f5fff5a05d9
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Wed Mar 3 16:59:56 2021 +1100

    doc/groff.texi: Comment out ms "Bell localisms".
    
    * doc/groff.texi (Differences from AT&T ms): Comment out paragraphs
      discussing groff ms emulation of purportedly undocumented Bell Labs ms
      macros used in the Kernighan & Cherry eqn paper.  It looks more like
      the paper used document-private macros which were defined in a
      separate file.  See, for example,
        https://minnie.tuhs.org/cgi-bin/utree.pl?file=32V/usr/doc/eqn/e.mac
      (not to be confused with Eric Allman's "me" package).  Neither V6 ms
      nor V7 ms (which bracket the composition date of the paper), nor any
      later version available at TUHS, features these macro definitions.
---
 doc/groff.texi | 35 ++++++++++++++++++-----------------
 1 file changed, 18 insertions(+), 17 deletions(-)

diff --git a/doc/groff.texi b/doc/groff.texi
index 09975d6..1f64a27 100644
--- a/doc/groff.texi
+++ b/doc/groff.texi
@@ -4228,23 +4228,24 @@ Documents that need to determine whether they are being 
formatted with
 this register.
 @endDefmpreg
 
-Emulations of a few ancient Bell Labs macros can be re-enabled by
-calling the otherwise undocumented @code{SC} section-header macro.
-Calling @code{SC} enables @code{UC} for marking up a product or
-application name, and the pair @code{P1}/@code{P2} for surrounding code
-example displays.
-
-These are not enabled by default because (a)@tie{}they were not
-documented in the original @code{ms} manual@footnote{@slanted{Ibid.}}
-and (b)@tie{}the @code{P1} and @code{UC} macros collide with different
-macros with the same names in the Berkeley version of @code{ms}.
-
-These @code{groff} emulations are sufficient to give back the 1976
-Kernighan@tie{}& Cherry @command{eqn} manual @cite{Typesetting
-Mathematics---User's Guide} its section headings, and restore some text
-that had gone missing as arguments of undefined macros.  No warranty
-express or implied is offered as to how well the typographic details
-these produce match the original Bell Labs macros.
+@c Emulations of a few ancient Bell Labs macros can be re-enabled by
+@c calling the otherwise undocumented @code{SC} section-header macro.
+@c Calling @code{SC} enables @code{UC} for marking up a product or
+@c application name, and the pair @code{P1}/@code{P2} for surrounding
+@c code example displays.
+@c
+@c These are not enabled by default because (a)@tie{}they were not
+@c documented in the original @code{ms} manual@footnote{@slanted{Ibid.}}
+@c and (b)@tie{}the @code{P1} and @code{UC} macros collide with
+@c different macros with the same names in the Berkeley version of
+@c @code{ms}.
+@c
+@c These @code{groff} emulations are sufficient to give back the 1976
+@c Kernighan@tie{}& Cherry @command{eqn} manual @cite{Typesetting
+@c Mathematics---User's Guide} its section headings, and restore some
+@c text that had gone missing as arguments of undefined macros.  No
+@c warranty express or implied is offered as to how well the typographic
+@c details these produce match the original Bell Labs macros.
 
 @menu
 * Missing ms Macros::