[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[groff] 01/02: Fix documentation nits.
From: |
G. Branden Robinson |
Subject: |
[groff] 01/02: Fix documentation nits. |
Date: |
Thu, 28 May 2020 19:07:49 -0400 (EDT) |
gbranden pushed a commit to branch master
in repository groff.
commit 7a679909ff8c3ee3535e4ef218b50a28b788daa3
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Fri May 29 04:13:23 2020 +1000
Fix documentation nits.
* doc/groff.texi: Remove unnecessary paragraph break. Wrap long line.
* man/groff.7.man: Stop protecting ellipsis at end of sentence from
end-of-sentence detection (it doesn't matter in this case since it
also ends a paragraph [and section]), but it's a poor example to set.
* man/groff_diff.7.man: Assert support of \D escape for AT&T troff
commands (that they're not _perfectly_ compatible is covered in
section "Implementation Differences"). Remove unnecessary paragraph
break. Fix spelling typo. Fix missing-word typo.
---
doc/groff.texi | 11 +++++------
man/groff.7.man | 2 +-
man/groff_diff.7.man | 18 ++++++++++--------
3 files changed, 16 insertions(+), 15 deletions(-)
diff --git a/doc/groff.texi b/doc/groff.texi
index 0d95e1d..3b6f475 100644
--- a/doc/groff.texi
+++ b/doc/groff.texi
@@ -7146,9 +7146,9 @@ Enable @dfn{no-space mode}. In this mode, spacing
(either via @code{sp}
or via blank lines) is disabled. The @code{bp} request to advance to
the next page is also disabled, except if it is accompanied by a page
number (see @ref{Page Control}, for more information). This mode ends
-when actual text is output or the @code{rs} request is encountered, which
-ends no-space mode. The read-only number register @code{.ns} is set
-to@tie{}1 as long as no-space mode is active.
+when actual text is output or the @code{rs} request is encountered,
+which ends no-space mode. The read-only number register @code{.ns} is
+set to@tie{}1 as long as no-space mode is active.
This request is useful for macros that conditionally insert vertical
space before the text starts (for example, a paragraph macro could
@@ -14484,9 +14484,8 @@ avoiding use of these escape sequences in names.
Normally, the syntax form @code{\s}@var{n} accepts only a single
character (a digit) for @var{n}, consistently with other forms that
originated in @acronym{AT&T} @code{troff}, like @code{\*}, @code{\$},
-@code{\f}, @code{\g}, @code{\k}, @code{\n}, and @code{\z}.
-
-In compatibility mode only, a non-zero@tie{}@var{n} must be in the range
+@code{\f}, @code{\g}, @code{\k}, @code{\n}, and @code{\z}. In
+compatibility mode only, a non-zero@tie{}@var{n} must be in the range
4--39. Legacy documents relying upon this quirk of parsing@footnote{The
Graphic Systems C/A/T phototypesetter (the original device target for
@acronym{AT&T} @code{troff}) supported only a few discrete point sizes
diff --git a/man/groff.7.man b/man/groff.7.man
index 6c0c652..e548d73 100644
--- a/man/groff.7.man
+++ b/man/groff.7.man
@@ -3082,7 +3082,7 @@ A glyph with name
A composite glyph with components
.IR comp1 ,
.IR comp2 ,
-\&.\|.\|.\&
+\&.\|.\|.
.
.\" ========= alphabetical escapes =========
.
diff --git a/man/groff_diff.7.man b/man/groff_diff.7.man
index c42a8dc..b069f0b 100644
--- a/man/groff_diff.7.man
+++ b/man/groff_diff.7.man
@@ -222,7 +222,7 @@ A further two new measurement units available in
.I groff
are
.RB \[lq] M \[rq],
-which indicates hundredeths of an em,
+which indicates hundredths of an em,
and
.RB \[lq] f \[rq],
which is defined as 65536 basic units.
@@ -434,10 +434,14 @@ if
is empty.
.
.TP
-.BR \[rs]D' \*[ellipsis] '
-All drawing commands of groff's intermediate output are accepted.
+.BR \[rs]D\[aq] \*[ellipsis] \[aq]
+All drawing commands supported by the
+.RI AT&T\~ troff
+device-independent
+intermediate output format are accepted.
.
-See subsection \[lq]Drawing Commands\[rq] below.
+See subsection \[lq]Drawing Commands\[rq] below
+for GNU extensions.
.
.TP
.B \[rs]E
@@ -4071,8 +4075,8 @@ the escapes
.BR \[rs]R ,
.BR \[rs]s ,
and
-.BR \[rs]S
-transparent for recognizing the beginning of a line only in
+.B \[rs]S
+are transparent for recognizing the beginning of a line only in
compatibility mode.
.
For example,
@@ -4141,8 +4145,6 @@ like
and
.BR \[rs]z .
.
-.
-.P
In compatibility mode only,
a
.RI non-zero\~ n
[Prev in Thread] |
Current Thread |
[Next in Thread] |
- [groff] 01/02: Fix documentation nits.,
G. Branden Robinson <=