[groff] 12/35: troff(1): Recast introduction.

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit 0feb82ef1ac4b8d8a36d776fc4b39249e95763b3
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Sat Oct 23 12:31:12 2021 +1100

    troff(1): Recast introduction.
    
    Tell what the command _does_ first, _then_ situate it in its ecosystem.
---
 src/roff/troff/troff.1.man | 19 ++++++++-----------
 1 file changed, 8 insertions(+), 11 deletions(-)

diff --git a/src/roff/troff/troff.1.man b/src/roff/troff/troff.1.man
index cbda610..e43cfa7 100644
--- a/src/roff/troff/troff.1.man
+++ b/src/roff/troff/troff.1.man
@@ -84,19 +84,16 @@
 .SH Description
 .\" ====================================================================
 .
-The GNU version of
-.I troff \" generic
-is the heart of the
-.I groff
-document formatting system.
-.
+GNU
+.I troff \" GNU
+transforms
+.MR groff @MAN7EXT@
+language input into the device-independent output format described in
+.MR groff_out @MAN5EXT@ ;
 .I \%@g@troff
-is the
-.I groff
-system's formatter,
-the program that transforms
+is thus the heart of the GNU
 .I roff
-language input into a device-independent output format.
+document formatting system.
 .
 It is functionally compatible with the AT&T
 .I troff \" AT&T