[groff] 01/01: Correctly explain the history of the man(7) macros.

[Ingo Schwarze]

schwarze pushed a commit to branch master
in repository groff.

commit 4ffc06ce7e714b952c6699a50ac5a4b596eebc46
Author: Ingo Schwarze <schwarze@openbsd.org>
AuthorDate: Wed Oct 28 22:31:06 2020 +0100

    Correctly explain the history of the man(7) macros.
    
    The original author of these macros is Douglas McIlroy, as shown in:
    https://manpages.bsd.lv/history/mcilroy_26_10_2020.txt
    
    While here, mention that groff has been the dominant roff implementation
    not only for GNU and Linux systems, but also for all BSD systems.
    
    OK gbranden@
---
 ChangeLog               |  4 ++++
 man/roff.7.man          | 38 ++++++++++++++++++++++++--------------
 tmac/groff_man.7.man.in | 10 ++++++++++
 3 files changed, 38 insertions(+), 14 deletions(-)

diff --git a/ChangeLog b/ChangeLog
index 9cd760d..d64f67c 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,7 @@
+2020-10-28  Ingo Schwarze <schwarze@openbsd.org>
+
+       * man/roff.7.man, tmac/groff_man.7.man.in: Correct man(7) history.
+
 2020-10-26  G. Branden Robinson <g.branden.robinson@gmail.com>
 
        Fix ms .R macro to work as documented, by handling its arguments
diff --git a/man/roff.7.man b/man/roff.7.man
index fa22031..523b857 100644
--- a/man/roff.7.man
+++ b/man/roff.7.man
@@ -249,7 +249,6 @@ to turn on fill mode got the name it retains to this day.
 .SS "Unix and roff"
 .\" ====================================================================
 .
-.P
 By 1971,
 McIlroy's
 .I runoff
@@ -400,6 +399,26 @@ and programmable abort
 .
 .
 .P
+A small and simple set of macros was first used for the manual pages of
+Version 4 Unix (November 1973) and remained in use until Version 6, but
+the first macro package to be formally installed as a library were the
+.I ms
+macros by Michael Lesk (/usr/lib/tmac.s) in Version 6 Unix (May 1975).
+For Version 7 Unix (January 1979), Douglas McIlroy designed,
+implemented, and documented the
+.I man
+macro package, introducing most of the macros still present in
+.IR groff_man (7)
+today, and edited volume 1 of the Version 7 manual using these
+macros.
+While the earlier manual page macros used for Version 4 to 6
+were abandoned, the
+.I ms
+macros remained in use for most of Volume 2 of the manual,
+which contained a wealth of supplementary documents.
+.
+.
+.P
 Third Edition Unix had also brought the
 .IR pipe (2)
 system call,
@@ -491,19 +510,6 @@ and all subsequent implementors of
 systems have done so in its shadow.
 .
 .
-.P
-In 1979,
-Seventh Edition Unix added the
-.I man
-macro package to the existing
-.I ms
-macros,
-the former by Lesk and the latter (possibly) by McIlroy.
-.
-Between them the system was comprehensively documented,
-with the man pages on-line and in Volume 1 and a wealth of supplementary
-documents in Volume 2.
-.
 .\" XXX GBR leaves off here
 .P
 After Ossanna's death in 1977,
@@ -577,6 +583,10 @@ See
 .BR groff (@MAN1EXT@)
 for an overview.
 .
+From its outset and for at least the following three decades,
+it has been used by practically all GNU/Linux and BSD
+operating systems.
+.
 .
 .P
 The
diff --git a/tmac/groff_man.7.man.in b/tmac/groff_man.7.man.in
index a0fa99c..b178ce0 100644
--- a/tmac/groff_man.7.man.in
+++ b/tmac/groff_man.7.man.in
@@ -3400,6 +3400,16 @@ _endif()dnl
 .SH Authors
 .\" ====================================================================
 .
+.MT m.douglas.mcilroy@dartmouth.edu
+Douglas McIlroy
+.ME
+designed and implemented the original version of these macros,
+wrote the original version of this manual page,
+and was the first to use them when he edited
+volume 1 of the Version 7 AT&T UNIX manual.
+.
+.
+.PP
 The GNU version of the
 .I man
 macro package was written by James Clark and contributors.