gbranden pushed a commit to branch master
in repository groff.
commit 771cc22efd03d0c68f4dd5c6a80829c698007eda
Author: G. Branden Robinson <[email protected]>
AuthorDate: Fri Jan 2 01:37:29 2026 -0600
doc/groff.texi: Tweak introduction to "Text".
* Use `@command` Texinfo command, not `@code` for Unix commands.[1]
* Break input lines similarly in *roff and Texinfo.
* Sync material between our Texinfo manual and man pages.
[1] roff(1) was historically a Unix command but groff documentation uses
it to refer the entire class of Ossanna troff-descended and
-inspired formatters. "nroff"--"new roff"--implies an "old roff";
roff(1), still shipping in 1979's Seventh Edition Unix, was it.
---
doc/groff.texi.in | 32 ++++++++++++++++++++++----------
man/roff.7.man | 27 +++++++++++++++++++++++++++
2 files changed, 49 insertions(+), 10 deletions(-)
diff --git a/doc/groff.texi.in b/doc/groff.texi.in
index 6dc56d324..71400078c 100644
--- a/doc/groff.texi.in
+++ b/doc/groff.texi.in
@@ -5424,16 +5424,28 @@ not interested in details.
@section Text
@cindex text, GNU @code{troff} processing
-@acronym{AT&T} @code{troff} was designed to take input as it would be
-composed on a typewriter, including the teletypewriters used as early
-computer terminals, and relieve the user drafting a document of concern
-with details like line length, hyphenation breaking, and the achievement
-of straight margins. Early in its development, the program gained the
-ability to prepare output for a phototypesetter; a document could then
-be prepared for output to either a teletypewriter, a phototypesetter, or
-both. GNU @code{troff} continues this tradition of permitting an author
-to compose a single master version of a document which can then be
-rendered for a variety of output formats or devices.
+@acronym{AT&T}
+@command{troff} @c AT&T
+was designed to take input as it would be composed on a typewriter,
+including the teletypewriters used as early computer terminals,
+and relieve the user drafting a document of concern with details like
+line length maintenance,
+hyphenation breaking,
+and consistent paragraph indentation.
+Early in its development,
+the program gained the ability to prepare output for a phototypesetter;
+a document could then be prepared for output to a teletypewriter,
+a phototypesetter,
+or both.
+GNU
+@command{troff}
+continues this tradition of permitting an author
+to compose a single master version of a document
+which can then be rendered upon a variety of output formats or devices,
+including PDF,
+HTML,
+laser printers,
+and terminal displays.
@code{roff} input contains text interspersed with instructions to
control the formatter. Even in the absence of such instructions, GNU
diff --git a/man/roff.7.man b/man/roff.7.man
index 98c0827aa..889cf9bb4 100644
--- a/man/roff.7.man
+++ b/man/roff.7.man
@@ -115,6 +115,33 @@ and recommend further reading materials.
.
.\" BEGIN Keep roughly parallel with groff.texi nodes "Text" through
.\" "Tabs and Leaders".
+AT&T
+.I troff \" AT&T
+was designed to take input as it would be composed on a typewriter,
+including the teletypewriters used as early computer terminals,
+and relieve the user drafting a document of concern with details like
+line length maintenance,
+hyphenation breaking,
+and consistent paragraph indentation.
+.
+Early in its development,
+the program gained the ability to prepare output for a phototypesetter;
+a document could then be prepared for output to a teletypewriter,
+a phototypesetter,
+or both.
+.
+GNU
+.I troff \" GNU
+continues this tradition of permitting an author
+to compose a single master version of a document
+which can then be rendered upon a variety of output formats or devices,
+including PDF,
+HTML,
+laser printers,
+and terminal displays.
+.
+.
+.P
.I roff
input contains text interspersed with instructions to control the
formatter.
_______________________________________________
groff-commit mailing list
[email protected]
https://lists.gnu.org/mailman/listinfo/groff-commit
