[groff] 13/31: [docs]: Revise description of intermediate output.

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit b8c5c8eba30cc1744dbd51c2376c0d25027235ed
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Fri May 28 23:17:01 2021 +1000

    [docs]: Revise description of intermediate output.
    
    * doc/groff.texi (Language Concepts): Rewrite it.
    * man/groff_out.5.man (Description): Adapt same as lead paragraph.
---
 doc/groff.texi      | 22 ++++++++++++++--------
 man/groff_out.5.man | 46 +++++++++++++++++++++++++++++++++-------------
 2 files changed, 47 insertions(+), 21 deletions(-)

diff --git a/doc/groff.texi b/doc/groff.texi
index 81fe513..1287298 100644
--- a/doc/groff.texi
+++ b/doc/groff.texi
@@ -16688,14 +16688,20 @@ used any longer by @code{gtroff}.
 @node Language Concepts, Command Reference, gtroff Output, gtroff Output
 @subsection Language Concepts
 
-During the run of @code{gtroff}, the input data is cracked down to the
-information on what has to be printed at what position on the intended
-device.  So the language of the intermediate output format can be quite
-small.  Its only elements are commands with and without arguments.  In
-this section, the term @dfn{command} always refers to the intermediate
-output language, and never to the @code{gtroff} language used for
-document formatting.  There are commands for positioning and text
-writing, for drawing, and for device controlling.
+The fundamental operation of the GNU @code{troff} formatter is the
+translation of the @code{groff} input language into a device-independent
+form primarily concerned with what has to be written or drawn at
+specific positions on the output device.  This language is simple and
+imperative.  In the following discussion, the term @dfn{command} always
+refers to this intermediate output language, and never to the
+@code{groff} language intended for direct use by document authors.
+Intermediate output commands comprise several categories: glyph output;
+font, color, and text size selection; motion of the printing position;
+page advancement; drawing of geometric primitives; and device control
+commands, a catch-all for operations not easily classified as any of the
+foregoing, such as directives to start and stop output, identify the
+intended output device, or place URL hyperlinks in supported output
+formats.
 
 @menu
 * Separation::
diff --git a/man/groff_out.5.man b/man/groff_out.5.man
index 68867de..fe81462 100644
--- a/man/groff_out.5.man
+++ b/man/groff_out.5.man
@@ -99,19 +99,39 @@ after these commands, otherwise the position is not changed.
 .SH Description
 .\" ====================================================================
 .
-This manual page describes the
-.I intermediate output
-format of the GNU
-.BR roff (@MAN7EXT@)
-text processing system
-.BR groff (@MAN1EXT@).
-.
-This output is produced by a run of the GNU
-.BR @g@troff (@MAN1EXT@)
-program.
-.
-It contains already all device-specific information, but it is not yet
-fed into a device postprocessor program.
+The fundamental operation of the
+.IR \%@g@troff (@MAN1EXT@)
+formatter is the translation of the
+.IR groff (@MAN7EXT@)
+input language into a device-independent form,
+described here,
+primarily concerned with what has to be written or drawn at specific
+positions on the output device.
+.
+This language is simple and imperative.
+.
+In the following discussion,
+the term
+.I command
+always refers to this intermediate output language,
+and never to the
+.IR groff (@MAN7EXT@)
+language intended for direct use by document authors.
+.
+Intermediate output commands comprise several categories:
+glyph output;
+font,
+color,
+and text size selection;
+motion of the printing position;
+page advancement;
+drawing of geometric primitives;
+and device control commands,
+a catch-all for operations not easily classified as any of the
+foregoing,
+such as directives to start and stop output,
+identify the intended output device,
+or place URL hyperlinks in supported output formats.
 .
 .
 .P