groff-commit
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

[groff] 02/09: man pages: Avoid hyphenation of directory names.


From: G. Branden Robinson
Subject: [groff] 02/09: man pages: Avoid hyphenation of directory names.
Date: Sat, 15 Aug 2020 13:15:53 -0400 (EDT)

gbranden pushed a commit to branch master
in repository groff.

commit 488d1ca393ab274a830d89bc14633ccac8a7d8e6
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Sat Aug 15 23:28:54 2020 +1000

    man pages: Avoid hyphenation of directory names.
    
    ...when we cannot know their contents due to their being
    configuration-time variables.  Strictly, this hyphenation protection
    applies only to the portion of the filename up to the first \:, but (1)
    a user won't be putting that sequence into a ./configure argument, and
    (2) a diffrerent strategy is forthcoming for the \: escapes we supply.
---
 contrib/mom/groff_mom.7.man       | 12 ++++++------
 src/devices/grodvi/grodvi.1.man   | 10 +++++-----
 src/devices/grolj4/lj4_font.5.man |  8 ++++----
 src/roff/nroff/nroff.1.man        |  4 ++--
 src/utils/afmtodit/afmtodit.1.man | 12 ++++++------
 src/utils/hpftodit/hpftodit.1.man |  6 +++---
 src/utils/pfbtops/pfbtops.1.man   |  4 ++--
 tmac/groff_man.7.man.in           | 12 ++++++------
 8 files changed, 34 insertions(+), 34 deletions(-)

diff --git a/contrib/mom/groff_mom.7.man b/contrib/mom/groff_mom.7.man
index a96ac3b..4094bc8 100644
--- a/contrib/mom/groff_mom.7.man
+++ b/contrib/mom/groff_mom.7.man
@@ -199,23 +199,23 @@ usage.
 .\" ====================================================================
 .
 .TP
-.I @MACRODIR@/\:om.tmac
+.I \%@MACRODIR@/\:om.tmac
 \[en] the main macro file
 .TQ
-.I @MACRODIR@/\:mom.tmac
+.I \%@MACRODIR@/\:mom.tmac
 \[en] a wrapper file that calls om.tmac directly.
 .
 .TP
-.I @HTMLDOCDIR@/\:mom/\:toc.html
+.I \%@HTMLDOCDIR@/\:mom/\:toc.html
 \[en] entry point to the HTML documentation
 .
 .TP
-.I @PDFDOCDIR@/\:mom\-pdf.pdf
+.I \%@PDFDOCDIR@/\:mom\-pdf.pdf
 \[en] the PDF manual,
 .I Producing PDFs with groff and mom
 .
 .TP
-.IR @EXAMPLEDIR@/\:mom/\: * .mom
+.IR \%@EXAMPLEDIR@/\:mom/\: * .mom
 \[en] example files using mom
 .
 .
@@ -239,7 +239,7 @@ and
 is very well documented in
 .
 .TP
-.I @HTMLDOCDIR@/\:mom/\:toc.html
+.I \%@HTMLDOCDIR@/\:mom/\:toc.html
 \[en] entry point to the HTML documentation
 .
 .
diff --git a/src/devices/grodvi/grodvi.1.man b/src/devices/grodvi/grodvi.1.man
index 5e98784..c3d74eb 100644
--- a/src/devices/grodvi/grodvi.1.man
+++ b/src/devices/grodvi/grodvi.1.man
@@ -77,7 +77,7 @@ Normally it should be run by
 This will run
 .BR @g@troff\ \-Tdvi ;
 it will also input the macros in
-.IR @MACRODIR@/\:dvi.tmac .
+.IR \%@MACRODIR@/\:dvi.tmac .
 .
 .LP
 The DVI file generated by
@@ -411,21 +411,21 @@ for more details.
 .\" ====================================================================
 .
 .TP
-.I @FONTDIR@/devdvi/DESC
+.I \%@FONTDIR@/devdvi/DESC
 Device description file.
 .
 .TP
-.IR @FONTDIR@/devdvi/ F
+.IR \%@FONTDIR@/devdvi/ F
 Font description file for font
 .IR F .
 .
 .TP
-.I @MACRODIR@/dvi.tmac
+.I \%@MACRODIR@/dvi.tmac
 Macros for use with
 .BR grodvi .
 .
 .TP
-.I @MACRODIR@/ec.tmac
+.I \%@MACRODIR@/ec.tmac
 Macros to switch to EC fonts.
 .
 .
diff --git a/src/devices/grolj4/lj4_font.5.man 
b/src/devices/grolj4/lj4_font.5.man
index fb6f83d..a293ff6 100644
--- a/src/devices/grolj4/lj4_font.5.man
+++ b/src/devices/grolj4/lj4_font.5.man
@@ -200,7 +200,7 @@ and braces used by
 .
 A script,
 located in
-.IR @FONTDIR@/\:devlj4/\:generate ,
+.IR \%@FONTDIR@/\:devlj4/\:generate ,
 can be used to adjust the metrics for these glyphs in the special font
 \[lq]S\[rq] for use with printers that have all TrueType fonts.
 .
@@ -231,18 +231,18 @@ and one for more recent TFM files.
 .\" ====================================================================
 .
 .TP
-.I @FONTDIR@/\:devlj4/\:DESC
+.I \%@FONTDIR@/\:devlj4/\:DESC
 device description file
 .
 .
 .TP
-.IR @FONTDIR@/\:devlj4/\: F
+.IR \%@FONTDIR@/\:devlj4/\: F
 font description file for font
 .I F
 .
 .
 .TP
-.I @FONTDIR@/\:devlj4/\:generate
+.I \%@FONTDIR@/\:devlj4/\:generate
 corrects Intellifont-based height metrics for several glyphs in the
 special font for TrueType CG Times (LaserJet\~4000 and later).
 .
diff --git a/src/roff/nroff/nroff.1.man b/src/roff/nroff/nroff.1.man
index bb97c66..6d0aee1 100644
--- a/src/roff/nroff/nroff.1.man
+++ b/src/roff/nroff/nroff.1.man
@@ -218,7 +218,7 @@ executable before searching in
 .IR PATH .
 .
 If unset,
-.I @BINDIR@
+.I \%@BINDIR@
 is used.
 .
 .
@@ -263,7 +263,7 @@ see
 .
 .P
 Character definitions in the file
-.I @MACRODIR@/\:tty\-char.tmac
+.I \%@MACRODIR@/\:tty\-char.tmac
 are loaded to replace unrepresentable glyphs.
 .
 .
diff --git a/src/utils/afmtodit/afmtodit.1.man 
b/src/utils/afmtodit/afmtodit.1.man
index ddf8997..9e0a208 100644
--- a/src/utils/afmtodit/afmtodit.1.man
+++ b/src/utils/afmtodit/afmtodit.1.man
@@ -173,7 +173,7 @@ option is used.
 .LP
 If there is a downloadable font file for the font, it may be listed in
 the file
-.IR @FONTDIR@/\:devps/\:download ;
+.IR \%@FONTDIR@/\:devps/\:download ;
 see
 .IR grops (@MAN1EXT@).
 .
@@ -395,28 +395,28 @@ Don't use the built-in Adobe Glyph List.
 .\" ====================================================================
 .
 .TP
-.I @FONTDIR@/\:devps/\:DESC
+.I \%@FONTDIR@/\:devps/\:DESC
 Device description file.
 .
 .
 .TP
-.IR @FONTDIR@/\:devps/\: F
+.IR \%@FONTDIR@/\:devps/\: F
 Font description file for font
 .IR F .
 .
 .
 .TP
-.I @FONTDIR@/\:devps/\:download
+.I \%@FONTDIR@/\:devps/\:download
 List of downloadable fonts.
 .
 .
 .TP
-.I @FONTDIR@/\:devps/\:text.enc
+.I \%@FONTDIR@/\:devps/\:text.enc
 Encoding used for text fonts.
 .
 .
 .TP
-.I @FONTDIR@/\:devps/\:generate/\:textmap
+.I \%@FONTDIR@/\:devps/\:generate/\:textmap
 Standard mapping.
 .
 .
diff --git a/src/utils/hpftodit/hpftodit.1.man 
b/src/utils/hpftodit/hpftodit.1.man
index 4d9aa85..d9ec21a 100644
--- a/src/utils/hpftodit/hpftodit.1.man
+++ b/src/utils/hpftodit/hpftodit.1.man
@@ -388,18 +388,18 @@ a value of 50 (0.05\~em) usually is a reasonable choice.
 .\" ====================================================================
 .
 .TP
-.I @FONTDIR@/\:devlj4/\:DESC
+.I \%@FONTDIR@/\:devlj4/\:DESC
 device description file
 .
 .
 .TP
-.IR @FONTDIR@/\:devlj4/\: F
+.IR \%@FONTDIR@/\:devlj4/\: F
 Font description file for font
 .I F
 .
 .
 .TP
-.IR @FONTDIR@/\:devlj4/\:generate/\: * .map
+.IR \%@FONTDIR@/\:devlj4/\:generate/\: * .map
 symbol mapping files
 .
 .
diff --git a/src/utils/pfbtops/pfbtops.1.man b/src/utils/pfbtops/pfbtops.1.man
index 923ef80..9878042 100644
--- a/src/utils/pfbtops/pfbtops.1.man
+++ b/src/utils/pfbtops/pfbtops.1.man
@@ -68,9 +68,9 @@ PostScript fonts for MS-DOS are normally supplied in PFB 
format.
 .LP
 The resulting ASCII format PostScript font can be used with groff,
 if it is first listed in
-.I @FONTDIR@/\:devps/\:download
+.I \%@FONTDIR@/\:devps/\:download
 and
-.IR @FONTDIR@/\:devpdf/\:download .
+.IR \%@FONTDIR@/\:devpdf/\:download .
 .
 .
 .\" ====================================================================
diff --git a/tmac/groff_man.7.man.in b/tmac/groff_man.7.man.in
index f91d600..6796b8c 100644
--- a/tmac/groff_man.7.man.in
+++ b/tmac/groff_man.7.man.in
@@ -3041,15 +3041,15 @@ _endif()dnl
 .\" ====================================================================
 .
 .TP
-.I @MACRODIR@/\:man.tmac
+.I \%@MACRODIR@/\:man.tmac
 .TQ
-.I @MACRODIR@/\:an.tmac
+.I \%@MACRODIR@/\:an.tmac
 These are wrapper files to call
 .IR andoc.tmac .
 .
 .
 .TP
-.I @MACRODIR@/\:andoc.tmac
+.I \%@MACRODIR@/\:andoc.tmac
 This brief
 .I groff
 program detects whether the
@@ -3081,7 +3081,7 @@ can be handled.
 .
 .
 .TP
-.I @MACRODIR@/\:an\-old.tmac
+.I \%@MACRODIR@/\:an\-old.tmac
 Most
 .I man
 macros are contained in this file.
@@ -3092,7 +3092,7 @@ It also loads the extensions from
 .
 .
 .TP
-.I @MACRODIR@/\:an\-ext.tmac
+.I \%@MACRODIR@/\:an\-ext.tmac
 The extension macro definitions for
 .BR .SY ,
 .BR .OP ,
@@ -3135,7 +3135,7 @@ implementations that may give up their scan for indexing 
material early.
 .
 .
 .TP
-.I @LOCALMACRODIR@/\:man.local
+.I \%@LOCALMACRODIR@/\:man.local
 Put local changes and customizations into this file.
 _ifstyle()dnl
 .



reply via email to

[Prev in Thread] Current Thread [Next in Thread]