===================================================================
RCS file: /cvs/mandoc/mdoc.7,v
retrieving revision 1.166
retrieving revision 1.172
diff -u -p -r1.166 -r1.172
--- mandoc/mdoc.7	2010/11/30 20:45:55	1.166
+++ mandoc/mdoc.7	2010/12/27 20:39:46	1.172
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: mdoc.7,v 1.166 2010/11/30 20:45:55 schwarze Exp $
+.\"	$Id: mdoc.7,v 1.172 2010/12/27 20:39:46 kristaps Exp $
 .\"
 .\" Copyright (c) 2009, 2010 Kristaps Dzonsons <kristaps@bsd.lv>
 .\" Copyright (c) 2010 Ingo Schwarze <schwarze@openbsd.org>
@@ -15,7 +15,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: November 30 2010 $
+.Dd $Mdocdate: December 27 2010 $
 .Dt MDOC 7
 .Os
 .Sh NAME
@@ -1077,8 +1077,7 @@ implementations render it poorly.
 Left- and right-justify the block.
 .It Fl literal
 Do not justify the block at all.
-Preserve white space and newlines as they appear in the input, including
-if it follows a macro.
+Preserve white space as it appears in the input.
 .It Fl ragged
 Only left-justify the block.
 .It Fl unfilled
@@ -1202,7 +1201,7 @@ Be careful in using over-long lines within a keep bloc
 Doing so will clobber the right margin.
 .Ss \&Bl
 Begin a list.
-Lists consist of items started by the
+Lists consist of items specified using the
 .Sx \&It
 macro, containing a head or a body or both.
 The list syntax is as follows:
@@ -2125,9 +2124,6 @@ Examples:
 Format a
 .Dq mailto:
 hyperlink.
-If an argument is not provided, the string
-.Dq \(ti
-is used as a default.
 Its syntax is as follows:
 .Pp
 .D1 Pf \. Sx \&Mt Cm address
@@ -2596,6 +2592,11 @@ enclosed argument, including whitespace.
 .Pp
 Examples:
 .D1 \&.Sx MANUAL STRUCTURE
+.Pp
+See also
+.Sx \&Sh
+and
+.Sx \&Ss .
 .Ss \&Sy
 Format enclosed arguments in symbolic
 .Pq Dq boldface .
@@ -2738,6 +2739,16 @@ The following problematic behaviour is found in groff:
 .ds hist (Historic groff only.)
 .Pp
 .Bl -dash -compact
+.It
+Display macros
+.Po
+.Sx \&Bd ,
+.Sx \&Dl ,
+and
+.Sx \&D1
+.Pc
+may not be nested.
+\*[hist]
 .It
 .Sx \&At
 with unknown arguments produces no output at all.