groff-commit
[Top][All Lists]
Advanced

[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



reply via email to

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