gbranden pushed a commit to branch master
in repository groff.
commit 44d5c8e0a7b9efb87e73bc8a9516c92e556dda69
Author: G. Branden Robinson <[email protected]>
AuthorDate: Sun Jan 25 21:16:05 2026 -0600
groff_out(5): Delete "Example" section.
It takes up a great deal of real estate for little benefit, in my view.
In the future I hope to revise GNU troff's output for greater
readability (Savannah #63544); I expect that a revision of the
corresponding examples in our Texinfo manual (still present) and
parallelization and of that material with restoration of an "Examples"
section in this man page can then ensue.
---
man/groff_out.5.man | 171 ----------------------------------------------------
1 file changed, 171 deletions(-)
diff --git a/man/groff_out.5.man b/man/groff_out.5.man
index 5c9924783..8a97b2051 100644
--- a/man/groff_out.5.man
+++ b/man/groff_out.5.man
@@ -1549,177 +1549,6 @@ see the reference in section \[lq]Files\[rq] below.
.
.
.\" ====================================================================
-.SH Example
-.\" ====================================================================
-.
-This section presents the
-.I intermediate output
-generated from the same input for three different devices.
-.
-The input is the sentence
-.I hell world
-fed into
-.I groff
-on the command line.
-.
-.
-.IP \[bu] 3n
-High-resolution device
-.I ps
-.
-.
-.RS
-.P
-.EX
-.RB "shell>\~" "echo \[dq]hell world\[dq] | groff \-Z \-T ps"
-.EE
-.
-.
-.P
-.EX
-x T ps
-x res 72000 1 1
-x init
-p1
-x font 5 TR
-f5
-s10000
-V12000
-H72000
-thell
-wh2500
-tw
-H96620
-torld
-n12000 0
-x trailer
-V792000
-x stop
-.EE
-.RE
-.
-.
-.P
-This output can be fed into the postprocessor
-.MR grops @MAN1EXT@
-to get its representation as a PostScript file, or
-.MR gropdf @MAN1EXT@
-to output directly to PDF.
-.
-.
-.IP \[bu] 3n
-Low-resolution device
-.I latin1
-.
-.
-.RS
-.P
-This is similar to the high-resolution device except that the
-positioning is done at a minor scale.
-.
-Some comments (lines starting with
-.IR # )
-were added for clarification; they were not generated by the
-formatter.
-.
-.
-.P
-.EX
-\fBshell>\fP "hell world" | groff \-Z \-T latin1
-.EE
-.
-.
-.P
-.EX
-.I # prologue
-x T latin1
-x res 240 24 40
-x init
-.I # begin a new page
-p1
-.I # font setup
-x font 1 R
-f1
-s10
-.I # initial positioning on the page
-V40
-H0
-.I # write text \[aq]hell\[aq]
-thell
-.I # inform about a space, and do it by a horizontal jump
-wh24
-.I # write text \[aq]world\[aq]
-tworld
-.I # announce line break, but do nothing because ...
-n40 0
-.I # ... the end of the document has been reached
-x trailer
-V2640
-x stop
-.EE
-.RE
-.
-.
-.P
-This output can be fed into the postprocessor
-.MR grotty @MAN1EXT@
-to get a formatted text document.
-.
-.
-.IP \[bu] 3n
-Classical style output
-.
-.
-.RS
-.P
-As a computer monitor has a very low resolution compared to modern
-printers the
-.I intermediate output
-for the X\~devices can use the jump-and-write command with its 2-digit
-displacements.
-.
-.
-.P
-.EX
-\fBshell>\fP "hell world" | groff \-Z \-T X100
-.EE
-.
-.
-.P
-.EX
-x T X100
-x res 100 1 1
-x init
-p1
-x font 5 TR
-f5
-s10
-V16
-H100
-.I # write text with old-style jump-and-write command
-ch07e07l03lw06w11o07r05l03dh7
-n16 0
-x trailer
-V1100
-x stop
-.EE
-.RE
-.
-.
-.P
-This output can be fed into the postprocessor
-.MR xditview 1x
-or
-.MR gxditview @MAN1EXT@
-for displaying in\~X.
-.
-.
-.P
-Due to the obsolete jump-and-write command, the text clusters in the
-classical output are almost unreadable.
-.
-.
-.\" ====================================================================
.SH Compatibility
.\" ====================================================================
.
_______________________________________________
groff-commit mailing list
[email protected]
https://lists.gnu.org/mailman/listinfo/groff-commit
