mandoc/TODO - diff

Return to TODO CVS log

Up to [cvsweb.bsd.lv] / mandoc

Diff for /mandoc/TODO between version 1.89 and 1.93

version 1.89, 2011/02/03 10:24:21

version 1.93, 2011/03/19 23:36:08

Line 7

* 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 \{

Line 293

Line 278

* 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

************************************************************************

Line 311 Several areas can be cleaned up to make mandoc even fa

Line 300 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.

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

CVSweb