************************************************************************
* Official mandoc TODO.
-* $Id: TODO,v 1.67 2010/12/09 23:44:39 schwarze Exp $
+* $Id: TODO,v 1.71 2010/12/30 00:51:32 schwarze Exp $
************************************************************************
************************************************************************
* missing features
************************************************************************
+- pod2man expects `tr' to be implemented for \*(-- to work
+
- 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
(e.g., NetBSD mDNSShared/dns-sd.1)
(mdoc_html.c and mdoc_term.c `Nm' handlers can be slightly simplified)
-- 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.
-
- xloadimage(1) wants .ti (temporary indent), rep by naddy@
- bashbug(1) complains "line scope broken" after
should either just work or be a warning
reported by naddy@
+- check compatibility with Plan9:
+ http://swtch.com/usr/local/plan9/tmac/tmac.an
+ http://swtch.com/plan9port/man/man7/man.html
+ "Anthony J. Bentley" <anthonyjbentley@gmail.com> 28 Dec 2010 21:58:40 -0700
+
************************************************************************
* formatting issues: ugly output
************************************************************************
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)
-
- In .Bl -bullet, the groff bullet is "+\b+\bo\bo", the mandoc bullet
is just "o\bo".
see for example OpenBSD ksh(1)
- A bogus .Pp between two .It must not produce a double blank line,
see between -R and -r in OpenBSD rm(1), before "update" in mount(8),
or in DIAGNOSTICS in init(8).
+ Also have `It' complain if `Pp' is invoked at certain times (not
+ -compact?).
- .Bd -literal and .Bd -unfilled are *not* identical.
In -literal, tabs are 8 spaces.