[groff] 06/20: man/ditroff.7: Make style fixes.

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit 4b7d50faf1d46848e67433ebff5024e265d1d8e9
Author: G. Branden Robinson <address@hidden>
Date:   Thu Nov 8 11:39:46 2018 -0500

    man/ditroff.7: Make style fixes.
    
        * man/ditroff.7:
          + Use more idiomatic English.
          + Set names of commands and programming systems in italics.
          + Set proper names in roman.
    
    Signed-off-by: G. Branden Robinson <address@hidden>
---
 man/ditroff.7.man | 144 ++++++++++++++++++++++++++++--------------------------
 1 file changed, 75 insertions(+), 69 deletions(-)

diff --git a/man/ditroff.7.man b/man/ditroff.7.man
index 7e8deb1..a55f9f5 100644
--- a/man/ditroff.7.man
+++ b/man/ditroff.7.man
@@ -2,8 +2,6 @@
 .SH NAME
 ditroff \- classical device-independent roff
 .
-.\" ditroff.man
-.
 .
 .\" ====================================================================
 .\" Legal Terms
@@ -29,79 +27,85 @@ ditroff \- classical device-independent roff
 .
 The name
 .I ditroff
-once marked a development level of the
-.I troff
+refers to a historical development stage of the
+.IR roff (@MAN7EXT@)
 text processing system.
 .
-In actual
-.BR roff (@MAN7EXT@)
-systems, the name
+In
+.I roff
+systems extant today, the name
 .I troff
-is used as a synonym for
+is a synonym for
 .IR ditroff .
 .
+.
 .P
-The first roff system was written by Joe Ossanna around 1973.
+Early versions of
+.I roff
+by Joe Ossanna generated two programs from the same sources,
+using conditional compilation to distinguish them.
 .
-It supported only two output devices, the
-.B nroff
-program produced text oriented tty output, while the
-.B troff
-program generated graphical output for exactly one output device, the
-Wang
-.I Graphic Systems CAT
-typesetter.
+.I nroff
+produced text-oriented TTY output, while
+.I troff
+generated graphical output for exactly one output device, the
+Wang Graphic Systems CAT phototypesetter.
 .
 .
 .P
-In 1979, Brian Kernighan rewrote troff to support more devices by
-creating an intermediate output format for troff that can be fed into
-postprocessor programs which actually do the printout on the device.
+In 1979, Brian Kernighan rewrote
+.I troff
+to support more devices by creating an intermediate output format for
+.I troff
+that could be fed into postprocessor programs which actually do the
+printout on the device.
 .
-Kernighan's version marks what is known as
-.I classical troff
+Kernighan's version marks what is known as \(lqclassical troff\(rq
 today.
 .
-In order to distinguish it from Ossanna's original mono-device
-version, it was called
+In order to distinguish it from Ossanna's original version, it was
+called
 .I ditroff
-.RI ( d "evice " i "ndependent " troff )
-on some systems, though this naming isn't mentioned in the
-classical documentation.
+.RI ( d "evice " i "ndependent " t roff)
+on some systems, though this naming isn't mentioned in the classical
+documentation.
 .
 .
 .P
-Today, any existing roff system is based on Kernighan's
-multi-device troff.
+Today, all existing
+.I roff
+systems are based on Kernighan's multi-device
+.IR troff .
 .
 The distinction between
 .I troff
 and
 .I ditroff
-isn't necessary any longer, for each modern
+is no longer necessary; each modern
 .I troff
-provides already the complete functionality of
-.IR ditroff .
-.
-On most systems, the name
-.I troff
-is used to denote
+provides the complete functionality of
 .IR ditroff .
 .
 .
 .P
-The easiest way to use ditroff is the GNU roff system,
+The easiest way to use
+.I ditroff
+is via the GNU
+.I roff
+system,
 .IR groff .
+.
 The
-.BR groff (@MAN1EXT@)
+.IR groff (@MAN1EXT@)
 program is a wrapper around
 .I (di)troff
-that automatically handles postprocessing.
+that automatically handles device postprocessing.
 .
 .
 .\" ====================================================================
 .SH AUTHORS
 .\" ====================================================================
+.
 This document was written by
 .MT address@hidden:web.de
 Bernd Warken
@@ -113,47 +117,49 @@ Bernd Warken
 .\" ====================================================================
 .
 .TP
-[CSTR\~#54]
-The 1992 revision of the
+CSTR\~#54
+refers to the 1992 revision of the
 .I Nroff/Troff User's Manual
-by
-.I J.\& F.\& Ossanna
-and
-.IR "Brian Kernighan" ,
-see
-.UR http://\:cm.bell\-labs.com/\:cm/\:cs/\:cstr/\:54.ps.gz
-Bell Labs CSTR\~#54
-.UE .
+by J.\& F.\& Ossanna and Brian Kernighan.
+.
 .
 .TP
-[CSTR\~#97]
-.I A Typesetter-independent TROFF
-by
-.I Brian Kernighan
-is the original documentation of the first multi-device troff
-.RI ( ditroff ),
-see
-.UR http://\:cm.bell\-labs.com/\:cm/\:cs/\:cstr/\:97.ps.gz
-Bell Labs CSTR\~#97
-.UE .
+CSTR\~#97
+refers to
+.IR "A Typesetter-independent TROFF" ,
+by Brian Kernighan and is the original documentation of the first
+multi-device
+.I troff
+.RI ( ditroff ).
+.
 .
 .TP
-.BR roff (@MAN7EXT@)
-This document gives details on the history and concepts of roff.
+.IR roff (@MAN7EXT@)
+provides a history and conceptual overview of
+.I roff
+systems.
+.
 .
 .TP
-.BR @address@hidden (@MAN1EXT@)
-The actual implementation of
-.IR ditroff .
+.IR @address@hidden (@MAN1EXT@)
+describes the GNU implementation of
+.IR (di)troff .
+.
 .
 .TP
-.BR groff (@MAN1EXT@)
-The GNU roff program and pointers to all documentation around groff.
+.IR groff (@MAN1EXT@)
+documents the GNU
+.I roff
+program and includes pointers to further documentation about
+.IR groff .
+.
 .
 .TP
-.BR groff_out (@MAN5EXT@)
-The groff version of the intermediate output language, the basis for
-multi-devicing.
+.IR groff_out (@MAN5EXT@)
+describes the
+.I groff
+version of the intermediate output language, the basis for
+multi-device output.
 .
 .
 .\" ====================================================================