gbranden pushed a commit to branch master
in repository groff.
commit 2924e319dd7594c1a05169f9be85258e2ded1440
Author: G. Branden Robinson <[email protected]>
AuthorDate: Sat Jan 24 15:28:16 2026 -0600
doc/groff.texi.in: Fix content/style/markup nits.
Content:
* We don't "frequently" employ the `ll` request in examples; only
occasionally.
Style:
* Favor active voice over passive.
Markup:
* Break Texinfo input lines in a roff-friendly way.
---
doc/groff.texi.in | 17 ++++++++++++-----
1 file changed, 12 insertions(+), 5 deletions(-)
diff --git a/doc/groff.texi.in b/doc/groff.texi.in
index d46b07df6..3a1cc27aa 100644
--- a/doc/groff.texi.in
+++ b/doc/groff.texi.in
@@ -901,11 +901,18 @@ Most examples are of @code{roff} language input that
would be placed in
a text file. Occasionally, we start an example with a @samp{$}
character to indicate a shell prompt, as seen above.
-You are encouraged to try the examples yourself, and to alter them to
-better learn @code{groff}'s behavior. Our examples frequently need to
-direct the formatter to set a line length (with @samp{.ll}) that will
-fit within the page margins of this manual. We mention this so that you
-know why it is there before we discuss the @code{ll} request
+We encourage you to to try the examples yourself,
+and to alter them to better learn
+@code{groff}'s
+behavior.
+Our examples sometimes need to direct the formatter to set a line length
+(with
+@samp{.ll})
+that fits within the page margins of this manual.
+We mention this so that you know why it is there
+before we discuss the
+@code{ll}
+request
formally.@footnote{@xref{Line Layout}.}
@cindex man pages
_______________________________________________
groff-commit mailing list
[email protected]
https://lists.gnu.org/mailman/listinfo/groff-commit
