=================================================================== RCS file: /cvs/mandoc/TODO,v retrieving revision 1.89 retrieving revision 1.98 diff -u -p -r1.89 -r1.98 --- mandoc/TODO 2011/02/03 10:24:21 1.89 +++ mandoc/TODO 2011/03/30 00:02:40 1.98 @@ -1,30 +1,15 @@ ************************************************************************ * Official mandoc TODO. -* $Id: TODO,v 1.89 2011/02/03 10:24:21 kristaps Exp $ +* $Id: TODO,v 1.98 2011/03/30 00:02:40 schwarze Exp $ ************************************************************************ ************************************************************************ * parser bugs ************************************************************************ -- It should be noted that in mandoc, the TBL macros are interpreted as - real roff macros (e.g., `. TS' is ok), while the troff preprocessor - only looks for `.TS' (static string). This should be noted in the - COMPATIBILITY section. The same applies for nascent `.EQ' (as it is - now, `.EN' is processed as a static string). - - .TP before .SH is still FATAL in man(7) reported by brad@ Sat, 15 Jan 2011 15:54:54 -0500 -- The mdoc(7) parser should handle `\.' as punctuation: - .Ql .if ${VAR} op something \. - should produce - `.if ${VAR} op something'. - not - `.if ${VAR} op something .' - as seen in make(1). - To escape the dot, one would use `\&.'. - - the roff parser doesn't tolerate additional characters between a macro and the \} terminating a conditional block, e.g. .if n \{ @@ -66,6 +51,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 @@ -118,12 +108,6 @@ --- missing man features ----------------------------------------------- -- bashbug(1) complains "line scope broken" after - .SM - .B something - should either just work or be a warning - reported by naddy@ - - groff an-ext.tmac macros (.UR, .UE) occur in xine(5) reported by brad@ Sat, 15 Jan 2011 15:45:23 -0500 @@ -280,6 +264,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, @@ -311,4 +338,8 @@ 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. - + +- 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