groff-commit
[Top][All Lists]
Advanced

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

[groff] 03/31: [man pages]: Drop unnecessary use of \& escapes.


From: G. Branden Robinson
Subject: [groff] 03/31: [man pages]: Drop unnecessary use of \& escapes.
Date: Mon, 31 Jan 2022 11:27:59 -0500 (EST)

gbranden pushed a commit to branch master
in repository groff.

commit 088728509364309889d0e320fb9608751cdf0526
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Sat Jan 29 02:02:54 2022 +1100

    [man pages]: Drop unnecessary use of \& escapes.
    
    Use of the non-printing input break \& _before_ a dot is a recommended
    practice to prevent the dot from becoming misinterprted as a control
    character when a text line is reflowed/refilled in a text editor.
    
    However, this reasoning does not apply to control lines, which generally
    cannot be reflowed without damaging the document.
    
    So get rid of 'em.
---
 contrib/eqn2graph/eqn2graph.1.man   | 2 +-
 contrib/grap2graph/grap2graph.1.man | 4 ++--
 contrib/mom/groff_mom.7.man         | 4 ++--
 contrib/pic2graph/pic2graph.1.man   | 4 ++--
 man/groff_diff.7.man                | 6 +++---
 tmac/groff_mdoc.7.man               | 4 ++--
 6 files changed, 12 insertions(+), 12 deletions(-)

diff --git a/contrib/eqn2graph/eqn2graph.1.man 
b/contrib/eqn2graph/eqn2graph.1.man
index 767c1e7c..4df3a267 100644
--- a/contrib/eqn2graph/eqn2graph.1.man
+++ b/contrib/eqn2graph/eqn2graph.1.man
@@ -55,7 +55,7 @@ to the standard output.
 The input EQN code should
 .I not
 be preceded by the
-.B \&.EQ
+.B .EQ
 macro that normally precedes it within
 .MR groff @MAN1EXT@
 macros;
diff --git a/contrib/grap2graph/grap2graph.1.man 
b/contrib/grap2graph/grap2graph.1.man
index c054aabd..76b7cd06 100644
--- a/contrib/grap2graph/grap2graph.1.man
+++ b/contrib/grap2graph/grap2graph.1.man
@@ -56,9 +56,9 @@ to the standard output.
 The input GRAP code should
 .I not
 be wrapped with the
-.B \&.G1
+.B .G1
 and
-.B \&.G2
+.B .G2
 macros that normally guard it within
 .MR groff @MAN1EXT@
 documents.
diff --git a/contrib/mom/groff_mom.7.man b/contrib/mom/groff_mom.7.man
index 7f0c1b71..ca8b3fb7 100644
--- a/contrib/mom/groff_mom.7.man
+++ b/contrib/mom/groff_mom.7.man
@@ -140,7 +140,7 @@ but processing is passed over to
 which uses
 .B groff's
 PostScript driver,
-.BR grops \&.
+.BR grops .
 Not all
 .I PDF
 features are available when
@@ -1196,7 +1196,7 @@ Decimal fractions are allowed.
 To set a nominal bottom margin of 3/4 inch, enter
 .RS
 .EX
-.B \&.B_MARGIN \&.75i
+.B .B_MARGIN .75i
 .EE
 .RE
 .
diff --git a/contrib/pic2graph/pic2graph.1.man 
b/contrib/pic2graph/pic2graph.1.man
index 0a9b5961..d3034d1e 100644
--- a/contrib/pic2graph/pic2graph.1.man
+++ b/contrib/pic2graph/pic2graph.1.man
@@ -63,9 +63,9 @@ formulae.
 The input PIC code should
 .I not
 be wrapped with the
-.B \&.PS
+.B .PS
 and
-.BR \&.PE / \&.PF
+.BR .PE / .PF
 macros that normally guard it within
 .MR groff @MAN1EXT@
 documents.
diff --git a/man/groff_diff.7.man b/man/groff_diff.7.man
index c404e5b3..c2047ea1 100644
--- a/man/groff_diff.7.man
+++ b/man/groff_diff.7.man
@@ -3077,11 +3077,11 @@ due to the regular glyph naming convention for accented 
characters.
 .RS
 .RS
 .EX
-.B \&.ds resume R\e[\[aq]e]sum\e[\[aq]e]\e"
+.B .ds resume R\e[\[aq]e]sum\e[\[aq]e]\e"
 .B \e*[resume]
-.B \&.stringdown resume
+.B .stringdown resume
 .B \e*[resume]
-.B \&.stringup resume
+.B .stringup resume
 .B \e*[resume]
 R\['e]sum\['e] r\['e]sum\['e] R\['E]SUM\['E]
 .EE
diff --git a/tmac/groff_mdoc.7.man b/tmac/groff_mdoc.7.man
index c16bde5c..b76af7c5 100644
--- a/tmac/groff_mdoc.7.man
+++ b/tmac/groff_mdoc.7.man
@@ -4872,14 +4872,14 @@ Section 3f has not been added to the header routines.
 .
 .
 .Pp
-.Ql \&.Nm
+.Ql .Nm
 font should be changed in
 .Em Name
 section.
 .
 .
 .Pp
-.Ql \&.Fn
+.Ql .Fn
 needs to have a check to prevent splitting up the line if its length is
 too short.
 .



reply via email to

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