mandoc/TODO - diff

Return to TODO CVS log

Up to [cvsweb.bsd.lv] / mandoc

Diff for /mandoc/TODO between version 1.83 and 1.93

version 1.83, 2011/01/24 01:34:56

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

Line 10

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

Line 151

* 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 219

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 252

Line 237

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

.It Xo

Line 265

Line 246

.Xc

The input text is appended after the specified line.

- When we have both .%T and .%B in .Rs, .%T uses "", not underline, see

for example arp(4); admittedly, arp(4) is abusing both .%T and .%B,

but when dealing with anthologies, sensible use of of both in the

same .Rs can occur.

- Header lines of excessive length:

Port OpenBSD man_term.c rev. 1.25 to mdoc_term.c

and document it in mdoc(7) and man(7) COMPATIBILITY

Line 302

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 320 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