[Top][All Lists]

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

[groff] 01/01: man/ Update \s discussion.

From: G. Branden Robinson
Subject: [groff] 01/01: man/ Update \s discussion.
Date: Mon, 13 Apr 2020 10:21:54 -0400 (EDT)

gbranden pushed a commit to branch master
in repository groff.

commit 086b3d03f68468cd5ac900c2baa3c6e6c5f2a559
Author: G. Branden Robinson <address@hidden>
AuthorDate: Tue Apr 14 00:14:42 2020 +1000

    man/ Update \s discussion.
    1. Drop documentation of \s(nn and \s±(nn forms.  They're in CSTR #54.
    2. In the \s[] and \s'' forms, set the ± in italics, not bold.  It's
       parametric, not literal, input.
    3. Add paragraph to incompatibilities section regarding the handling of
       \sN and compatibility mode.
 man/ | 59 +++++++++++++++++++++++++++++++++++++++-------------
 1 file changed, 45 insertions(+), 14 deletions(-)

diff --git a/man/ b/man/
index c931981..3565830 100644
--- a/man/
+++ b/man/
@@ -559,23 +559,13 @@ This has the same effect as
-.BI \[rs]s( nn
-.BI \[rs]s\[+-]( nn
-Set the point size to
-.I nn
-.I nn
-must be exactly two digits.
-.BI \[rs]s[\[+-] n ]
+.BI \[rs]s[ \[+-]n ]
-.BI \[rs]s\[+-][ n ]
+.BI \[rs]s \[+-] [ n ]
-.BI \[rs]s'\[+-] n '
+.BI \[rs]s' \[+-]n '
-.BI \[rs]s\[+-]' n '
+.BI \[rs]s \[+-] ' n '
 Set the point size to
 .I n
 scaled points;
@@ -3832,6 +3822,47 @@ sets the point size to 10\~points, whereas in groff 
native mode the
 point size is set to 10\~scaled points.
+The escape
+.BI \[rs]s n
+sets the point size to
+.I n
+scaled points;
+.I n
+must be exactly one digit and
+is a numeric expression with a default scale indicator
+.RB of\~ z\c
+.I troff
+would read an additional digit,
+as will
+.I groff
+in compatibility mode,
+.I n
+is 1, 2, or 3,
+because the Graphic Systems C/A/T phototypesetter
+(its original device target)
+only supported a few discrete point sizes in the range 6\[en]36,
+so Ossanna special-cased the parser to do what the user must have meant.
+Kernighan warned of this in the 1992 revision of CSTR\~#54 (\[sc]2.3),
+and more recently,
+McIlroy referred to it as a \[lq]living fossil\[rq].
+.I groff
+will emit an error message in compatibility mode when this ambiguous
+syntax is encountered.
+Use the portable
+.BI \[rs]s( nn
+form for two-digit point sizes,
+or the new forms of
+.B \[rs]s
+documented above.
 .IR groff ,
 there is a fundamental difference between unformatted input

reply via email to

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