gbranden pushed a commit to branch master
in repository groff.
commit 1d281b39d0d7016b8c3e94bca22330b0f436b671
Author: G. Branden Robinson <[email protected]>
AuthorDate: Wed Aug 23 03:29:40 2023 -0500
doc/groff.texi: Tweak tutorial chapter.
* Associate trap usage with full-service macro packages.
* Format man page cross references correctly.
* Speak more carefully about which packages provide font macros.
* Present something else that full-service packages do with preprocessor
tokens--prepare captions.
---
doc/groff.texi | 24 ++++++++++++------------
1 file changed, 12 insertions(+), 12 deletions(-)
diff --git a/doc/groff.texi b/doc/groff.texi
index 932dee1e7..529e83a38 100644
--- a/doc/groff.texi
+++ b/doc/groff.texi
@@ -1929,8 +1929,8 @@ performed. These common tasks are grouped into
@slanted{macros}, which
are then collected into a @slanted{macro package}.
Macro packages come in two varieties:@: ``major'' or ``full-service''
-ones that manage page layout, and ``minor'' or ``auxiliary'' ones that
-do not, instead fulfilling narrow, specific tasks. Find a list in
+ones that manage page layout with traps, and ``minor'' or ``auxiliary''
+ones that do not, but fulfill narrower purposes. Find a list in
@cite{groff_tmac@r{(5)}}.
We present several capabilities of full-service macro packages below.
@@ -2133,8 +2133,8 @@ pages at the time the document is rendered; see
@cite{gropdf@r{(1)}}.
An index is similar to a table of contents, in that entry labels and
locations must be collected, but poses a greater challenge because it
needs to be sorted before it is output. Here, processing the document
-in multiple passes is inescapable, and tools like the @code{makeindex}
-program are necessary.
+in multiple passes is inescapable, and tools like the
+@cite{makeindex@r{(1)}} program are necessary.
@c ---------------------------------------------------------------------
@@ -2162,10 +2162,10 @@ formatting offer a facility for setting multiple
columns on the page.
@subsection Font and Size Changes
The formatter's requests and escape sequences for setting the typeface
-and size are not always intuitive in their behavior, so all packages
-provide macros to simplify input of these operations. They can also
-make mid-word font style changes more convenient, and can handle italic
-corrections automatically. @xref{Italic Corrections}.
+and size are not always intuitive in their behavior, so all full-service
+packages provide macros to simplify input of these operations. They can
+also make mid-word font style changes more convenient, and can handle
+italic corrections automatically. @xref{Italic Corrections}.
@c ---------------------------------------------------------------------
@@ -2181,10 +2181,10 @@ the date, or to perform operations like super- and
subscripting.
@subsection Preprocessor Support
All macro packages provide support for various preprocessors and may
-extend their functionality by defining macros to set their contents in
-displays. Examples include @code{TS} and @code{TE} for @command{gtbl},
-@code{EQ} and @code{EN} for @command{geqn}, and @code{PS} and @code{PE}
-for @command{gpic}.
+extend their functionality by defining macros to caption them and/or set
+their contents in displays. Examples include @code{TS} and @code{TE}
+for @command{gtbl}, @code{EQ} and @code{EN} for @command{geqn}, and
+@code{PS} and @code{PE} for @command{gpic}.
@c ---------------------------------------------------------------------
_______________________________________________
Groff-commit mailing list
[email protected]
https://lists.gnu.org/mailman/listinfo/groff-commit
