groff-commit
[Top][All Lists]
Advanced

[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



reply via email to

[Prev in Thread] Current Thread [Next in Thread]