[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[groff] 22/30: [docs]: Revise end-of-sentence detection material.
From: |
G. Branden Robinson |
Subject: |
[groff] 22/30: [docs]: Revise end-of-sentence detection material. |
Date: |
Wed, 15 Jun 2022 09:59:54 -0400 (EDT) |
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
[Prev in Thread] |
Current Thread |
[Next in Thread] |
- [groff] 22/30: [docs]: Revise end-of-sentence detection material.,
G. Branden Robinson <=