[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[groff] 01/01: Correctly explain the history of the man(7) macros.
From: |
Ingo Schwarze |
Subject: |
[groff] 01/01: Correctly explain the history of the man(7) macros. |
Date: |
Thu, 29 Oct 2020 07:07:42 -0400 (EDT) |
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.
[Prev in Thread] |
Current Thread |
[Next in Thread] |
- [groff] 01/01: Correctly explain the history of the man(7) macros.,
Ingo Schwarze <=