mandoc/TODO - diff

Return to TODO CVS log

Up to [cvsweb.bsd.lv] / mandoc

Diff for /mandoc/TODO between version 1.292 and 1.305

version 1.292, 2019/04/30 18:51:57

version 1.305, 2020/09/01 18:10:28

Line 83 are mere guesses, and some may be wrong.

Jan Stary 20 Apr 2019 20:16:54 +0200

loc * exist *** algo *** size ** imp *

- mandoc replaces all ASCII control characters except tab and line feed

with '?' during input. It would be better to replace them with

Unicode escapes in preconv_encode() or somewhere in the vicinity,

such that the already existing better replacement strings show

up in the output. Emulating groff is not desirable: groff replaces

0x00, 0x0b, and 0x0d to 0x1f with the empty string (bad because

that's easy to overlook for the document author), 0x01 with '.'

(very confusing), and passes through 0x02 to 0x08, 0x0c, and 0x7f

raw (bad because that is insecure output). Remember that 0x07 may

need special handling because it is sometimes used for certain

delimiters, so it may need handling *after* roff.c rather than before.

reminded by John Gardner 16 Jun 2020 14:26:28 +1000

Actually, more ASCII control characters than just 0x07 may need

later handling because they can for example be used in macro names.

So they may need handling after roff(7) processing.

pointed out by John Gardner 23 Jun 2020 18:28:08 +1000

more info from John Gardner 29 Jun 2020 19:54:04 +1000

loc ** exist ** algo ** size ** imp *

--- missing mdoc features ----------------------------------------------

- .Sh and .Ss should be parsed and partially callable, see groff_mdoc(7)

reed at reedmedia dot net Sat, 21 Dec 2019 17:13:07 -0600

loc ** exist ** algo ** size ** imp *

- .Bl -column .Xo support is missing

ultimate goal:

restore .Xr and .Dv to

Line 217 are mere guesses, and some may be wrong.

Line 240 are mere guesses, and some may be wrong.

--- missing misc features ----------------------------------------------

- man 3am readline

- -T man does not handle eqn(7) and tbl(7)

does not work because man(1) only accepts digit + one letter,

Stephen Gregoratto 16 Feb 2020 01:28:07 +1100

otherwise explicit -s is currently required

loc ** exist ** algo ** size *** imp **

https://github.com/void-linux/void-packages/issues/9868

loc * exist * algo * size * imp ***

- man 3 readline may show readline(3m)

because in manpage_compare, "3" and "3am" compare equal

https://github.com/void-linux/void-packages/issues/9868

probably requires putting string version of section into struct manpage

loc * exist ** algo * size * imp ***

- dead .so links should be entered into the database to avoid:

man -M. lvm-config

man: outdated mandoc.db lacks lvm-config(8) entry, run makewhatis /co/void-man

https://github.com/void-linux/void-packages/issues/9868

loc * exist ** algo * size * imp **

- man -ks 1,8 route; kn@ Jul 13, 2018 orally

- italic correction (\/) in PostScript mode

Line 303 are mere guesses, and some may be wrong.

Line 312 are mere guesses, and some may be wrong.

https://github.com/schmonz/ikiwiki/compare/mandoc

Amitai Schlair Mon, 19 May 2014 14:05:53 -0400

- check compatibility with

https://git.sr.ht/~sircmpwn/scdoc

- check features of the Slackware man.conf(5) format

Carsten Kunze Wed, 11 Mar 2015 17:57:24 +0100

Line 389 are mere guesses, and some may be wrong.

Line 401 are mere guesses, and some may be wrong.

--- HTML issues --------------------------------------------------------

- get rid of the last handful of style= attributes such that

Content-Security-Policy: can be enabled without unsafe-inline

suggested by bentley@ Nov 10, 2019 at 06:02:49AM -0700

loc * exist * algo * size * imp **

- .Bf at the beginning of a paragraph inserts a bogus 1ex horizontal

space, see for example random(3). Introduced in

http://mdocml.bsd.lv/cgi-bin/cvsweb/mdoc_html.c.diff?r1=1.91&r2=1.92

Line 401 are mere guesses, and some may be wrong.

Line 418 are mere guesses, and some may be wrong.

https://github.com/Debian/debiman/issues/15

loc * exist * algo ** size ** imp **

- space characters can end up in href= attributes, for example coming

from the first .Xr argument (where they make no sense, but still);

does this affect other characters, other source macros...?

Jackson Pauls 29 Aug 2017 16:56:27 +0100

- The tables used to render the three-part page headers actually force

the width of the <body> to the max-width given for <html>.

Not yet sure how to fix that...

Line 568 are mere guesses, and some may be wrong.

Line 590 are mere guesses, and some may be wrong.

* CGI issues

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

- Inspect httpd(8) logs on man.openbsd.org and consider

whether logging can be improved, where bad syntax comes from,

and what needs to be done to get rid of COMPAT_OLDURI.

- Enable HTTP compression by detecting gzip encoding and filtering

output through libz.

- Privilege separation (see OpenSSH).

Line 576 are mere guesses, and some may be wrong.

Line 601 are mere guesses, and some may be wrong.

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

* to improve in the groff_mdoc(7) macros

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

- delete OS release verification from .Dx, .Fx, .Nx, .Ox etc.

https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=629161

also Branden Robinson 18 Dec 2019 00:59:52 +1100

- Can the distinction between .Vt and .Va be made stricter,

recommending .Vt extern char * Ns Va optarg ; ?

What about the block macro properties of .Vt in the SYNOPSIS?

zeurkous 25 Dec 2019 08:48:36 +0100

- .Cd # arch1, arch2 in section 4 pages:

find better way to indicate multiple architectures, maybe:

CVSweb