=================================================================== RCS file: /cvs/mandoc/TODO,v retrieving revision 1.54 retrieving revision 1.60 diff -u -p -r1.54 -r1.60 --- mandoc/TODO 2010/09/27 10:47:48 1.54 +++ mandoc/TODO 2010/10/17 21:10:53 1.60 @@ -1,6 +1,6 @@ ************************************************************************ * Official mandoc TODO. -* $Id: TODO,v 1.54 2010/09/27 10:47:48 kristaps Exp $ +* $Id: TODO,v 1.60 2010/10/17 21:10:53 schwarze Exp $ ************************************************************************ ************************************************************************ @@ -36,12 +36,25 @@ \\ must behave in a macro def like in a macro argument, and when using the macro, it must expand yet again. -- look at bsd.lv tbl(1) - from kristaps@ Fri, 11 Sep 2009 17:10:53 +0200 - also look at the mail from Thomas Klausner wiz at NetBSD - on Wed, 2 Jun 2010 11:01:29 +0200 - joerg@ has patches for this somewhere... +- implement basic non-parametric .de to support e.g. sox(1) + .de SP + .if t .sp .5 + .if n .sp + .. + .de EX + .SP + .nf + .ft CW + .. + .de EE + .ft R + .SP + .fi + .. + reported by naddy@ Sat, 16 Oct 2010 23:51:57 +0200 +- port OpenBSD tbl integration bsd.lv, probably cleaning it up + - look at pages generated from reStructeredText, e.g. devel/mercurial hg(1) These are a weird mixture of man(7) and custom autogenerated low-level roff stuff. Figure out to what extent we can cope. @@ -74,6 +87,10 @@ - allow `Qq', `Dq', `Sq', `Aq', `Bq' to have 0 arguments noted by Alex Kozlov 08/06/10 23:05 +- Have `Sh', `It', `Ss' and others complain if `Pp' is invoked prior to + close (in the post validation) or prior to open (pre). This noted by + jmc@ a thousand years ago. + ************************************************************************ * formatting issues: ugly output ************************************************************************ @@ -101,25 +118,10 @@ to better distinguish the contents of .%T and .%J, see for example OpenBSD cat(1) -- .It ${name Ns [ selector ] Ns } - should be "${name[selector]}" not "${name [selector]}" - This is parsed as - text("${name") text("[") Ns() text(selector)... - Opening punctuation should not fall out of .Ns. - see for example OpenBSD csh(1) - - In .Bl -bullet, the groff bullet is "+\b+\bo\bo", the mandoc bullet is just "o\bo". see for example OpenBSD ksh(1) -- .No text No ) is "text )", not "text)" - see the terrible example - case word in [[(] pattern [| pattern] ... ) list ;; ] ... esac - in OpenBSD ksh(1) - -- .Sm should *not* produce as a blank line in .Bd -literal - see for example "Brace expansion" in OpenBSD ksh(1) - - The characters "|" and "\*(Ba" should never be bold, not even in the middle of a word, e.g. ".Cm b\*(Bac" in "mknod [-m mode] name b|c major minor" @@ -134,9 +136,6 @@ In -unfilled, tabs are 5 spaces, just like in -filled and -ragged. See the CCDF_* display in OpenBSD ccdconfig(8). -- In .Bd -unfilled, .Pp should produce one blank line, not two; - see the ccd.conf display in OpenBSD ccdconfig(8). - - .Nx 1.0a should be "NetBSD 1.0A", not "NetBSD 1.0a", see OpenBSD ccdconfig(8). @@ -144,6 +143,10 @@ - In .Bl -tag, if a tag exceeds the right margin and must be continued on the next line, it must be indented by -width, not width+1; see "rule block|pass" in OpenBSD ifconfig(8). + +- 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. ************************************************************************ * performance issues