===================================================================
RCS file: /cvs/mandoc/mandoc.1,v
retrieving revision 1.41
retrieving revision 1.43
diff -u -p -r1.41 -r1.43
--- mandoc/mandoc.1	2009/10/03 16:36:06	1.41
+++ mandoc/mandoc.1	2009/10/15 02:42:53	1.43
@@ -1,4 +1,4 @@
-.\"	$Id: mandoc.1,v 1.41 2009/10/03 16:36:06 kristaps Exp $
+.\"	$Id: mandoc.1,v 1.43 2009/10/15 02:42:53 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: October 3 2009 $
+.Dd $Mdocdate: October 15 2009 $
 .Dt MANDOC 1
 .Os
 .
@@ -268,7 +268,7 @@ for example, 
 is used as a template for linked header files (usually via the
 .Sq \&In
 macro).  Instances of
-.Sq %I
+.Sq \&%I
 are replaced with the include filename.  The default is not to present a
 hyperlink.
 .It Fl o Ns Ar man=fmt
@@ -279,7 +279,7 @@ for example, 
 is used as a template for linked manuals (usually via the
 .Sq \&Xr
 macro).  Instances of
-.Sq %N
+.Sq \&%N
 and
 .Sq %S
 are replaced with the linked manual's name and section, respectively.
@@ -373,6 +373,26 @@ retains spaces.
 .
 .It
 Sentences are unilaterally monospaced.
+.El
+.
+.Ss HTML output
+.Bl -bullet -compact
+.It
+The
+.Xr mdoc 7
+.Sq \&Bl \-hang
+and
+.Sq \&Bl \-tag
+list types render similarly (no break following overreached left-hand
+side) due to the expressive constraints of HTML.
+.
+.It
+The
+.Xr man 7
+.Sq IP
+and
+.Sq TP
+lists render similarly.
 .El
 .\" SECTION
 .Sh SEE ALSO