gbranden pushed a commit to branch master
in repository groff.
commit 21f234189f937e6fbfd079a849950b05b404ce22
Author: G. Branden Robinson <g.branden.robin...@gmail.com>
AuthorDate: Fri Mar 7 15:28:09 2025 -0600
[doc,man]: Revise intro to output format.
...and sync between our Texinfo manual and groff_out(5) man page.
---
doc/groff.texi.in | 43 +++++++++++++++++++++++++++++--------------
man/groff_out.5.man | 7 ++++---
2 files changed, 33 insertions(+), 17 deletions(-)
diff --git a/doc/groff.texi.in b/doc/groff.texi.in
index 45208643a..ef330e1e1 100644
--- a/doc/groff.texi.in
+++ b/doc/groff.texi.in
@@ -18685,20 +18685,35 @@ were no longer as tight.
@subsection Language Concepts
@c BEGIN Keep parallel with introductory paragraph of groff_out(5).
-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 device-independent output language, and never to the
-@code{groff} language intended for direct use by document authors.
-Device-independent output commands comprise several categories: glyph
-output; font, color, and text size selection; motion of the printing
-position; page advancement; drawing of geometric objects; 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.
+The fundamental operation of the GNU
+@code{troff} @c GNU
+formatter is the translation of the
+@code{groff}
+input language
+into a series of instructions concerned primarily
+with placing glyphs or geometric objects
+at specific positions on a rectangular page.
+In the following discussion,
+the term
+@dfn{command}
+always refers to this device-independent output language,
+and never to the
+@code{groff}
+language intended for direct use by document authors.
+Device-independent output commands comprise several categories:@:
+glyph output;
+font,
+color,
+and text size selection;
+motion of the printing position;
+page advancement;
+drawing of geometric objects;
+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.
@c END Keep parallel with introductory paragraph of groff_out(5).
@menu
diff --git a/man/groff_out.5.man b/man/groff_out.5.man
index 1f5a7094d..3a342a025 100644
--- a/man/groff_out.5.man
+++ b/man/groff_out.5.man
@@ -122,9 +122,10 @@ The fundamental operation of the
.MR @g@troff @MAN1EXT@
formatter is the translation of the
.MR groff @MAN7EXT@
-input language into a series of instructions concerned primarily with
-placing glyphs or geometric objects at specific positions on a
-rectangular page.
+input language
+into a series of instructions concerned primarily
+with placing glyphs or geometric objects
+at specific positions on a rectangular page.
.
In the following discussion,
the term
_______________________________________________
groff-commit mailing list
groff-commit@gnu.org
https://lists.gnu.org/mailman/listinfo/groff-commit
