1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
|
Before trying to fix anything from this list,
check against -current mandoc from OpenBSD CVS.
Sometimes, i'm a bit behind marking entries FIXED.
In general, i keep FIXED entries for some time
and remove them when they turn into old news.
************************************************************************
* missing features
************************************************************************
- explicit blocks with missing end macro should be implicitely closed
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
- .Bl -column .Xo support is missing
ultimate goal:
restore .Xr and .Dv to
lib/libc/compat-43/sigvec.3
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
- man(7) .TH should recognize "3p" as a section number
found in usr.bin/pkg_add OpenBSD::Getopt
- implement \\
in plain text, identical to \e
as a macro argument, identical to \ i.e. escaping the next character
We do not have macro definitions yet; if we implement them,
\\ must behave in a macro def like in a macro argument,
and when using the macro, it must expand yet again.
- look at bsd.lv tbl(1)
from kristaps@ Fri, 11 Sep 2009 17:10:53 +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
roff stuff. Figure out to what extent we can cope.
noted by stsp@ Sat, 24 Apr 2010 09:17:55 +0200
reminded by nicm@ Mon, 3 May 2010 09:52:41 +0100
- FIXED OpenBSD term.h 1.16 term.c 1.30 mdoc_term.c 1.75 schwarze 23.4.10
handle tab characters outside literal context, e.g. usb(4)
reported by jmc@ Mon, 19 Apr 2010 07:42:12 +0100
- FIXED OpenBSD man.h 1.15 libman.h 1.16 man_hash.c 1.9
man.c 1.25 man_macro.c 1.15 man_validate.c 1.19 man_action.c 1.15
man_term.c 1.28 man_html.c 1.9 schwarze 25.4.
implement .if .ie .el
noticed by espie@ Fri, 23 Apr 2010 17:10:35 +0200
- FIXED bsd.lv libman.h 1.31 libmdoc.h 1.34 man.c 1.60 mdoc.c 1.123
kristaps@ 8.4.10
FIXED OpenBSD libman.h 1.17 libmdoc.h 1.28 man.c 1.26 mdoc.c 1.45
schwarze@ 8.5.10
groff handles \." just like .\"
Thus, mandoc must also ignore such lines.
For an example, see tr(1).
reported by Claus Assmann Mon, 5 Apr 2010 08:46:30 -0700
************************************************************************
* formatting issues: ugly output
************************************************************************
- outside list context, text following .Sm off
seems to follow without a blank (TERM_NOBLANK reset late?) e.g.
.Sm off
.Xo
.Op Ar bind_address No /
.Ar port
.Xc
.Sm on
or by enclosing
reported by jmc Tue, 13 Apr 2010 08:48:14 +0100
- do not break the line after "--", it's probably a long option
reminded by stsp in net/pptp pptp.8 Fri, 23 Apr 2010 20:32:39 +0200
- in .Bl -column .It, "\t" seems to be synonymous to " Ta ",
see sysctl(3) for many examples;
mishandling this results in spurious quotes at EOL
reminded by guenther@ Mon, 26 Apr 2010 01:16:52 -0700
- 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]
- [[[[[[cc]yy]mm]dd]HH]MM[.SS]]
+ [[[[[[cc]yy]mm]dd]HH]MM[.SS]]
reminded by Ludo Smissaert Mon, 10 May 2010 12:15:11 +0200
- empty phrases in .Bl column produce too few blanks
try e.g. .Bl -column It Ta Ta
reported by millert Fri, 02 Apr 2010 16:13:46 -0400
- FIXED on bsd.lv for mdoc, need to merge and test in OpenBSD
kristaps@ Mon, 10 May 2010 03:12:44 +0200
man fix still pending!
in literal displays, ignore the right margin
reminded by stsp in net/pptp pptp.8 Fri, 23 Apr 2010 20:32:39 +0200
- FIXED on bsd.lv, need to merge and test in OpenBSD
kristaps@ Mon, 10 May 2010 02:59:40 +0200
do not mark \*(Ba and | up
e.g. .Op Fl c Ar string \*(Ba Fl s \*(Ba Ar file Op Ar argument ...
The first should not be in an .Ar font.
The second must not end up as -|.
When fixing, check whether this is a specific problem with this
character, or whether other characters are affected, too.
reminded by jmc@ Sat, 24 Apr 2010 06:54:26 +0100
************************************************************************
* formatting issues: gratuitious differences
************************************************************************
- in literal context, groff disables the right margin
an example: syslog.conf.5 EXAMPLES section
reported by jmc Tue, 13 Apr 2010 10:12:15 +0100
solution: raise termp->maxrmargin in literal context
- 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
- FIXED bsd.lv mdoc_html.c 1.61 mdoc_term.c 1.117 kristaps@ 8.4.10
FIXED OpenBSD mdoc_html.c 1.12 mdoc_term.c 1.76 schwarze@ 8.5.10
mandoc .%T changed from quoted to underlined
reported by jmc Mon, 10 Aug 2009 05:50:21 +0100
************************************************************************
* parser errors without any effect on formatting
************************************************************************
- OpenBSD::PackageName(3p) has "if (block) 90:1" in the parse tree
|
