[Top][All Lists]

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

[groff] 30/31: groff(1) (Macro packages): Revise.

From: G. Branden Robinson
Subject: [groff] 30/31: groff(1) (Macro packages): Revise.
Date: Sun, 25 Jul 2021 02:39:53 -0400 (EDT)

gbranden pushed a commit to branch master
in repository groff.

commit 1e6f72643b7a65835a128250a313131a9cc0d8be
Author: G. Branden Robinson <>
AuthorDate: Sun Jul 25 16:05:18 2021 +1000

    groff(1) (Macro packages): Revise.
    * Recast introduction, explaining what macro packages are (some language
      is lifted/lightly adapted from groff_tmac(5)).
    * Recast to make it more clear that (except for "me"), our macro
      packages are independently implemented.
 src/roff/groff/ | 34 ++++++++++++++++++++++------------
 1 file changed, 22 insertions(+), 12 deletions(-)

diff --git a/src/roff/groff/ b/src/roff/groff/
index 8d759df..a5b2381 100644
--- a/src/roff/groff/
+++ b/src/roff/groff/
@@ -982,15 +982,28 @@ it is run before any other preprocessors.
 .SS "Macro packages"
 .\" ====================================================================
-Macro packages can be loaded prior to a
+Macro files are
 .I roff
-input document by using the option
-.BR \-m .
+input files designed to produce no output themselves but instead ease
+the preparation of other
+.I roff
+When a macro file is installed at a standard location and suitable for
+use by a general audience,
+it is termed a macro package.
+Macro packages can be loaded prior to any
+.I roff
+input documents with the
+.BR \-m \~option.
 .I groff
 system implements most well-known macro packages for AT&T
-.I troff
+.I troff \" AT&T
 .\" exceptions: mpm, mv
 in a compatible way,
 extends them,
@@ -1024,7 +1037,7 @@ Macro packages serve a variety of purposes.
 Some are \[lq]full-service\[rq] packages,
 adopting responsibility for page layout among other fundamental tasks,
 and defining their own lexicon of macros for document composition;
-each of these stands alone and a given document can use at most one.
+each such package stands alone and a given document can use at most one.
 .I roff
@@ -1055,8 +1068,7 @@ It can be specified on the command line as
 .I e
-is the Berkeley general-purpose
-document formatter,
+is the Berkeley general-purpose macro suite,
 developed as an alternative to AT&T's
 .IR s ;
@@ -1068,8 +1080,8 @@ It can be specified on the command line as
 .I m
-is the second-generation AT&T general-purpose
-document formatter,
+implements the format used by the
+second-generation AT&T macro suite for general documents,
 a successor to
 .IR s ;
@@ -1099,9 +1111,7 @@ takes the female pronoun\[em]can be specified on the 
command line as
 .I s
-is the original AT&T general-purpose
-.I ms
-document formatter;
+is the original AT&T general-purpose document format;
 .IR groff_ms (@MAN7EXT@).

reply via email to

[Prev in Thread] Current Thread [Next in Thread]