===================================================================
RCS file: /cvs/mandoc/mdoc.7,v
retrieving revision 1.46
retrieving revision 1.48
diff -u -p -r1.46 -r1.48
--- mandoc/mdoc.7	2009/07/17 14:51:04	1.46
+++ mandoc/mdoc.7	2009/07/18 23:31:04	1.48
@@ -1,4 +1,4 @@
-.\"	$Id: mdoc.7,v 1.46 2009/07/17 14:51:04 kristaps Exp $
+.\"	$Id: mdoc.7,v 1.48 2009/07/18 23:31:04 kristaps Exp $
 .\"
 .\" Copyright (c) 2009 Kristaps Dzonsons <kristaps@kth.se>
 .\"
@@ -14,7 +14,7 @@
 .\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
 .\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
 .\" 
-.Dd $Mdocdate: July 17 2009 $
+.Dd $Mdocdate: July 18 2009 $
 .Dt MDOC 7
 .Os
 .\" SECTION---------------------------------------------
@@ -144,9 +144,7 @@ These         are              not.
 .\" PARAGRAPH------------
 .Pp
 In macro lines, whitespace delimits arguments and is discarded.  If
-arguments are quoted, whitespace is conditionally retained within the
-quotes.
-.\" TODO: which do and which don't?
+arguments are quoted, whitespace within the quotes is retained.
 .\" PARAGRAPH------------
 .Pp
 Blank lines are only permitted within literal contexts, as are lines
@@ -159,9 +157,24 @@ 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 terminates the term, regardless of surrounding whitespace.
+double-quote not pair-wise adjacent to another double-quote terminates
+the literal, regardless of surrounding whitespace.  
 .\" PARAGRAPH------------
 .Pp
+This produces tokens 
+.Sq a" ,
+.Sq b c ,
+.Sq de ,
+and
+.Sq fg" .
+Note that any quoted term, be it argument or macro, is indiscriminately
+considered literal text.  Thus, the following produces 
+.Sq \&Em a :
+.Bd -literal -offset indent
+\&.Em "Em a"
+.Ed
+.\" PARAGRAPH------------
+.Pp
 In free-form mode, quotes are regarded as opaque text.
 .\" SECTION---------------------------------------------
 .Sh MANUAL STRUCTURE
@@ -441,6 +454,11 @@ file re-write 
 .\" PARAGRAPH------------
 .Pp
 .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