gbranden pushed a commit to branch master
in repository groff.

commit 69407e308fca565783cfedfb7f317da9dbb5cac7
Author: G. Branden Robinson <g.branden.robin...@gmail.com>
AuthorDate: Sat Aug 30 03:01:06 2025 -0500

    doc/*,man/*: Recast basic material on sentences.
    
    * Explicitly name requests of interest.
    * Favor imperative mood over declarative when being didactic.
    * Sync formatter-specific material on `cflags` and `ss` from Texinfo to
      groff(7) man page; since it deals with GNU troff innovations, it's not
      suitable for the fundamental stuff in roff(7).
    
    * doc/groff.texi.in: Bump document revision date.
---
 doc/groff.texi.in | 18 ++++++++++++------
 man/groff.7.man   | 17 +++++++++++++++++
 2 files changed, 29 insertions(+), 6 deletions(-)

diff --git a/doc/groff.texi.in b/doc/groff.texi.in
index 3b4bf8e96..fae597dfa 100644
--- a/doc/groff.texi.in
+++ b/doc/groff.texi.in
@@ -464,7 +464,7 @@ Documentation License''.
 @title groff
 @subtitle The GNU implementation of @code{troff}
 @subtitle version @VERSION@
-@subtitle July 2025
+@subtitle August 2025
 @author Trent@tie{}A.@: Fisher
 @author Werner Lemberg
 @author G.@tie{}Branden Robinson
@@ -5478,11 +5478,17 @@ been shocking to the rich.\[rq]
 @end ifnottex
 @endExample
 
-The sets of characters that potentially end sentences or are transparent
-to sentence endings are configurable.  See the @code{cflags} request in
-@ref{Using Symbols}.  To change the supplemental inter-sentence space
-amount---even to remove it entirely---see @ref{Manipulating Filling and
-Adjustment}.
+Configure the sets of characters that potentially end sentences
+or are transparent to sentence endings
+with the
+@code{cflags}
+request
+(@pxref{Using Symbols}).
+Use the
+@code{ss}
+request
+to change---or eliminate---supplemental inter-sentence space
+(@pxref{Manipulating Filling and Adjustment}).
 
 @c ---------------------------------------------------------------------
 
diff --git a/man/groff.7.man b/man/groff.7.man
index aaff4e432..511877387 100644
--- a/man/groff.7.man
+++ b/man/groff.7.man
@@ -657,6 +657,23 @@ the next defined tab stop.
 .
 .
 .\" ====================================================================
+.SH Sentences
+.\" ====================================================================
+.
+Configure the sets of characters that potentially end sentences
+or are transparent to sentence endings
+with the
+.B \%cflags
+request.
+.\" (@pxref{Using Symbols}).
+.
+Use the
+.B ss
+request
+to change\[em]or eliminate\[em]supplemental inter-sentence space.
+.\" (@pxref{Manipulating Filling and Adjustment}).
+.
+.\" ====================================================================
 .SH "Tabs and leaders"
 .\" ====================================================================
 .

_______________________________________________
groff-commit mailing list
groff-commit@gnu.org
https://lists.gnu.org/mailman/listinfo/groff-commit

Reply via email to