| version 1.25, 2010/07/11 22:39:32 |
version 1.33, 2010/07/25 18:22:18 |
|
|
| ************************************************************************ |
************************************************************************ |
| |
* Official mandoc TODO. May not be quite up to date. |
| |
* $Id$ |
| |
************************************************************************ |
| |
|
| |
************************************************************************ |
| * missing features |
* missing features |
| ************************************************************************ |
************************************************************************ |
| |
|
|
|
| lib/libc/gen/signal.3 |
lib/libc/gen/signal.3 |
| lib/libc/sys/sigaction.2 |
lib/libc/sys/sigaction.2 |
| |
|
| |
- edge case: decide how to deal with blk_full bad nesting, e.g. |
| |
.Sh .Nm .Bk .Nm .Ek .Sh found by jmc@ in ssh-keygen(1) |
| |
from jmc@ Wed, 14 Jul 2010 18:10:32 +0100 |
| |
|
| |
- auto-Bk in the SYNOPSIS |
| |
patch from kristaps@ Fri, 16 Jul 2010 14:51:24 +0200 |
| |
to be revisited after OpenBSD 4.8 tree unlock |
| |
|
| - implement \\ |
- implement \\ |
| in plain text, identical to \e |
in plain text, identical to \e |
| as a macro argument, identical to \ i.e. escaping the next character |
as a macro argument, identical to \ i.e. escaping the next character |
|
|
| \\ must behave in a macro def like in a macro argument, |
\\ must behave in a macro def like in a macro argument, |
| and when using the macro, it must expand yet again. |
and when using the macro, it must expand yet again. |
| |
|
| - implement \s (physical font size) |
|
| \sN - set to N |
|
| \s+N - increment by N, 1 <= N <= 8 |
|
| \s-N - decrement by N, 1 <= N <= 8 |
|
| \s0 - restore previous size |
|
| \s(nn \s+-(nn \s'+-nn' \s+-'nn' \s[+-nn] \s+-[nn] - disambiguate |
|
| registers: .s .ps .sr .psr |
|
| used by e.g. cu(1), tip(1) |
|
| |
|
| - look at bsd.lv tbl(1) |
- look at bsd.lv tbl(1) |
| from kristaps@ Fri, 11 Sep 2009 17:10:53 +0200 |
from kristaps@ Fri, 11 Sep 2009 17:10:53 +0200 |
| also look at the mail from Thomas Klausner wiz at NetBSD |
also look at the mail from Thomas Klausner wiz at NetBSD |
|
|
| |
|
| - have a blank `It' head for `Bl -tag' not puke |
- have a blank `It' head for `Bl -tag' not puke |
| |
|
| - ignore horrendous m[] font colouring |
|
| reported by J.C. Roberts |
|
| |
|
| - prohibit `Nm' from having non-text HEAD children |
- prohibit `Nm' from having non-text HEAD children |
| (e.g., NetBSD mDNSShared/dns-sd.1) |
(e.g., NetBSD mDNSShared/dns-sd.1) |
| (mdoc_html.c and mdoc_term.c `Nm' handlers can be slightly simplified) |
(mdoc_html.c and mdoc_term.c `Nm' handlers can be slightly simplified) |
|
|
| * formatting issues: ugly output |
* formatting issues: ugly output |
| ************************************************************************ |
************************************************************************ |
| |
|
| - outside list context, text following .Sm off |
- boot_config.8 |
| seems to follow without a blank (TERM_NOBLANK reset late?) e.g. |
.Bd -literal |
| .Sm off |
.No UKC> Ic find ne |
| .Xo |
24 ne0 at isa0 |
| .Op Ar bind_address No / |
should be |
| .Ar port |
UKC> find ne |
| .Xc |
24 ne0 at isa0 |
| .Sm on |
but is |
| or by enclosing |
UKC>find ne24 ne0 at isa0 |
| reported by jmc Tue, 13 Apr 2010 08:48:14 +0100 |
from jmc@ Wed, 21 Jul 2010 22:40:02 +0100 |
| |
|
| |
- perl(1) SYNOPSIS looks bad; reported by deraadt@ |
| |
1) man(7) seems to need SYNOPSIS .Nm blocks, too |
| |
|
| - empty phrases in .Bl column produce too few blanks |
- empty phrases in .Bl column produce too few blanks |
| try e.g. .Bl -column It Ta Ta |
try e.g. .Bl -column It Ta Ta |
| reported by millert Fri, 02 Apr 2010 16:13:46 -0400 |
reported by millert Fri, 02 Apr 2010 16:13:46 -0400 |
| Line 101 Several areas can be cleaned up to make mandoc even fa |
|
| Line 105 Several areas can be cleaned up to make mandoc even fa |
|
| * structural issues |
* structural issues |
| ************************************************************************ |
************************************************************************ |
| |
|
| - The regs.h functionality and the roff_getstrn() family should be moved |
- rendering frontend code can calculate widths only for plain strings, |
| into mandoc.c, which should be accessable by libroff, libmdoc, and |
not for strings containing escape sequences. For example, this |
| libman. Right now there's pollution between these libraries. |
hinders calculation of the indent required for .Nm \&[ in text(1). |
| |
comments from kristaps@ Wed, 21 Jul 2010 23:26:08 +0200 |
| |
|
![[BACK]](/cvsweb/icons/back.gif){kind=icon}
Return to TODO CVS log ![[TXT]](/cvsweb/icons/text.gif){kind=icon}
![[DIR]](/cvsweb/icons/dir.gif){kind=icon}
Up to [cvsweb.bsd.lv] / mandoc