[groff] 02/02: man pages: Adjust various adjustment problems.

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit 7c7108b06b61ae1b6ed620e4414af8752c6ad337
Author: G. Branden Robinson <address@hidden>
Date:   Tue Nov 7 16:35:48 2017 -0500

    man pages: Adjust various adjustment problems.
    
    grodvi.1.man:
    groff.1.man:
    groff_man.7.man:
        Restore normal paragraph adjustment to ordinary text paragraphs.
    
    grodvi.1.man:
        Add hyphenation breakpoint after @MACRODIR@ in DESCRIPTION.
    
    groff_ms.7.man:
        Set GNU manual separately from man page cross references.
    
        That, in turn, makes left-adjustment of the cross references no
        longer necessary.
    
    grog.1.man:
        Greatly reduce SEE ALSO section, which duplicated much of the
        same section in groff(1) (to which this page still refers).
    
    gropdf.1.man:
        Stop cross-referencing pages without explanation.
    
        Ensure cross-reference to (g)troff picks up the GROFF_BIN_PREFIX
        if one is defined.
    
    pdfroff.1.man:
        Use EX/EE macros for default gs command invocation and wrap
        long line.  Stop using page-local macro for this (one use only)
        and undefine it.
    
    Signed-off-by: G. Branden Robinson <address@hidden>
---
 contrib/pdfmark/pdfroff.1.man   | 17 +++++----------
 src/devices/grodvi/grodvi.1.man |  4 +---
 src/devices/gropdf/gropdf.1.man | 16 ++++++--------
 src/roff/groff/groff.1.man      |  2 +-
 src/roff/grog/grog.1.man        | 47 -----------------------------------------
 tmac/groff_ms.7.man             | 10 +++++----
 6 files changed, 19 insertions(+), 77 deletions(-)

diff --git a/contrib/pdfmark/pdfroff.1.man b/contrib/pdfmark/pdfroff.1.man
index 5dd4862..99e2f15 100644
--- a/contrib/pdfmark/pdfroff.1.man
+++ b/contrib/pdfmark/pdfroff.1.man
@@ -41,12 +41,6 @@ pdfroff \- create PDF documents using groff
 .
 .hw pdfmark
 .
-.de NH
-.  hy 0
-\&\\$*
-.  hy
-..
-.
 .
 .\" ====================================================================
 .
@@ -534,12 +528,11 @@ If unspecified,
 .B \%PDFROFF_POSTPROCESSOR_COMMAND
 defaults to
 .
-.RS 2
-.IP
-.I
-.ad l
-.NH gs \-dBATCH \-dQUIET \-dNOPAUSE \-dSAFER \-sDEVICE=pdfwrite 
\-sOutputFile=\-
-.ad
+.RS 12n
+.EX
+gs \-dBATCH \-dQUIET \-dNOPAUSE \-dSAFER \-sDEVICE=pdfwrite \e
+       \-sOutputFile=\-
+.EE
 .RE
 .
 .TP
diff --git a/src/devices/grodvi/grodvi.1.man b/src/devices/grodvi/grodvi.1.man
index ec17325..4a0f6e9 100644
--- a/src/devices/grodvi/grodvi.1.man
+++ b/src/devices/grodvi/grodvi.1.man
@@ -45,8 +45,6 @@ grodvi \- convert groff output to TeX DVI format
 .  if '\\*(.T'dvi' .ft \\$1
 ..
 .
-.ad l
-.
 .
 .\" ====================================================================
 .SH SYNOPSIS
@@ -84,7 +82,7 @@ Normally it should be run by
 This will run
 .BR @address@hidden \-Tdvi ;
 it will also input the macros in
-.BR @MACRODIR@/dvi.tmac .
+.BR @MACRODIR@/\:dvi.tmac .
 .
 .LP
 The DVI file generated by
diff --git a/src/devices/gropdf/gropdf.1.man b/src/devices/gropdf/gropdf.1.man
index 0ec86c2..b493160 100644
--- a/src/devices/gropdf/gropdf.1.man
+++ b/src/devices/gropdf/gropdf.1.man
@@ -768,7 +768,7 @@ is specified as zero then the width is scaled in proportion 
to the height.
 .
 .\" .IP
 .\" See
-.\" .BR groff_tmac (@MAN5EXT@)
+.\" .BR groff_tmac (@MAN7EXT@)
 .\" for a description of the
 .\" .B PSPIC
 .\" macro which provides a convenient high-level interface for inclusion of
@@ -954,7 +954,7 @@ Install both the groff font description files and the fonts 
in a
 See the
 .B ENVIRONMENT
 section in the
-.BR troff (@MAN1EXT@)
+.BR @address@hidden (@MAN1EXT@)
 man page which lists the actual value of the font path.
 .
 Note that groff doesn't use the AFM files (but it is a good idea to
@@ -1069,18 +1069,14 @@ automatically loaded by
 .SH "SEE ALSO"
 .\" ====================================================================
 .
-.ad l
-.
 .BR \%afmtodit (@MAN1EXT@),
 .BR groff (@MAN1EXT@),
-.BR grops (@MAN1EXT@),
 .BR @address@hidden (@MAN1EXT@),
-.BR grops (@MAN1EXT@),
-.BR \%pfbtops (@MAN1EXT@),
-.BR \%groff_out (@MAN5EXT@),
 .BR \%groff_font (@MAN5EXT@),
-.BR \%groff_char (@MAN7EXT@),
-.BR \%groff_tmac (@MAN5EXT@)
+.BR \%groff_out (@MAN5EXT@)
+.\" Not actually referenced in above discussion.
+.\" .BR \%pfbtops (@MAN1EXT@),
+.\" .BR \%groff_tmac (@MAN5EXT@),
 .
 .
 .cp \n[groff_C]
diff --git a/src/roff/groff/groff.1.man b/src/roff/groff/groff.1.man
index ea6da4b..8a6e884 100644
--- a/src/roff/groff/groff.1.man
+++ b/src/roff/groff/groff.1.man
@@ -1874,7 +1874,6 @@ Bernd Warken
 .\" ====================================================================
 .SH "SEE ALSO"
 .\" ====================================================================
-.ad l
 .
 The
 .I groff info file
@@ -1929,6 +1928,7 @@ language is done by one of
 .fi
 .RE
 .
+.ad l
 .TP
 Introduction, history and further readings:
 .BR roff (@MAN7EXT@).
diff --git a/src/roff/grog/grog.1.man b/src/roff/grog/grog.1.man
index d9260f1..a6bbd60 100644
--- a/src/roff/grog/grog.1.man
+++ b/src/roff/grog/grog.1.man
@@ -451,55 +451,8 @@ Werner Lemberg
 .SH "SEE ALSO"
 .\" ====================================================================
 .
-.ad l
-.
 .BR groff (@MAN1EXT@),
 .BR groffer (@MAN1EXT@)
-.BR @address@hidden (@MAN1EXT@),
-.BR @address@hidden (@MAN1EXT@),
-.BR @address@hidden (@MAN1EXT@),
-.BR @address@hidden (@MAN1EXT@),
-.BR @address@hidden (@MAN1EXT@),
-.BR @address@hidden (@MAN1EXT@),
-.BR @address@hidden (@MAN1EXT@),
-.BR grap (1),
-.BR @address@hidden (@MAN1EXT@)
-.
-.RS
-Man pages in section 1 can be viewed with either
-.RS
-\(Do
-.BI man " name"
-.RE
-for text mode or
-.RS
-\(Do
-.BI groffer " name"
-.RE
-for graphical mode (default is PDF mode).
-.RE
-.
-.
-.P
-.BR groff_me (@MAN7EXT@),
-.BR groff_ms (@MAN7EXT@),
-.BR groff_mm (@MAN7EXT@),
-.BR groff_mom (@MAN7EXT@),
-.BR groff_man (@MAN7EXT@)
-.
-.RS
-Man pages in section 7 can be viewed with either with
-.RS
-\(Do
-.BI "man 7 " name
-.RE
-for text mode or
-.RS
-\(Do
-.BI "groffer 7 " name
-.RE
-for graphical mode (default is PDF mode).
-.RE
 .
 .
 .\" ====================================================================
diff --git a/tmac/groff_ms.7.man b/tmac/groff_ms.7.man
index 4e2048e..d5fd2c6 100644
--- a/tmac/groff_ms.7.man
+++ b/tmac/groff_ms.7.man
@@ -1780,7 +1780,6 @@ Larry Kollar
 .
 .
 .\" ====================================================================
-.ad l
 .SH "SEE ALSO"
 .\" ====================================================================
 .
@@ -1789,9 +1788,12 @@ Larry Kollar
 .BR @address@hidden (@MAN1EXT@),
 .BR @address@hidden (@MAN1EXT@),
 .BR @address@hidden (@MAN1EXT@),
-.BR @address@hidden (@MAN1EXT@),
-.I Groff: The GNU Implementation of troff
-by Trent Fisher and Werner Lemberg.
+.BR @address@hidden (@MAN1EXT@)
+.
+.
+.PP
+.IR "Groff: The GNU Implementation of troff" ,
+by Trent A.\& Fisher and Werner Lemberg
 .
 .
 .cp \n[groff_ms_C]