gbranden pushed a commit to branch master
in repository groff.
commit f07bcd49578a2e02aec2eb318f530bcffd59d58e
Author: G. Branden Robinson <[email protected]>
AuthorDate: Tue Aug 5 03:59:52 2025 -0500
doc/meintro.me.in: Improve nroff-mode cosmetics.
* Configure page offset to more closely resemble that of a traditional,
formal, but still typewritten, document.
* Illustrate use of brace escape sequences to group formatting commands.
* Add a page footer to (1) disclose the corresponding groff version and
(2) illustrate where the bottom page margin is.
* Fix unfilled text in examples to not overrun the line length. This
includes an adjustment to the tab stops in one example. Like the new
nroff-mode line lengths and page offset, we use ens instead of inches
as (what I regard as) preferably pedagogy for learners.
* Repeat the unfilled text verbatim in the examples illustrating their
input, even if the changed input line breaks "don't matter"; it is
better pedagogy to demonstrate rendering of identical inputs.
---
doc/meintro.me.in | 28 +++++++++++++++++-----------
1 file changed, 17 insertions(+), 11 deletions(-)
diff --git a/doc/meintro.me.in b/doc/meintro.me.in
index bf01a3fcf..306977cb8 100644
--- a/doc/meintro.me.in
+++ b/doc/meintro.me.in
@@ -38,12 +38,16 @@
.\"
.\" Modified for groff by [email protected].
.\"UC 7
-.if t .ll 6.5i
-.if t .lt 6.5i
+.if t \{\
+. ll 6.5i
+. lt 6.5i
+.\}
+.if n .po 10n
.nr sx 0
.ds MO @VERSION@
.nr si 3n
.he 'Using \f(BIgroff\fP and \f(BI\-me\fP''%'
+.fo ''\f(BIgroff\fP \*(MO''
.\"eh 'USD:19-%''Writing Papers with NROFF using \-me'
.\"oh 'Writing Papers with NROFF using \-me''USD:19-%'
.ds U Unix
@@ -1113,9 +1117,9 @@ Why the sea is boiling hot
Whether pigs have wings
\&.)x ""
\&.(x
-This is a terribly long index entry, such as might be used
-for a list of illustrations, tables, or figures; I expect it to
-take at least two lines.
+This is a terribly long index entry, such as might
+be used for a list of illustrations, tables, or
+figures; I expect it to take at least two lines.
\&.)x
\&.xp
.)b
@@ -1133,9 +1137,9 @@ Why the sea is boiling hot
Whether pigs have wings
.)x ""
.(x
-This is a terribly long index entry, such as might be used
-for a list of illustrations, tables, or figures; I expect it to
-take at least two lines.
+This is a terribly long index entry, such as might
+be used for a list of illustrations, tables, or
+figures; I expect it to take at least two lines.
.)x
.xp
.pp
@@ -1269,14 +1273,16 @@ the input:
\&.ip longlabel
This paragraph had a long label.
The first character of text on the first line
-will not line up with the text on second and subsequent lines,
+will not line up with the text
+on second and subsequent lines,
although they will line up with each other.
.)b
will produce:
.ip longlabel
This paragraph had a long label.
The first character of text on the first line
-will not line up with the text on second and subsequent lines,
+will not line up with the text
+on second and subsequent lines,
although they will line up with each other.
.pp
It is possible to change the size of the label
@@ -1671,7 +1677,7 @@ comments begin with the sequence
.hl
.if t .in 0.5i
.if t .ta 2i
-.if n .ta 3i
+.if n .ta 23n
\&.th \e" set for thesis mode
\&.fo \(aq\(aqDRAFT\(aq\(aq \e" define footer for each page
\&.tp \e" begin title page
_______________________________________________
groff-commit mailing list
[email protected]
https://lists.gnu.org/mailman/listinfo/groff-commit
