===================================================================
RCS file: /cvs/mandoc/TODO,v
retrieving revision 1.120
retrieving revision 1.129
diff -u -p -r1.120 -r1.129
--- mandoc/TODO	2011/07/28 14:37:39	1.120
+++ mandoc/TODO	2012/03/04 23:53:37	1.129
@@ -1,6 +1,6 @@
 ************************************************************************
 * Official mandoc TODO.
-* $Id: TODO,v 1.120 2011/07/28 14:37:39 kristaps Exp $
+* $Id: TODO,v 1.129 2012/03/04 23:53:37 schwarze Exp $
 ************************************************************************
 
 ************************************************************************
@@ -12,9 +12,6 @@
   and then triggers an unknown macro error
   reported by naddy@  Sun, 3 Jul 2011 21:52:24 +0200
 
-- .TP before .SH is still FATAL in man(7)
-  reported by brad@  Sat, 15 Jan 2011 15:54:54 -0500
-
 ************************************************************************
 * formatter bugs
 ************************************************************************
@@ -30,6 +27,11 @@
 
 --- missing roff features ----------------------------------------------
 
+- The pod2man preamble wants \h'...' with quoted numerical arguments,
+  see for example AUTHORS in MooseX::Getopt.3p, p5-MooseX-Getopt.
+  reported by Andreas Voegele <mail at andreasvoegele dot com>
+  Tue, 22 Nov 2011 15:34:47 +0100 on ports@
+
 - .if n \{
   .br\}
   should cause an extra space to be raised.
@@ -57,6 +59,9 @@
 
 - \c (interrupted text) occurs in chat(8)
 
+- using undefined strings or macros defines them to be empty
+  wl@  Mon, 14 Nov 2011 14:37:01 +0000
+
 --- missing mdoc features ----------------------------------------------
 
 - fix bad block nesting involving multiple identical explicit blocks
@@ -190,6 +195,7 @@
   .It Em Authentication<tab>Key Length
   ought to render "Key Length" with emphasis, too,
   see OpenBSD iked.conf(5).
+  reported again Nicolas Joly via wiz@ Wed, 12 Oct 2011 00:20:00 +0200
 
 - empty phrases in .Bl column produce too few blanks
   try e.g. .Bl -column It Ta Ta
@@ -234,6 +240,7 @@
 - .Pp between two .It in .Bl -column should produce one,
   not two blank lines, see e.g. login.conf(5).
   reported by jmc@  Sun, 17 Apr 2011 14:04:58 +0059
+  reported again by sthen@  Wed, 18 Jan 2012 02:09:39 +0000 (UTC)
 
 - If the *first* line after .It is .Pp, break the line right after
   the tag, do not pad with space characters before breaking.
@@ -256,6 +263,8 @@
     .Bl -tag -width ".Dv message"
   in magic(5), located in src/usr.bin/file, is the same
   as -width 7n, not -width 11n.
+  The same applies to .Bl -column column widths;
+  reported again by Nicolas Joly Thu, 1 Mar 2012 13:41:26 +0100 via wiz@ 5 Mar
 
 - The \& zero-width character counts as output.
   That is, when it is alone on a line between two .Pp,
@@ -264,6 +273,9 @@
 - When .Fn arguments exceed one output line, all but the first
   should be indented, see e.g. rpc(3);
   reported by jmc@ on discuss@  Fri, 29 Oct 2010 13:48:33 +0100
+  reported again by Nicolas Joly via wiz@  Sun, 18 Sep 2011 18:24:40 +0200
+  Also, we don't want to break the line within the argument of:
+  .Fa "chtype tl"
 
 - .Ns should work when called at the end of an input line, see
   the following code in vi(1):
@@ -326,6 +338,8 @@
 * error reporting issues
 ************************************************************************
 
+- .TP directly followed by .RS gives an assertion.
+
 ************************************************************************
 * performance issues
 ************************************************************************
@@ -344,6 +358,10 @@ Several areas can be cleaned up to make mandoc even fa
 ************************************************************************
 * structural issues
 ************************************************************************
+
+- We use the input line number at several places to distinguish
+  same-line from different-line input.  That plainly doesn't work
+  with user-defined macros, leading to random breakage.
 
 - Find better ways to prevent endless loops
   in roff(7) macro and string expansion.