mandoc/TODO - diff

Return to TODO CVS log

Up to [cvsweb.bsd.lv] / mandoc

Diff for /mandoc/TODO between version 1.302 and 1.311

version 1.302, 2020/04/26 21:41:07

version 1.311, 2021/03/28 18:45:43

Line 33 Obviously, as the issues have not been solved yet, the

are mere guesses, and some may be wrong.

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

* assertion failures

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

- .if n .ce in the middle of .TS data

afl case f1/id:000103,sig:06,src:009024+009105,op:splice,rep:2 (jes@)

While roff_parseln() prevents .ce and similar requests in the middle

of a tbl, the guard is no longer effective when the .ce is wrapped

in a roff block, for example a conditional. The resulting assertion

has never been seen in any real-world manual page.

This is too dangerous to fix before release because it requires

reorganizing the very delicate internals of roff_parseln(),

which risks causing more severe bugs.

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

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

* missing features

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

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

Line 98 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 *

- many missing features used in old groff_char(7),

some can possibly be supported

kamil at netbsd 12 Nov 2020 17:27:09 +0100 + reply

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

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

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

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

--- missing man features -----------------------------------------------

- MANWIDTH

Markus Waldeck <waldeck at gmx dot de> 9 Jun 2015 05:49:56 +0200

Laura Morales <lauretas at mail dot com> 26 Apr 2018 08:15:55 +0200

Kamil Rytarowski <kamil at netbsd> 13 Nov 2020 00:19:36 +0100

patch from Kamil 13 Nov 2020 22:37:07 +0100

loc * exist * algo * size * imp *

- groff_www(7) .MTO and .URL

These macros were used by the GNU grep(1) man page.

The groff_www(7) manual page itself uses them, too.

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

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

add a new <</Type /Font>> block to the PDF files with /BaseFont /Courier

and change the /Name from /F0 to the new font (/F5 (?)).

re-reported by tb@ Mon, 16 Mar 2015 16:47:21 +0100

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

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

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

- .Bd -unfilled should not use monospaced font

anton@ 4 Mar 2021 08:19:35 +0100

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

- 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

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

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

* warning issues

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

- shorten/simplify error messages for usage errors

To: deraadt@ 25 Oct 2020 23:37:01 +0100

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

- warn about duplicate .Sh/.Ss heads

gre(4): Rename duplicate sections 20 Apr 2018 15:27:33 +0200

loc * exist * algo * size * imp **

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

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

of a text line, if it is likely intended to follow the preceding

output without intervening whitespace, in particular after a

macro line (from the mdoclint TODO)

- report double .TH in man(7) as an ERROR and let the first win

kristaps@ 28 Mar 2021 13:30:41 +0200

loc * exist * algo * size * imp *

- makewhatis -p complains about language subdirectories:

/usr/local/man//ru: Unknown directory part

CVSweb