[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[groff] 30/46: groff_mdoc(7): Simplify sentence punct discussion.
From: |
G. Branden Robinson |
Subject: |
[groff] 30/46: groff_mdoc(7): Simplify sentence punct discussion. |
Date: |
Wed, 7 Dec 2022 04:32:36 -0500 (EST) |
gbranden pushed a commit to branch master
in repository groff.
commit d2e937061161d9218c4439b5c6e0a8a5f271ff87
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Sun Dec 4 00:35:21 2022 -0600
groff_mdoc(7): Simplify sentence punct discussion.
Steer people to roff(7) for a general discussion of how *roff formatters
detect sentence endings. mdoc(7) has its own additional rules about
punctuation and this page's emphasis should be on that.
---
tmac/groff_mdoc.7.man | 31 ++++++-------------------------
1 file changed, 6 insertions(+), 25 deletions(-)
diff --git a/tmac/groff_mdoc.7.man b/tmac/groff_mdoc.7.man
index f9bd8e0fb..f5ae7f9a5 100644
--- a/tmac/groff_mdoc.7.man
+++ b/tmac/groff_mdoc.7.man
@@ -537,21 +537,11 @@ below.
.
.
.Pp
-The formatter attempts to detect the endings of sentences and puts the
-equivalent of two spaces between sentences on the same output line.
-.
-Characters like
-.Ql \&)
-or
-.Ql \&\[aq]
-after sentence-ending punctuation are ignored for this purpose.
-.
-Sometimes you will want to end an input line with a
-.Ql \&. ,
-.Ql \&? ,
-or
-.Ql \&!
-that does not end a sentence.
+The formatter attempts to detect the ends of sentences and by default
+puts the equivalent of two spaces between sentences on the same output
+line;
+see
+.Xr roff @MAN7EXT@ .
.
In a list of macro arguments,
put
@@ -602,7 +592,7 @@ test
.
as output.
.
-As can be seen in the first and third lines,
+As can be seen in the first and third output lines,
.Xr mdoc
handles punctuation characters specially in macro arguments.
.
@@ -610,15 +600,6 @@ This will be explained in section
.Sx "General syntax"
below.
.
-Similarly,
-sentence-ending punctuation characters at the end of an input line that
-isn't an
-.Xr mdoc
-command must
-be suffixed with
-.Ql \[rs]&
-to keep them from being interpreted as sentence endings.
-.
.
.Pp
A comment in the source file of a man page can begin with
[Prev in Thread] |
Current Thread |
[Next in Thread] |
- [groff] 30/46: groff_mdoc(7): Simplify sentence punct discussion.,
G. Branden Robinson <=