[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[groff] 69/72: doc/groff.texi: Recast introduction to chapter 3.
From: |
G. Branden Robinson |
Subject: |
[groff] 69/72: doc/groff.texi: Recast introduction to chapter 3. |
Date: |
Sun, 23 Oct 2022 22:25:48 -0400 (EDT) |
gbranden pushed a commit to branch master
in repository groff.
commit 288962aee78faf3cde41c6d37b0e79065e41939e
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Sun Oct 23 19:44:50 2022 -0500
doc/groff.texi: Recast introduction to chapter 3.
---
doc/groff.texi | 12 ++++++++----
1 file changed, 8 insertions(+), 4 deletions(-)
diff --git a/doc/groff.texi b/doc/groff.texi
index 7a8af6828..44e255871 100644
--- a/doc/groff.texi
+++ b/doc/groff.texi
@@ -1712,10 +1712,14 @@ are equivalent.
@cindex user's tutorial for macros
@cindex user's macro tutorial
-Most users tend to use a macro package to format their papers. This
-means that the whole breadth of @code{groff} is not necessary for most
-people. This chapter covers the material needed to efficiently use a
-macro package.
+Most users of the @code{roff} language employ a macro package to format
+their documents. Successful macro packages tend to ease the composition
+process; their users need not have mastered the full formatting
+language, nor even some of its major features like diversions, traps,
+and environments. A familiarity with some basic concepts and mechanisms
+common to macro packages (like ``displays'') remains helpful; this
+chapter aims to bring you to this level. If you prefer a meticulous and
+comprehensive presentation, try @ref{gtroff Reference} instead.
@menu
* Basics::
[Prev in Thread] |
Current Thread |
[Next in Thread] |
- [groff] 69/72: doc/groff.texi: Recast introduction to chapter 3.,
G. Branden Robinson <=