gbranden pushed a commit to branch master
in repository groff.
commit 9aac2586c5f4a390d5881a430d07f58e49278bb3
Author: G. Branden Robinson <[email protected]>
AuthorDate: Fri May 30 18:33:35 2025 -0500
groff_man_style(7): Revise `\&` and `\c` material.
Recast to reflect increased coverage of basic *roff concepts early in
the page, such as end-of-sentence detection.
Shift discussion of what "normally" happens when `\c` is _not_ used to
follow most of the material explaining what it _does_ do.
Favor active voice over passive.
Tighten wording.
---
tmac/groff_man.7.man.in | 63 ++++++++++++++++++++++++++++---------------------
1 file changed, 36 insertions(+), 27 deletions(-)
diff --git a/tmac/groff_man.7.man.in b/tmac/groff_man.7.man.in
index 54958d019..c43f2731d 100644
--- a/tmac/groff_man.7.man.in
+++ b/tmac/groff_man.7.man.in
@@ -1314,9 +1314,11 @@ follows the ellipsis when further text is to follow
after space on the
output line,
keeping its last period from being interpreted as the end of a
sentence
-.\" ...because it is followed by characters that are transparent to
-.\" end-of-sentence detection, and a newline...
-and causing additional inter-sentence space to be placed after it.
+because it is followed by characters that are transparent to
+end-of-sentence detection,
+and/or a newline,
+which would in turn normally cause the formatter
+to place additional inter-sentence space after it.
.
See subsection \[lq]Portability\[rq] below.
.
@@ -2758,30 +2760,7 @@ to space the dots more pleasantly on typesetters.
.B \ec
End a text line without inserting space or attempting a break.
.
-.\" TODO: When we explain what a "sentence" is, move this parenthetical
-.\" there.
-Normally,
-if filling is enabled,
-the end of a text line is treated like a space;
-.\" end-of-sentence detection is performed, and...
-an output line
-.I may
-break there
-(if it does not,
-.I @g@troff
-inserts an adjustable space);
-if filling is disabled,
-the line
-.I will
-break there,
-as in
-.BR EX / EE
-examples.
-.
-The next line is interpreted as usual and can `include' a macro call
-(contrast with
-.BI \e newline\/\c
-).
+Nothing on the input line after this escape sequence is formatted.
.
.B \[rs]c
is useful when three font styles are
@@ -2823,6 +2802,36 @@ $ \ec
.RE
.
.
+.IP
+.\" TODO: When we explain what a "sentence" is, move this pargraph
+.\" there.
+Normally,
+if filling is enabled,
+the formatter treats the end of a text line like a space.
+.
+It checks for the end of a sentence,
+and
+.I may
+break the output line
+(if not,
+it inserts an adjustable space).
+.
+If filling is disabled,
+the formatter
+.I will
+break the output line,
+as in
+.BR EX / EE
+examples.
+.
+The formatter interprets the next input line as usual,
+recognizing control lines,
+including macro calls
+(contrast with
+.BI \e newline\/\c
+).
+.
+.
.\" We once warned of \f possibly having "better portability" than \c;
.\" after several years of looking, GBR finds no evidence that this is
.\" the case. However, po4a is confused by \c and refuses to process
_______________________________________________
groff-commit mailing list
[email protected]
https://lists.gnu.org/mailman/listinfo/groff-commit
