=================================================================== RCS file: /cvs/mandoc/TODO,v retrieving revision 1.93 retrieving revision 1.101 diff -u -p -r1.93 -r1.101 --- mandoc/TODO 2011/03/19 23:36:08 1.93 +++ mandoc/TODO 2011/04/16 22:35:26 1.101 @@ -1,6 +1,6 @@ ************************************************************************ * Official mandoc TODO. -* $Id: TODO,v 1.93 2011/03/19 23:36:08 schwarze Exp $ +* $Id: TODO,v 1.101 2011/04/16 22:35:26 schwarze Exp $ ************************************************************************ ************************************************************************ @@ -20,6 +20,11 @@ * formatter bugs ************************************************************************ +- tbl(7): Horizontal and vertical lines are formatted badly: + With the box option, there is too much white space at the end of cells. + Horizontal lines from "=" lines are a bit too long. + yuri dot pankov at gmail dot com Thu, 14 Apr 2011 05:45:26 +0400 + ************************************************************************ * missing features ************************************************************************ @@ -51,6 +56,11 @@ - \c (interrupted text) occurs in chat(8) +- \f(CW (constant width font) occurs in rsyncd.conf(5). + I think we should treat unknown/unavailable fonts as \fR + such that switching back with \fP works correctly - + and doesn't revert the _previous_ \fP. + --- missing mdoc features ---------------------------------------------- - fix bad block nesting involving multiple identical explicit blocks @@ -103,11 +113,8 @@ --- missing man features ----------------------------------------------- -- bashbug(1) complains "line scope broken" after - .SM - .B something - should either just work or be a warning - reported by naddy@ +- .RS/.RE can be nested, see e.g. the x11/fluxbox manuals + noticed by dcoppa@ Wed, Apr 13, 2011 at 04:58:14PM +0200: - groff an-ext.tmac macros (.UR, .UE) occur in xine(5) reported by brad@ Sat, 15 Jan 2011 15:45:23 -0500 @@ -265,6 +272,49 @@ should have a blank line between the text and the beginning of the indented paragraph, see for example sudo(1). +- In man(7), the sequence + .SH HEADER + + .PP + regular text + should not produce any blank lines between the header and the text, + see for example rsync(1). + Reported by naddy@ Mon, 28 Mar 2011 20:45:42 +0200 + +- In man(7), the sequence + regular text + .PP + .RS + indented text + should produce one blank line between the regular and indented texts, + see for example rsync(1), and + .RE + + .PP + .RS + should produce two,not one blank lines. + Reported by naddy@ Mon, 28 Mar 2011 20:45:42 +0200 + +- In man(7), the sequence + regular text + .IP + .IP "tag" + indented text + should produce one, not four blank lines between the regular text + and the tag, see for example rsync(1). + Likewise, + regular text + .IP + indented text + should produce one, not two blank lines in between, and + regular text + .IP + .RS + .IP tag + indented text + should produce one, not three blank lines. + Reported by naddy@ Mon, 28 Mar 2011 20:45:42 +0200 + - At least sometimes, .sp is ignored right after .SH; see named.conf(5). - trailing whitespace must be ignored even when followed by a font escape, @@ -278,10 +328,6 @@ * error reporting issues ************************************************************************ -- empty .RS blocks in man(7) should be warnings, not errors, - see for example qemu(1); - brad@comstyle.com Sat Mar 19 00:36:56 2011 - ************************************************************************ * performance issues ************************************************************************ @@ -301,11 +347,7 @@ Several areas can be cleaned up to make mandoc even fa - Find better ways to prevent endless loops in roff(7) macro and string expansion. -- Clean up date handling. - Store dates as strings, not time numbers. - When the format is not recognized, just use the string from the input. - When the format is recognized, normalize the string to whatever - format is standard at the respective place. +- Finish cleanup of date handling. Decide which formats should be recognized where. Update both mdoc(7) and man(7) documentation. Triggered by Tim van der Molen Tue, 22 Feb 2011 20:30:45 +0100