[groff] 20/39: doc/groff.texi: Recast and expand front matter.

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit c500e45805089cee057948d1f095fe4b69140dd2
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Mon May 30 12:02:32 2022 -0500

    doc/groff.texi: Recast and expand front matter.
---
 doc/groff.texi | 11 +++++++----
 1 file changed, 7 insertions(+), 4 deletions(-)

diff --git a/doc/groff.texi b/doc/groff.texi
index e2ba96a7..87d381ab 100644
--- a/doc/groff.texi
+++ b/doc/groff.texi
@@ -815,6 +815,10 @@ omitting the name of the program issuing them, the input 
file name, and
 line number or other positional information when such data do not serve
 to illuminate the topic under discussion.
 
+Most examples are of @code{roff} language input that would be placed in
+a text file.  Occasionally, we start an example with a @samp{$}
+character to indicate a shell prompt, as seen above.
+
 You are encouraged to try the examples yourself, and to alter them to
 better learn @code{groff}'s behavior.  Our examples frequently need to
 direct the formatter to set a line length (with @samp{.ll}) that will
@@ -829,11 +833,10 @@ formally.@footnote{@xref{Line Layout}.}
 @section Credits
 @cindex credits
 
-Large portions of this manual were taken from existing documents, most
+Large portions of this manual were taken from existing documents---most
 notably, the manual pages for the @code{groff} package by James Clark,
-and Eric Allman's papers on the @file{me} macro package.
-
-Larry Kollar contributed the section on the @file{ms} macro package.
+and Eric Allman's papers on the @file{me} macro package.  Larry Kollar
+contributed much of the material on the @file{ms} macro package.
 
 
 @c =====================================================================