[groff] 22/30: [docs]: Revise end-of-sentence detection material.

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit 27ee71cd0ad0ba6dad515efa0b7550bd18a5733a
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Wed Jun 15 03:19:04 2022 -0500

    [docs]: Revise end-of-sentence detection material.
    
    * doc/groff.texi (Filling):
    * man/roff.7.man (Concepts): Do it.  "Spaces" is a now a term with a
      much more restricted usage.  Emphasize the input context, now
      explicitly identified as plain text files with Unix line endings.
    
    Fixes (one hopes) <https://savannah.gnu.org/bugs/?62593>.  Thanks to
    Ingo Schwarze for the report and Dave Kemper for the discussion.
---
 ChangeLog      | 14 ++++++++++++++
 doc/groff.texi | 23 ++++++++++++-----------
 man/roff.7.man | 18 +++++++++++++++++-
 3 files changed, 43 insertions(+), 12 deletions(-)

diff --git a/ChangeLog b/ChangeLog
index b8a12be7..7cfb27f3 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,17 @@
+2022-06-15  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+       [docs]: Revise discussion of end-of-sentence detection.
+
+       * doc/groff.texi (Filling):
+       * man/roff.7.man (Concepts): Do it.  "Spaces" is a now a term
+       with a much more restricted usage.  Emphasize the input context,
+       now explicitly identified as plain text files with Unix line
+       endings.
+
+       Fixes (one hopes) <https://savannah.gnu.org/bugs/?62593>.
+       Thanks to Ingo Schwarze for the report and Dave Kemper for the
+       discussion.
+
 2022-06-10  Deri James  <deri@chuzzlewit.myzen.co.uk>
 
        [gropdf]: Changes to BuildFoundries.
diff --git a/doc/groff.texi b/doc/groff.texi
index 978bff5c..8c0c9177 100644
--- a/doc/groff.texi
+++ b/doc/groff.texi
@@ -4862,21 +4862,22 @@ inter-sentence space.
 
 When GNU @code{troff} starts up, it obtains information about the device
 for which it is preparing output.@footnote{@xref{Device and Font
-Description Files}.}  A crucial example is the length of the output
+Description Files}.}  An essential property is the length of the output
 line, such as ``6.5 inches''.
 
 @cindex word, definition of
 @cindex filling
-GNU @code{troff} reads its input character by character, collecting
-words as it goes, and fits as many words together on an output line as
-it can---this is known as @dfn{filling}.  To GNU @code{troff}, a
-@dfn{word} is any sequence of one or more characters that aren't spaces,
-tabs, or newlines.  The exceptions separate words.@footnote{There are
-also @emph{escape sequences} which can function as word characters, word
-separators, or neither---the last simply have no effect on GNU
-@code{troff}'s idea of whether an input character is within a word or
-not.}  To disable filling, see @ref{Manipulating Filling and
-Adjustment}.
+GNU @code{troff} interprets plain text files employing the Unix
+line-ending convention.  It reads input a character at a time,
+collecting words as it goes, and fits as many words together on an
+output line as it can---this is known as @dfn{filling}.  To GNU
+@code{troff}, a @dfn{word} is any sequence of one or more characters
+that aren't spaces, tabs, or newlines.  The exceptions separate
+words.@footnote{There are also @emph{escape sequences} which can
+function as word characters, word separators, or neither---the last
+simply have no effect on GNU @code{troff}'s idea of whether an input
+character is within a word or not.}  To disable filling, see
+@ref{Manipulating Filling and Adjustment}.
 
 @Example
 It is a truth universally acknowledged
diff --git a/man/roff.7.man b/man/roff.7.man
index 84a6909b..a0f940a3 100644
--- a/man/roff.7.man
+++ b/man/roff.7.man
@@ -114,7 +114,23 @@ and can be controlled at the input document's discretion.
 .
 .
 .P
-The formatter reads its input character by character,
+When a device-independent
+.I roff
+formatter starts up,
+it obtains information about the device for which it is preparing
+output from it description file
+(see
+.MR groff_font @MAN5EXT@ ).
+.
+An essential property is the length of the output line,
+such as \[lq]6.5 inches\[rq].
+.
+.
+.P
+The formatter interprets plain text files employing the Unix line-ending
+convention.
+.
+It reads input a character at a time,
 collecting words as it goes,
 and fits as many words together on an output line as it can\[em]this
 is known as