groff-commit
[Top][All Lists]
Advanced

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

[groff] 19/31: [man pages]: Fix style nits.


From: G. Branden Robinson
Subject: [groff] 19/31: [man pages]: Fix style nits.
Date: Mon, 31 Jan 2022 11:28:11 -0500 (EST)

gbranden pushed a commit to branch master
in repository groff.

commit 97275653196eeb3a93332667c8216a89536dc5dc
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Sun Jan 30 06:35:54 2022 +1100

    [man pages]: Fix style nits.
    
    Permit trailing non-quotation punctuation after metasyntactic variable
    names to be in italics.  These are less likely to acquire semantic tags
    in the future than file names or command names are, because they are far
    less likely to be copied and pasted, and they typeset better this way
    (though they look slightly weirder on underlining terminals).
---
 src/utils/tfmtodit/tfmtodit.1.man |  6 +++---
 tmac/groff_man.7.man.in           | 30 +++++++++++++++---------------
 2 files changed, 18 insertions(+), 18 deletions(-)

diff --git a/src/utils/tfmtodit/tfmtodit.1.man 
b/src/utils/tfmtodit/tfmtodit.1.man
index bfb6a460..372c66ef 100644
--- a/src/utils/tfmtodit/tfmtodit.1.man
+++ b/src/utils/tfmtodit/tfmtodit.1.man
@@ -104,7 +104,7 @@ special character identifiers for the glyph.
 If a glyph has no
 .I groff
 names but exists in
-.IR tfm-file ,
+.I tfm-file,
 it is put in the
 .I groff
 font description file as an unnamed character.
@@ -144,7 +144,7 @@ will automatically mount it when it is first used.
 To do a good job of math typesetting,
 .I groff
 requires font metric information not present in
-.IR tfm-file .
+.I tfm-file.
 .
 This is because \*(tx has separate math italic fonts,
 whereas
@@ -245,7 +245,7 @@ commands to obtain additional font metric information.
 .TP
 .BI \-k \~skew-char
 The skew charcter of this font is at position
-.IR skew-char .
+.I skew-char.
 .
 .I skew-char
 should be an integer;
diff --git a/tmac/groff_man.7.man.in b/tmac/groff_man.7.man.in
index 623461eb..2e27a753 100644
--- a/tmac/groff_man.7.man.in
+++ b/tmac/groff_man.7.man.in
@@ -349,7 +349,7 @@ macros.
 Define the title of the man page as
 .I title
 and the volume of the manual to which it belongs as
-.IR section .
+.I section.
 _ifstyle()dnl
 .
 This use of \(lqsection\(rq has nothing to do with the section headings
@@ -394,7 +394,7 @@ except in the continuous-rendering mode enabled by the 
option
 in which case it is the
 .I title
 and
-.IR section ,
+.I section,
 as in the header.
 .
 .I header-middle
@@ -404,7 +404,7 @@ If
 .I section
 is a simple integer between 1 and\~9 (inclusive),
 there is no need to specify
-.IR header-middle ;
+.I header-middle;
 .I an.tmac
 will supply text for it.
 .
@@ -614,7 +614,7 @@ installation.
 .IR indentation ]
 Start a new relative inset level,
 moving the left margin right by
-.IR indentation ,
+.I indentation,
 if specified,
 and by a default amount otherwise;
 see subsection \(lqHorizontal and vertical spacing\(rq below.
@@ -635,7 +635,7 @@ calls is\~1.
 .IR level ]
 End a relative inset;
 move the left margin back to that corresponding to inset level
-.IR level .
+.I level.
 .
 If no argument is given,
 move the left margin one level back.
@@ -717,11 +717,11 @@ and the remainder of the paragraph indented.
 .
 The input line following this macro,
 known as the
-.IR tag ,
+.I tag,
 is printed at the current left margin.
 .
 Subsequent text is indented by
-.IR indentation ,
+.I indentation,
 if specified,
 and by a default amount otherwise;
 see subsection \(lqHorizontal and vertical spacing\(rq below.
@@ -1303,7 +1303,7 @@ supports hyperlinks.
 If it does not,
 .I address
 is set in angle brackets after the link text and before
-.IR trailing-text .
+.I trailing-text.
 _ifstyle()dnl
 .
 .
@@ -1350,7 +1350,7 @@ supports hyperlinks.
 If it does not,
 .I uri
 is set in angle brackets after the link text and before
-.IR trailing-text .
+.I trailing-text.
 _ifstyle()dnl
 .
 .
@@ -1546,7 +1546,7 @@ the text of the next input line is set smaller.
 .
 _ifstyle()dnl
 .IP
-.IR Note :
+.I Note:
 terminals will render
 .I text
 at normal size instead.
@@ -1574,7 +1574,7 @@ the text of the next input line is set smaller and in 
bold.
 .
 _ifstyle()dnl
 .IP
-.IR Note :
+.I Note:
 terminals will render
 .I text
 in bold at the normal size instead.
@@ -1732,7 +1732,7 @@ _ifstyle()dnl
 The
 \&.I groff
 font file is written to
-\&.IR font .
+\&.I font.
 .EE
 .RE
 .
@@ -3103,7 +3103,7 @@ macro package.
 .TP
 .BI \-dAD= adjustment-mode
 Set line adjustment to
-.IR adjustment-mode ,
+.I adjustment-mode,
 which is typically
 .RB \[lq] b \[rq]
 for adjustment to both margins
@@ -3188,7 +3188,7 @@ in subsection \(lqDocument structure macros\(rq above.
 .TP
 .BI \-rFT= footer-distance
 Set distance of the footer relative to the bottom of the page to
-.IR footer-distance ;
+.I footer-distance;
 this amount is always negative.
 .
 At twice this distance,
@@ -3734,7 +3734,7 @@ as an argument;
 the
 .B .RE
 macro's argument is a specific
-.IR "inset level" .
+.I inset level.
 .
 .B .RE\~1
 goes to the level before any



reply via email to

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