groff-commit
[Top][All Lists]
Advanced

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

[groff] 13/32: groff_diff(7): Fix markup/style nit.


From: G. Branden Robinson
Subject: [groff] 13/32: groff_diff(7): Fix markup/style nit.
Date: Sun, 18 Jun 2023 00:31:11 -0400 (EDT)

gbranden pushed a commit to branch master
in repository groff.

commit 284a3d435ce3ef7c4f83c20a33cf51663e459dc3
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Fri Jun 16 00:33:42 2023 -0500

    groff_diff(7): Fix markup/style nit.
    
    Stop setting "AT&T troff" with an unbreakable space.
---
 man/groff_diff.7.man | 102 +++++++++++++++++++++++++++------------------------
 1 file changed, 54 insertions(+), 48 deletions(-)

diff --git a/man/groff_diff.7.man b/man/groff_diff.7.man
index af853ecb6..12c7ee35c 100644
--- a/man/groff_diff.7.man
+++ b/man/groff_diff.7.man
@@ -69,8 +69,8 @@ The GNU
 .I roff
 text processing system,
 .IR groff ,
-is largely compatible with
-.RI AT&T\~ troff ,
+is largely compatible with AT&T
+.IR troff , \" AT&T
 the typesetting system originating in Unix systems of the 1970s.
 .
 At the same time,
@@ -81,8 +81,8 @@ device-independent output format.
 .
 Differences arising from
 .IR groff 's
-implementation of
-.RI AT&T\~ troff
+implementation of AT&T
+.I troff \" AT&T
 features are also noted.
 .
 .
@@ -97,8 +97,8 @@ adds new escape sequences and requests,
 provides new conditional expression operators,
 recognizes additional scaling units and numeric operators,
 and extends the function of some escape sequences and requests
-present in
-.RI AT&T\~ troff .
+present in AT&T
+.IR troff . \" AT&T
 .
 .
 .\" ====================================================================
@@ -118,8 +118,8 @@ special characters (glyphs),
 and colors can be of any length.
 .
 More generally,
-anywhere
-.RI AT&T\~ troff
+anywhere AT&T
+.I troff \" AT&T
 supports an escape form that uses an opening parenthesis \[lq](\[rq]
 to introduce a two-character argument,
 .I groff
@@ -523,8 +523,8 @@ implementations only.
 .
 (This refers to
 .IR vtroff ,
-a translator that would convert the C/A/T output from early-vintage
-.RI AT&T\~ troff
+a translator that would convert the C/A/T output from early-vintage AT&T
+.I troff \" AT&T
 to a form suitable for Versatec and Benson-Varian plotters.)
 .
 .
@@ -560,8 +560,8 @@ whereas strokes have a line thickness
 .
 .I groff
 introduces several new escape sequences
-and extends the syntax of a few
-.RI AT&T\~ troff
+and extends the syntax of a few AT&T
+.I troff \" AT&T
 escape sequences
 (namely,
 .BR \[rs]D ,
@@ -1027,8 +1027,8 @@ permitted for the argument to
 .B \[rs]X
 to contain newlines).
 .
-The inclusion of newlines requires an extension to the
-.RI AT&T\~ troff
+The inclusion of newlines requires an extension to the AT&T
+.I troff \" AT&T
 output format,
 and confuses drivers that do not know about this extension.
 .
@@ -3918,8 +3918,8 @@ which, when reread, will cause the contents of
 .I filename
 to be transparently copied through to the output.
 .
-In
-.RI AT&T\~ troff,
+In AT&T
+.IR troff ,
 the contents of
 .I filename
 are immediately copied through to the output regardless of whether there
@@ -4524,7 +4524,8 @@ fixed at compile time.
 .B \[rs]n[year]
 The current year.
 .
-.RI AT&T\~ troff 's
+AT&T
+.IR troff 's \" AT&T
 .B \[rs]n[yr]
 register stores the current year minus 1900.
 .
@@ -4970,7 +4971,8 @@ Set the line thickness to
 .IR n \~\c
 basic units.
 .
-.RI AT&T\~ troff
+AT&T
+.I troff \" AT&T
 output drivers use a thickness proportional to the type size;
 this is the GNU
 .I troff \" GNU
@@ -5004,7 +5006,8 @@ is not
 .B c
 or
 .BR e ,
-.RI AT&T\~ troff
+AT&T
+.I troff \" AT&T
 treats each $x sub i$ as a horizontal motion,
 each $y sub i$ as a vertical one,
 and therefore assumes that the width of the drawn object is
@@ -5196,8 +5199,8 @@ text.
 .
 .P
 .I groff
-does not always hyphenate words as
-.RI AT&T\~ troff
+does not always hyphenate words as AT&T
+.I troff \" AT&T
 does.
 .
 The AT&T implementation uses a set of hard-coded rules specific to
@@ -5222,7 +5225,8 @@ Long names may be
 .IR groff 's
 most obvious innovation.
 .
-.RI AT&T\~ troff
+AT&T
+.I troff \" AT&T
 interprets
 .RB \[lq] .dsabcd \[rq]
 as defining a string
@@ -5235,7 +5239,8 @@ Normally,
 interprets this as a call of a macro named
 .RB \[lq] dsabcd \[rq].
 .
-.RI AT&T\~ troff
+AT&T
+.I troff \" AT&T
 also interprets
 .B \[rs]*[
 and
@@ -5310,8 +5315,8 @@ layers of inclusion.
 You cannot use the same register name everywhere lest you
 \[lq]clobber\[rq] the value from a preceding or enclosing context.
 .
-The two-character register name space of
-.RI AT&T\~ troff
+The two-character register name space of AT&T
+.I troff \" AT&T
 is confining and mnemonically challenging;
 you may wish to use
 .IR groff 's
@@ -5510,7 +5515,8 @@ macros,
 diversions,
 registers,
 fonts, or environments;
-.RI AT&T\~ troff
+AT&T
+.I troff \" AT&T
 does.
 .
 The
@@ -5528,8 +5534,8 @@ accepts only a single character
 (a digit)
 for
 .IR n ,
-consistently with other forms that originated in
-.RI AT&T\~ troff ,
+consistently with other forms that originated in AT&T
+.IR troff , \" AT&T
 like
 .BR \[rs]* ,
 .BR \[rs]$ ,
@@ -5552,8 +5558,8 @@ form.
 .
 [Background:
 The Graphic Systems C/A/T phototypesetter
-(the original device target for
-.RI AT&T\~ troff )
+(the original device target for AT&T
+.IR troff ) \" AT&T
 supported only a few discrete type sizes in the range 6\[en]36 points,
 so Ossanna contrived a special case in the parser to do what the user
 must have meant.
@@ -5566,8 +5572,8 @@ McIlroy referred to it as a \[lq]living fossil\[rq].]
 .P
 Fractional type sizes cause one noteworthy incompatibility.
 .
-In
-.RI AT&T\~ troff
+In AT&T
+.I troff \" AT&T
 the
 .B .ps
 request ignores scaling units and thus
@@ -5608,8 +5614,8 @@ does.
 .
 .
 .P
-In
-.RI AT&T\~ troff
+In AT&T
+.I troff \" AT&T
 the
 .B .pm
 request reports
@@ -5626,8 +5632,8 @@ ignores any arguments and reports the sizes in bytes.
 .
 .
 .P
-Unlike
-.RI AT&T\~ troff ,
+Unlike AT&T
+.IR troff , \" AT&T
 .I groff
 does not ignore the
 .B .ss
@@ -5718,8 +5724,8 @@ this always prints a single instance of the current 
escape character,
 regardless of whether or not it is used in a diversion;
 it also works in both
 .I groff
-and
-.RI AT&T\~ troff .
+and AT&T
+.IR troff . \" AT&T
 .
 (Naturally,
 if you've changed the escape character,
@@ -5741,8 +5747,8 @@ or
 for \[lq]reverse solidus\[rq],
 from its name in the ECMA-6 (ISO/IEC\~646) standard.
 .
-[This escape sequence is not portable to
-.RI AT&T\~ troff ,
+[This escape sequence is not portable to AT&T
+.IR troff , \" AT&T
 but is to its lineal descendant,
 Heirloom Doctools
 .IR troff ,
@@ -5788,8 +5794,8 @@ Its extensions notwithstanding,
 the
 .I groff
 intermediate output format has some incompatibilities
-with that of
-.RI AT&T\~ troff ,
+with that of AT&T
+.IR troff , \" AT&T
 but full compatibility is sought;
 problem reports and patches are welcome.
 .
@@ -5797,14 +5803,14 @@ The following incompatibilities are known.
 .
 .
 .IP \[bu]
-The positioning after drawing polygons conflicts with the
-.RI AT&T\~ troff
+The positioning after drawing polygons conflicts with the AT&T
+.I troff \" AT&T
 practice.
 .
 .
 .IP \[bu]
-The intermediate output cannot be rescaled to other devices as
-.RI AT&T\~ troff 's
+The intermediate output cannot be rescaled to other devices as AT&T
+.IR troff 's \" AT&T
 could.
 .
 .
@@ -5842,8 +5848,8 @@ 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].
+documentation as AT&T
+.IR troff . \" AT&T
 .
 .
 .PP



reply via email to

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