[groff] 04/122: [man pages]: Update bibliographic material.

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit f27ee5749b627c7505f9ebbfc0e63c70cbc38884
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Fri Nov 6 20:53:48 2020 +1100

    [man pages]: Update bibliographic material.
    
    * man/groff.7.man:
    * man/groff_char.7.man:
    * man/groff_diff.7.man:
    * man/groff_font.5.man:
      + Cite CSTR documents in a consistent format.
      + Move man page cross-references after other forms of documentation.
      + Drop dead URLs.
      + Drop links to Wikipedia (see
        96c1952c465dfbd7127128c39b276209c333df00, 17 October).
---
 man/groff.7.man      | 113 +++++++++++++++++++++++++++++++--------------------
 man/groff_char.7.man |   2 +-
 man/groff_diff.7.man |   3 +-
 man/groff_font.5.man |  51 +++++++++++++++++++++--
 4 files changed, 119 insertions(+), 50 deletions(-)

diff --git a/man/groff.7.man b/man/groff.7.man
index 2e7c9d9..9c59dc2 100644
--- a/man/groff.7.man
+++ b/man/groff.7.man
@@ -5089,69 +5089,94 @@ is the primary
 .I groff
 manual.
 .
-You can browse it interactively with \(lqinfo groff\(rq.
+You can browse it interactively with \[lq]info groff\[rq].
 .
-Besides the gory details, it contains many examples.
 .
+.P
+\[lq]Troff User's Manual\[rq]
+by Joseph F.\& Ossanna, 1976
+(revised by Brian W.\& Kernighan, 1992),
+AT&T Bell Laboratories Computing Science Techical Report No.\& 54,
+widely called simply \[lq]CSTR\~#54\[rq],
+documents the language,
+device and font description file formats,
+and device-independent output format
+referred to collectively in
+.I groff
+documentation as
+.RI \[lq]AT&T\~ troff \[rq].
 .
-.TP
-.BR groff (@MAN1EXT@)
-the usage of the groff program and pointers to the documentation and
-availability of the groff system.
 .
-.TP
-.BR groff_diff (@MAN7EXT@)
-describes the differences between the groff language and classical
-troff.
+.P
+\[lq]A Typesetter-independent TROFF\[rq]
+by Brian W.\& Kernighan, 1982,
+AT&T Bell Laboratories Computing Science Techical Report No.\& 97
+(CSTR\~#97),
+provides additional insights into the
+device and font description file formats
+and device-independent output format.
 .
-.IP
-This is the authoritative document for the predefined language
-elements that are specific to groff.
 .
 .TP
-.BR groff_char (@MAN7EXT@)
-the predefined groff special characters (glyphs).
+.IR groff (@MAN1EXT@)
+is the preferred interface to the
+.I groff
+system;
+it manages the pipeline that carries a source document through
+preprocessors,
+the
+.I \%@g@troff
+formatter,
+and an output driver to viewable or printable form.
+.
+It also exhaustively lists all of the man pages provided with the GNU
+.I roff
+system.
 .
-.TP
-.BR groff_font (@MAN5EXT@)
-the specification of fonts and the DESC file.
 .
 .TP
-.BR groff_tmac (@MAN5EXT@)
-contains an overview of available groff macro packages, instructions on
-how to interface them with a document, guidance on writing macro
-packages and using diversions, and historical information on macro
-package naming conventions.
-.TP
-.BR roff (@MAN7EXT@)
-the history of roff, the common parts shared by all roff systems, and
-pointers to further documentation.
+.IR groff_char (@MAN7EXT@)
+discusses character encoding issues,
+escape sequences that produce glyphs,
+and enumerates
+.IR groff 's
+predefined special character escapes.
+.
 .
 .TP
-[CSTR\~#54]
-.UR http://\:cm.bell\-labs.com/\:cm/\:cs/\:cstr/\:54.ps.gz
-Nroff/\:Troff User's Manual by Ossanna & Kernighan
-.UE
-\[em] the bible for classical troff.
+.IR groff_diff (@MAN7EXT@)
+covers the differences between the
+GNU
+.I troff \" GNU
+formatter,
+its device and font description file format,
+and its device-independent output format,
+and those of AT&T
+.IR troff ,\" AT&T
+whose design it re-implements.
+.
 .
 .TP
-.I Wikipedia
-article about
-.I groff
-.UR https://\:en.wikipedia.org/\:wiki/\:Groff_%28software%29
-.UE .
+.IR groff_font (@MAN5EXT@)
+describes the formats of the files that describe devices
+.RI ( DESC )
+and fonts.
+.
 .
 .TP
-.I Tutorial about groff
-.UR dl.dropbox.com/\:u/\:4299293/\:grofftut.pdf
-Manas Laha - An Introduction to the GNU Groff Text Processing System
-.UE
+.IR groff_tmac (@MAN5EXT@)
+surveys macro packages provided with
+.IR groff ,
+describes how documents can take advantage of them,
+offers guidance on writing macro packages and using diversions,
+and includes historical information on macro package naming conventions.
+.
 .
 .TP
-.I troff.org
-This is a collection of internet sites with classical
+.IR roff (@MAN7EXT@)
+presents a detailed history of
 .I roff
-documentations and other information.
+systems and summarizes concepts common to them.
 .
 .
 .\" Restore compatibility mode (for, e.g., Solaris 10/11).
diff --git a/man/groff_char.7.man b/man/groff_char.7.man
index d2431f8..cf039be 100644
--- a/man/groff_char.7.man
+++ b/man/groff_char.7.man
@@ -1699,7 +1699,7 @@ manual.
 .
 Section \[lq]Using Symbols\[rq] may be of particular note.
 .
-You can browse it interactively with \[lq]info \[aq](groff)Using
+You can browse it interactively with \[lq]info \[aq](groff) Using
 Symbols\[aq]\[rq].
 .
 .
diff --git a/man/groff_diff.7.man b/man/groff_diff.7.man
index c837121..d08ef4e 100644
--- a/man/groff_diff.7.man
+++ b/man/groff_diff.7.man
@@ -5032,7 +5032,8 @@ documentation as
 .PP
 \[lq]A Typesetter-independent TROFF\[rq]
 by Brian W.\& Kernighan, 1982,
-AT&T Bell Laboratories Computing Science Techical Report No.\& 97,
+AT&T Bell Laboratories Computing Science Techical Report No.\& 97
+(CSTR\~#97),
 provides additional insights into the
 device and font description file formats
 and device-independent output format.
diff --git a/man/groff_font.5.man b/man/groff_font.5.man
index 6cf3fb3..6e66d68 100644
--- a/man/groff_font.5.man
+++ b/man/groff_font.5.man
@@ -699,10 +699,53 @@ of device
 .SH "See Also"
 .\" ====================================================================
 .
-.BR groff_out (@MAN5EXT@),
-.BR \%@g@troff (@MAN1EXT@),
-.BR addftinfo (@MAN1EXT@),
-.BR afmtodit (@MAN1EXT@)
+.IR "Groff: The GNU Implementation of troff" ,
+by Trent A.\& Fisher and Werner Lemberg,
+is the primary
+.I groff
+manual.
+.
+You can browse it interactively with \[lq]info groff\[rq].
+.
+.
+.LP
+\[lq]Troff User's Manual\[rq]
+by Joseph F.\& Ossanna, 1976
+(revised by Brian W.\& Kernighan, 1992),
+AT&T Bell Laboratories Computing Science Techical Report No.\& 54,
+widely called simply \[lq]CSTR\~#54\[rq],
+documents the language,
+device and font description file formats,
+and device-independent output format
+referred to collectively in
+.I groff
+documentation as
+.RI \[lq]AT&T\~ troff \[rq].
+.
+.
+.LP
+\[lq]A Typesetter-independent TROFF\[rq]
+by Brian W.\& Kernighan, 1982,
+AT&T Bell Laboratories Computing Science Techical Report No.\& 97,
+provides additional insights into the
+device and font description file formats
+and device-independent output format.
+.
+.
+.LP
+Section \[lq]See Also\[rq] of
+.IR groff (@MAN1EXT@)
+lists utilities available for preparing font files in a variety of
+formats for use with
+.I groff
+output drivers.
+.
+.
+.LP
+.IR groff_out (@MAN5EXT@),
+.IR \%@g@troff (@MAN1EXT@),
+.IR \%addftinfo (@MAN1EXT@),
+.IR \%afmtodit (@MAN1EXT@)
 .
 .
 .\" Restore compatibility mode (for, e.g., Solaris 10/11).