=================================================================== RCS file: /cvs/mandoc/TODO,v retrieving revision 1.61 retrieving revision 1.65 diff -u -p -r1.61 -r1.65 --- mandoc/TODO 2010/10/19 21:40:27 1.61 +++ mandoc/TODO 2010/11/29 13:04:31 1.65 @@ -1,6 +1,6 @@ ************************************************************************ * Official mandoc TODO. -* $Id: TODO,v 1.61 2010/10/19 21:40:27 schwarze Exp $ +* $Id: TODO,v 1.65 2010/11/29 13:04:31 kristaps Exp $ ************************************************************************ ************************************************************************ @@ -13,13 +13,15 @@ .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 ************************************************************************ -- deal with nested displays, e.g. D1 inside Bd - schwarze has an old patch somewhere and would need to brush it up - - explicit blocks with missing end macro should be implicitely closed at the end of the enclosing block, e.g. .Bl It (El) Sh reminded by stsp@ in net/pptp pptp.8 Fri, 23 Apr 2010 20:32:39 +0200 @@ -66,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) @@ -104,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 ************************************************************************ @@ -127,6 +152,10 @@ * formatting issues: gratuitious differences ************************************************************************ +- .Rv (and probably .Ex) print different text if an `Nm' has been named + or not (run a manual without `Nm blah' to see this). I'm not sure + that this exists in the wild, but it's still an error. + - .%T should be quoted, not underlined, when .%J is also present, to better distinguish the contents of .%T and .%J, see for example OpenBSD cat(1) @@ -160,6 +189,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