[groff] 07/40: [docs]: Update introductory explanation of groff.

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit 0189723a11e2ef39d4a6ded94ea65dd0ddeaca2d
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Sun Nov 6 05:01:49 2022 -0600

    [docs]: Update introductory explanation of groff.
---
 doc/groff.texi             | 23 ++++++++++++++++++++++-
 src/roff/groff/groff.1.man | 39 +++++++++++++++++++++++++++++++++++----
 2 files changed, 57 insertions(+), 5 deletions(-)

diff --git a/doc/groff.texi b/doc/groff.texi
index e2e0dd41d..b41cc466a 100644
--- a/doc/groff.texi
+++ b/doc/groff.texi
@@ -468,7 +468,7 @@ developing GNU and promoting software freedom.''
 @title groff
 @subtitle The GNU implementation of @code{troff}
 @subtitle Edition 1.23.0
-@subtitle October 2022
+@subtitle November 2022
 @author Trent@tie{}A.@: Fisher
 @author Werner Lemberg
 @author G.@tie{}Branden Robinson
@@ -586,6 +586,27 @@ man page.
 @cindex what is @code{groff}?
 @cindex @code{groff}---what is it?
 
+@c BEGIN Keep parallel with groff(1), section "Description" (after the
+@c first sentence).
+@c This language is slightly expanded from that in the "ANNOUNCE" file
+@c and on the groff home page.
+@code{groff} (GNU @code{roff}) is a typesetting system that reads plain
+text input files that include formatting commands to produce output in
+PostScript, PDF, HTML, DVI, or other formats, or for display to a
+terminal.  Formatting commands can be low-level typesetting primitives
+or macros from a supplied package.  Users may also write their own
+macros.  All three approaches can be combined.
+
+A reimplementation and extension of the typesetter from @acronym{AT&T}
+Unix, @code{groff} is present on most @acronym{POSIX} systems owing to
+its long association with Unix manuals (including man pages).  It and
+its predecessor are notable for their production of several best-selling
+software engineering texts.  @code{groff} is capable of producing
+typographically sophisticated documents while consuming minimal system
+resources.
+@c END Keep parallel with groff(1), section "Description" (after the
+@c first sentence).
+
 @code{groff} belongs to an older generation of document preparation
 systems, which operate more like compilers than the more recent
 interactive @acronym{WYSIWYG}@footnote{What You See Is What You Get}
diff --git a/src/roff/groff/groff.1.man b/src/roff/groff/groff.1.man
index e90c1243b..cee36c87e 100644
--- a/src/roff/groff/groff.1.man
+++ b/src/roff/groff/groff.1.man
@@ -9,7 +9,7 @@ document formatting system
 .\" Legal Terms
 .\" ====================================================================
 .\"
-.\" Copyright (C) 1989-2021 Free Software Foundation, Inc.
+.\" Copyright (C) 1989-2022 Free Software Foundation, Inc.
 .\"
 .\" This file is part of groff, the GNU roff type-setting system.
 .\"
@@ -108,13 +108,44 @@ is the primary front end to the GNU
 .I roff
 document formatting system.
 .
+.\" BEGIN Keep parallel with groff.texi node "What Is groff?".
+.\" This language is slightly expanded from that in the "ANNOUNCE" file
+.\" and on the groff home page.
 GNU
 .I roff
-transforms text input files into typeset output in a variety of formats,
-such as PDF and HTML.
+is a typesetting system that reads plain text input files that include
+formatting commands to produce output in PostScript,
+PDF,
+HTML,
+DVI,
+or other formats,
+or for display to a terminal.
+.
+Formatting commands can be low-level typesetting primitives or macros
+from a supplied package.
+.
+Users may also write their own macros.
+.
+All three approaches may be combined.
+.
+.
+.P
+A reimplementation and extension of the typesetter from AT&T Unix,
+.I groff
+is present on most POSIX systems owing to its long association with Unix
+manuals
+(including man pages).
+.
+It and its predecessor are notable for their production of several
+best-selling software engineering texts.
+.
+.I groff
+is capable of producing typographically sophisticated documents while
+consuming minimal system resources.
+.\" END Keep parallel with groff.texi node "What Is groff?".
 .
-It is also used to format man pages for viewing on terminals.
 .
+.P
 The
 .I groff
 command orchestrates the execution of preprocessors,