More clarity fixes in mdoc.7.

Sm/Sy argument to `Bf' fixed (schwarze@openbsd).

1 files changed, 7 insertions, 17 deletions

diff --git a/mdoc.7 b/mdoc.7
index 49e1268e..db512c1f 100644
--- a/mdoc.7
+++ b/mdoc.7
@@ -131,11 +131,6 @@ also be text-decorated using the
 .Sq \ef
 escape followed by an indicator: B (bold), I, (italic), or P and R
 (Roman, or reset).  This form is not recommended.
-.Pp
-Lastly, a standalone double-quote may be produced in a macro line by
-using two consecutive double-quotes within a quoted literal.  See
-.Sx Quotation
-for details.
 .\" SUB-SECTION----------------------
 .Ss Whitespace
 In non-literal free-form lines, consecutive blocks of whitespace are
@@ -162,18 +157,8 @@ or when in a literal context.
 Macro arguments may be quoted with a double-quote to group
 space-delimited terms or to retain blocks of whitespace.  A quoted
 argument begins with a double-quote preceded by whitespace.  The next
-double-quote that is 
-.Em
-preceded by a double-quote terminates the term, regardless of
-surrounding whitespace.  Thus, the following construction produces 
-.Sq "a""b" ,
-since, as mentioned in
-.Sx Special Characters ,
-two consecutive double-quotes in a quoted literal produce a standalone
-double-quote:
-.Bd -literal -offset indent
-\&.Em "a""""b"
-.Ed
+double-quote not pair-wise adjacent to another double-quote terminates
+the literal, regardless of surrounding whitespace.  
 .\" PARAGRAPH------------
 .Pp
 This produces tokens 
@@ -471,6 +456,11 @@ file re-write
 .Bl -dash -compact
 .\" LIST-ITEM
 .It
+In quoted literals, groff allowed pair-wise double-quotes to produce a
+standalone double-quote in formatted output.  This idiosyncratic
+behaviour is no longer applicable.
+.\" LIST-ITEM
+.It
 The 
 .Sq \&sp
 macro does not accept negative numbers.