===================================================================
RCS file: /cvs/mandoc/man.7,v
retrieving revision 1.22
retrieving revision 1.25
diff -u -p -r1.22 -r1.25
--- mandoc/man.7	2009/08/13 11:45:29	1.22
+++ mandoc/man.7	2009/08/13 12:54:52	1.25
@@ -1,4 +1,4 @@
-.\"	$Id: man.7,v 1.22 2009/08/13 11:45:29 kristaps Exp $
+.\"	$Id: man.7,v 1.25 2009/08/13 12:54:52 kristaps Exp $
 .\"
 .\" Copyright (c) 2009 Kristaps Dzonsons <kristaps@kth.se>
 .\"
@@ -262,7 +262,7 @@ and
 This section is a canonical reference to all macros, arranged
 alphabetically.  For the scoping of individual macros, see
 .Sx MACRO SYNTAX .
-.Bl -tag -width Ds -offset indent
+.Bl -tag -width Ds
 .It \&B
 Text is rendered in bold face.
 .It \&BI
@@ -281,14 +281,26 @@ render in italics.  Whitespace between arguments is om
 Text is rendered alternately in bold face and roman (the default font).
 Whitespace between arguments is omitted in output.
 .It \&HP
-.\" TODO.
+Begin a paragraph whose initial output line is left-justified, but
+subsequent output lines are indented.
 .It \&I
 Text is rendered in italics.
 .It \&IB
 Text is rendered alternately in italics and bold face.  Whitespace
 between arguments is omitted in output.
 .It \&IP
-.\" TODO.
+Begin a paragraph with the following syntax:
+.Bd -literal -offset indent
+\&.IP [head [width]]
+.Ed
+.Pp
+This follows the behaviour of the
+.Sq \&TP
+macro except that 
+.Va width ,
+which is only considered as such if properly-formed (e.g., 24n, 4,
+etc.), is used as the indentation offset instead of the default
+indentation value.
 .It \&IR
 Text is rendered alternately in italics and roman (the default font).
 Whitespace between arguments is omitted in output.
@@ -337,10 +349,11 @@ string specifies the organisation providing the utilit
 .Va volume
 replaces the default rendered volume as dictated by the manual section.
 .It \&TP
-.\" TODO.
+Begin a paragraph where the head, if exceeding the indentation width, is
+followed by a newline; if not, the body follows on the same line after a
+buffer to the indentation width.  Subsequent output lines are indented.
 .It \&br
 Breaks the current line.  Consecutive invocations have no further effect.
-.\" TODO.
 .It \&fi
 End literal mode begun by
 .Sq \&nf .
@@ -363,9 +376,23 @@ macro.
 .El
 .\" SECTION
 .Sh COMPATIBILITY
-See
-.Xr mdoc 7
-for groff compatibility notes.
+This section documents compatibility with other roff implementations, at
+this time limited to
+.Xr groff 1 .
+.Bl -hyphen
+.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.
+.It
+The
+.Sq \&sp
+macro does not accept negative numbers.
+.It
+Blocks of whitespace are stripped from both macro and free-form text
+lines (except when in literal mode), while groff would retain whitespace
+in free-form text lines.
+.El
 .\" SECTION
 .Sh SEE ALSO
 .Xr mandoc 1 ,
@@ -374,7 +401,7 @@ for groff compatibility notes.
 .Sh AUTHORS
 The
 .Nm
-utility was written by
+reference was written by
 .An Kristaps Dzonsons Aq kristaps@kth.se .
 .\" SECTION
 .Sh CAVEATS