groff-commit
[Top][All Lists]
Advanced

[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::



reply via email to

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