mandoc/TODO - diff

Return to TODO CVS log

Up to [cvsweb.bsd.lv] / mandoc

version 1.84, 2011/01/25 10:37:49

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

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

Line 160

Line 166

* formatting issues: ugly output

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

- a column list with blank `Ta' cells triggers a spurrious

start-with-whitespace printing of a newline

- double quotes inside double quotes are escaped by doubling them

implement this in mdoc(7), too

so far, we only have it in roff(7) and man(7)

Line 225

Line 234

should be "NetBSD 1.0A", not "NetBSD 1.0a",

see OpenBSD ccdconfig(8).

- The space character joining .Dx .Fx .Nx .Ox (are these all?) to its

argument is non-breaking. See the cdio(1) HISTORY and many others.

- .Bx uses a dash before its argument, not a space,

see for example the chpass(1) and column(1) HISTORY.

Besides, the second argument is capitalized, for example,

.Bx 4.3 tahoe .

produces 4.3BSD-Tahoe.

- 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).

Line 251

- When .Fn arguments exceed one output line, all but the first

should be indented, see e.g. rpc(3);

reported by jmc@ on discuss@ Fri, 29 Oct 2010 13:48:33 +0100

- .Ns should only be effective when called by another macro,

not as a stand-alone macro at the beginning of a line;

see for example the awk(1) SYNOPSIS.

- .Ns should work when called at the end of an input line, see

the following code in vi(1):