=================================================================== RCS file: /cvs/mandoc/TODO,v retrieving revision 1.60 retrieving revision 1.64 diff -u -p -r1.60 -r1.64 --- mandoc/TODO 2010/10/17 21:10:53 1.60 +++ mandoc/TODO 2010/11/03 12:07:58 1.64 @@ -1,9 +1,24 @@ ************************************************************************ * Official mandoc TODO. -* $Id: TODO,v 1.60 2010/10/17 21:10:53 schwarze Exp $ +* $Id: TODO,v 1.64 2010/11/03 12:07:58 schwarze Exp $ ************************************************************************ ************************************************************************ +* parser bugs +************************************************************************ + +- the roff parser doesn't tolerate additional characters between + a macro and the \} terminating a conditional block, e.g. + .if n \{ + .br \} + reported by ulrich spoerlein Tue, 19 Oct 2010 20:39:50 +0200 + +- .BI "string string " word punct in gettext(3) + add bogus line breaks (rep by naddy@) + committed; currently working on IP and TP? + and what about B and I? + +************************************************************************ * missing features ************************************************************************ @@ -53,6 +68,21 @@ .. reported by naddy@ Sat, 16 Oct 2010 23:51:57 +0200 +- implement parametric .de to support e.g. + /usr/xenocara/lib/libXxf86vm/manXF86VM.man + .de ZN + .ie t \fB\^\\$1\^\fR\\$2 + .el \fI\^\\$1\^\fP\\$2 + .. + .ZN -lXxf86vm + +- clean up escape sequence handling, creating three classes: + (1) fully implemented, or parsed and ignored without loss of content + (2) unimplemented, potentially causing loss of content + or serious mangling of formatting (e.g. \n) -> ERROR + see textproc/mgdiff(1) for nice examples + (3) undefined, just output the character -> perhaps WARNING + - port OpenBSD tbl integration bsd.lv, probably cleaning it up - look at pages generated from reStructeredText, e.g. devel/mercurial hg(1) @@ -91,6 +121,14 @@ close (in the post validation) or prior to open (pre). This noted by jmc@ a thousand years ago. +- xloadimage(1) wants .ti (temporary indent), rep by naddy@ + +- bashbug(1) complains "line scope broken" after + .SM + .B something + should either just work or be a warning + reported by naddy@ + ************************************************************************ * formatting issues: ugly output ************************************************************************ @@ -147,6 +185,18 @@ - The \& zero-width character counts as output. That is, when it is alone on a line between two .Pp, we want three blank lines, not two as in mandoc. + +- 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 + +- It seems that .TP does not want TWOSPACE after the tag; + see bashbug(1); reported by naddy@ + +- Header lines of excessive length: + Port OpenBSD man_term.c rev. 1.25 to mdoc_term.c + and document it in mdoc(7) and man(7) COMPATIBILITY + found while talking to Chris Bennett ************************************************************************ * performance issues