mandoc/TODO - diff

Return to TODO CVS log

Up to [cvsweb.bsd.lv] / mandoc

Diff for /mandoc/TODO between version 1.16 and 1.19

version 1.16, 2010/06/13 22:44:33

version 1.19, 2010/06/30 23:57:30

Line 6

at the end of the enclosing block, e.g. .Bl It (El) Sh

reminded by stsp@ in net/pptp pptp.8 Fri, 23 Apr 2010 20:32:39 +0200

- fix bad block nesting involving multiple identical explicit blocks

see the OpenBSD mdoc_macro.c 1.47 commit message

- we need real .ds; for example, terminfo.3 has

.ds n 5

and then later

\fBterminfo\fR(\*n)

reported orally by halex@ during c2k10

- \*(Pu is not implemented, but used in mdoc.samples

implementing .ds would solve this as well

reminded by jmc@, last on Sun, 27 Jun 2010 15:29:18 +0100

- .Bl -column .Xo support is missing

ultimate goal:

restore .Xr and .Dv to

Line 13

Line 26

lib/libc/gen/signal.3

lib/libc/sys/sigaction.2

- .Bk / .Ek is broken, e.g.

$ man ssh

[...]

ssh [-1246AaCfgKkMNnqsTtVvXxYy] [-b bind_address] [-c cipher_spec] [-D

[bind_address:]port] [-e escape_char] [-F configfile] [-I pkcs11]

reminded by Ludo Smissaert Mon, 10 May 2010 12:15:11 +0200

also reported by jmc@ earlier

- implement \\

in plain text, identical to \e

as a macro argument, identical to \ i.e. escaping the next character

Line 30

Line 35

- look at bsd.lv tbl(1)

from kristaps@ Fri, 11 Sep 2009 17:10:53 +0200

also look at the mail from Thomas Klausner wiz at NetBSD

on Wed, 2 Jun 2010 11:01:29 +0200

- look at pages generated from reStructeredText, e.g. devel/mercurial hg(1)

These are a weird mixture of man(7) and custom autogenerated low-level

Line 67

Line 74

or by enclosing

reported by jmc Tue, 13 Apr 2010 08:48:14 +0100

- URGENT, this is making many kernel manuals look bad:

.Ft/.Fn should MAYBE behave in custom section like in SYNOPSIS?

autoconf.9:

.Sh DIRECT CONFIGURATION

.nr nS 1

.Ft "struct device *"

.Fn config_found_sm "struct device *parent"

groff:

DIRECT CONFIGURATION

struct device *

config_found_sm(struct device *parent, ...

reported by sthen Tue, 20 Apr 2010 13:42:51 +0100

- indentation got lost in SYNOPSIS, e.g.

SYNOPSIS

date [-ajnu] [-d dst] [-r seconds] [-t minutes_west] [+format]

Line 95

Line 89

* formatting issues: gratuitious differences

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

- FIXED OpenBSD mdoc.c 1.52 schwarze 16.5.10

- none reported right now (yet schwarze@ knows of some)

lines containing blank characters, and nothing else,

in literal context (.Bd -literal):

groff outputs just blank lines "\n"

mandoc outputs blanks to the left margin,

then the number of balnks minus one

NEEDS MERGING TO bsd.lv

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

* parser errors without any effect on formatting

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

- OpenBSD::PackageName(3p) has "if (block) 90:1" in the parse tree

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

* performance issues

CVSweb