[groff] 02/23: Drop ditroff(7) document.

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit d139b026913bff3f7a54afab7a59905e9deb49b3
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Sat Mar 19 17:58:41 2022 +1100

    Drop ditroff(7) document.
    
    It says nothing that is not covered elsewhere.
    
    * man/ditroff.7.man: Delete.
    * doc/doc.am (GROFF_MAN_PAGES):
    * man/man.am (man7_MANS, EXTRA_DIST): Stop processing, shipping.
    * src/roff/groff/groff.1.man: Drop cross reference to it.
    * NEWS: Add item.
    
    Fixes <https://savannah.gnu.org/bugs/?61817>.
---
 ChangeLog                  |  13 ++++
 NEWS                       |   3 +
 doc/doc.am                 |   1 -
 man/ditroff.7.man          | 179 ---------------------------------------------
 man/man.am                 |   2 -
 src/roff/groff/groff.1.man |  13 ++--
 6 files changed, 22 insertions(+), 189 deletions(-)

diff --git a/ChangeLog b/ChangeLog
index dfa62a73..7c8f11e3 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,16 @@
+2022-03-19  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+       Drop ditroff(7) document.  It says nothing that is not covered
+       elsewhere.
+
+       * man/ditroff.7.man: Delete.
+       * doc/doc.am (GROFF_MAN_PAGES):
+       * man/man.am (man7_MANS, EXTRA_DIST): Stop processing, shipping.
+       * src/roff/groff/groff.1.man: Drop cross reference to it.
+       * NEWS: Add item.
+
+       Fixes <https://savannah.gnu.org/bugs/?61817>.
+
 2022-03-18  G. Branden Robinson <g.branden.robinson@gmail.com>
 
        [preconv]: Trivially refactor.
diff --git a/NEWS b/NEWS
index ab967f48..8cd8e159 100644
--- a/NEWS
+++ b/NEWS
@@ -414,6 +414,9 @@ o groffer has been deleted from the distribution.
 o grog no longer supports the "--warnings" option; the one diagnostic
   message that it enabled has been removed.
 
+o The ditroff(7) man page has been deleted.  The "History" section of
+  roff(7) covers the same subject in greater depth.
+
 
 VERSION 1.22.4
 ==============
diff --git a/doc/doc.am b/doc/doc.am
index 2bcb2d8c..44f8c73e 100644
--- a/doc/doc.am
+++ b/doc/doc.am
@@ -197,7 +197,6 @@ GROFF_MAN_PAGES1 = \
   man/groff_out.5 \
   man/groff_tmac.5 \
   src/devices/grolj4/lj4_font.5 \
-  man/ditroff.7 \
   man/groff.7 \
   man/groff_char.7 \
   man/groff_diff.7 \
diff --git a/man/ditroff.7.man b/man/ditroff.7.man
deleted file mode 100644
index 60f8a0ee..00000000
--- a/man/ditroff.7.man
+++ /dev/null
@@ -1,179 +0,0 @@
-.TH ditroff @MAN7EXT@ "@MDATE@" "groff @VERSION@"
-.SH Name
-ditroff \- device-independent typesetter roff
-.
-.
-.\" ====================================================================
-.\" Legal Terms
-.\" ====================================================================
-.\"
-.\" Copyright (C) 2001-2020 Free Software Foundation, Inc.
-.\"
-.\" This file is part of groff, the GNU roff type-setting system.
-.\"
-.\" Permission is granted to copy, distribute and/or modify this
-.\" document under the terms of the GNU Free Documentation License,
-.\" Version 1.3 or any later version published by the Free Software
-.\" Foundation; with no Invariant Sections, with no Front-Cover Texts,
-.\" and with no Back-Cover Texts.
-.\"
-.\" A copy of the Free Documentation License is included as a file
-.\" called FDL in the main directory of the groff source package.
-.
-.
-.\" Save and disable compatibility mode (for, e.g., Solaris 10/11).
-.do nr *groff_ditroff_7_man_C \n[.cp]
-.cp 0
-.
-.
-.\" ====================================================================
-.SH Description
-.\" ====================================================================
-.
-The name
-.I ditroff
-refers to a historical development stage of the
-.MR roff @MAN7EXT@
-text processing system.
-.
-In
-.I roff
-systems extant today, the name
-.I troff
-is a synonym for
-.IR ditroff .
-.
-.
-.P
-Early versions of
-.I roff
-by Joe Ossanna generated two programs from the same sources,
-using conditional compilation to distinguish them.
-.
-.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
-.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 \(lqclassical troff\(rq
-today.
-.
-In order to distinguish it from Ossanna's original version, it was
-called
-.I ditroff
-.RI ( d "evice " i "ndependent " t roff)
-on some systems, though this naming isn't mentioned in the classical
-documentation.
-.
-.
-.P
-Today, all existing
-.I roff
-systems are based on Kernighan's multi-device
-.IR troff .
-.
-The distinction between
-.I troff
-and
-.I ditroff
-is no longer necessary; each modern
-.I troff
-provides the complete functionality of
-.IR ditroff .
-.
-.
-.P
-The easiest way to use
-.I ditroff
-is via the GNU
-.I roff
-system,
-.IR groff .
-.
-The
-.MR groff @MAN1EXT@
-program is a wrapper around
-.I (di)troff
-that automatically handles device postprocessing.
-.
-.
-.\" ====================================================================
-.SH Authors
-.\" ====================================================================
-.
-This document was written by
-.MT groff\-bernd\:.warken\-72@\:web\:.de
-Bernd Warken
-.ME .
-.
-.
-.\" ====================================================================
-.SH "See also"
-.\" ====================================================================
-.
-.TP
-CSTR\~#54
-refers to the 1992 revision of the
-.I Nroff/Troff User's Manual
-by J.\& F.\& Ossanna and Brian Kernighan.
-.
-.
-.TP
-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
-.MR roff @MAN7EXT@
-provides a history and conceptual overview of
-.I roff
-systems.
-.
-.
-.TP
-.MR @g@troff @MAN1EXT@
-describes the GNU implementation of
-.IR (di)troff .
-.
-.
-.TP
-.MR groff @MAN1EXT@
-documents the GNU
-.I roff
-program and includes pointers to further documentation about
-.IR groff .
-.
-.
-.TP
-.MR groff_out @MAN5EXT@
-describes the
-.I groff
-version of the intermediate output language, the basis for
-multi-device output.
-.
-.
-.\" Restore compatibility mode (for, e.g., Solaris 10/11).
-.cp \n[*groff_ditroff_7_man_C]
-.do rr *groff_ditroff_7_man_C
-.
-.
-.\" Local Variables:
-.\" fill-column: 72
-.\" mode: nroff
-.\" End:
-.\" vim: set filetype=groff textwidth=72:
diff --git a/man/man.am b/man/man.am
index f89bf502..f37e9064 100644
--- a/man/man.am
+++ b/man/man.am
@@ -20,7 +20,6 @@ man5_MANS += \
   man/groff_out.5 \
   man/groff_tmac.5
 man7_MANS += \
-  man/ditroff.7 \
   man/groff_char.7 \
   man/groff_diff.7 \
   man/groff.7 \
@@ -29,7 +28,6 @@ EXTRA_DIST += \
   man/groff_font.5.man \
   man/groff_out.5.man \
   man/groff_tmac.5.man \
-  man/ditroff.7.man \
   man/groff_char.7.man \
   man/groff_diff.7.man \
   man/groff.7.man \
diff --git a/src/roff/groff/groff.1.man b/src/roff/groff/groff.1.man
index 5cffbab4..98282531 100644
--- a/src/roff/groff/groff.1.man
+++ b/src/roff/groff/groff.1.man
@@ -2145,15 +2145,14 @@ manual.
 You can browse it interactively with \[lq]info groff\[rq].
 .
 .
-.\" groff ships 62 man pages generated from 61 source files.  The
+.\" groff ships 61 man pages generated from 60 source files.  The
 .\" numbered comments refer to their sorting order in the source tree,
 .\" so that it is easier to tell that we've enumerated all of them.
 .TP
 Introduction, \c
 history, \c
 and further reading:
-.MR roff @MAN7EXT@ , \" #23
-.MR ditroff @MAN7EXT@ \" #16
+.MR roff @MAN7EXT@ \" #23
 .
 .
 .TP
@@ -2191,9 +2190,9 @@ Macro packages and package-specific utilities:
 .MR groff_mom @MAN7EXT@ , \" #13
 .MR pdfmom @MAN1EXT@ , \" #30
 .MR groff_ms @MAN7EXT@ , \" #58
-.MR groff_rfc1345 @MAN7EXT@ , \" added 2021-02-01
-.MR groff_trace @MAN7EXT@ , \" #60
-.MR groff_www @MAN7EXT@ \" #59
+.MR groff_rfc1345 @MAN7EXT@ , \" 16
+.MR groff_trace @MAN7EXT@ , \" #59
+.MR groff_www @MAN7EXT@ \" #60
 .
 .
 .TP
@@ -2227,7 +2226,7 @@ Formatter program:
 .
 .TP
 Formatter wrappers:
-.\".IR groff (@MAN1EXT@), \" 42 -- this page
+.\".MR groff @MAN1EXT@ , \" 42 -- this page
 .MR @g@nroff @MAN1EXT@ , \" #44
 .MR pdfroff @MAN1EXT@ \" #14
 .