===================================================================
RCS file: /cvs/mandoc/TODO,v
retrieving revision 1.115
retrieving revision 1.129
diff -u -p -r1.115 -r1.129
--- mandoc/TODO	2011/06/30 08:05:13	1.115
+++ mandoc/TODO	2012/03/04 23:53:37	1.129
@@ -1,14 +1,16 @@
 ************************************************************************
 * Official mandoc TODO.
-* $Id: TODO,v 1.115 2011/06/30 08:05:13 kristaps Exp $
+* $Id: TODO,v 1.129 2012/03/04 23:53:37 schwarze Exp $
 ************************************************************************
 
 ************************************************************************
 * parser bugs
 ************************************************************************
 
-- .TP before .SH is still FATAL in man(7)
-  reported by brad@  Sat, 15 Jan 2011 15:54:54 -0500
+- ".\}" on its own line gets translated to bare ".\&"
+  which forces pset() into man(7)
+  and then triggers an unknown macro error
+  reported by naddy@  Sun, 3 Jul 2011 21:52:24 +0200
 
 ************************************************************************
 * formatter bugs
@@ -25,6 +27,15 @@
 
 --- 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.
+
 - .ad (adjust margins)
   .ad l -- adjust left margin only (flush left)
   .ad r -- adjust right margin only (flush right)
@@ -46,10 +57,11 @@
 - .ta (tab settings) occurs in ircbug(1) and probably gnats(1)
   reported by brad@  Sat, 15 Jan 2011 15:50:51 -0500
 
-- pod2man expects `tr' to be implemented for \*(-- to work
-
 - \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
@@ -123,6 +135,8 @@
 - groff an-ext.tmac macros (.UR, .UE) occur in xine(5)
   reported by brad@  Sat, 15 Jan 2011 15:45:23 -0500
 
+- -T[x]html doesn't stipulate non-collapsing spaces in literal mode
+
 --- missing tbl features -----------------------------------------------
 
 - implement basic non-parametric .de to support e.g. sox(1)
@@ -181,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
@@ -225,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.
@@ -247,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,
@@ -255,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):
@@ -317,6 +338,8 @@
 * error reporting issues
 ************************************************************************
 
+- .TP directly followed by .RS gives an assertion.
+
 ************************************************************************
 * performance issues
 ************************************************************************
@@ -335,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.