=================================================================== RCS file: /cvs/mandoc/TODO,v retrieving revision 1.326 retrieving revision 1.334 diff -u -p -r1.326 -r1.334 --- mandoc/TODO 2022/07/05 21:25:29 1.326 +++ mandoc/TODO 2023/11/24 05:02:18 1.334 @@ -1,6 +1,6 @@ ************************************************************************ * Official mandoc TODO. -* $Id: TODO,v 1.326 2022/07/05 21:25:29 schwarze Exp $ +* $Id: TODO,v 1.334 2023/11/24 05:02:18 schwarze Exp $ ************************************************************************ Many issues are annotated for difficulty as follows: @@ -68,10 +68,13 @@ are mere guesses, and some may be wrong. but watch out for regressions in the high-level parsers maybe it should not even remove comments? - consider T{\" -- tag.c, tag_put() should not put ASCII_HYPH into the tag file, - which happens when the tag contains "-" on the input side - weerd@ 28 Sep 2021 12:44:07 +0200 - loc * exist * algo * size * imp *** +- In the body of conditional requests, escape sequence expansion + must not be performed if the condition is false. This implies + the first part of a request line must be expanded before + request parsing (like it is now), but expansion in the second + part must be delayed. + to Nab 8 Aug 2023 20:05:32 +0200 Subject: if/ie d condition always true + loc ** exist *** algo *** size ** imp * ************************************************************************ @@ -154,6 +157,11 @@ are mere guesses, and some may be wrong. --- missing mdoc features ---------------------------------------------- +- support mixed case for section names + also, first section is not "NAME" should not appear more than once per page + Alejandro Colomar 28 Apr 2023 16:57:49 +0200 + loc * exist * algo * size * imp *** + - .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 * @@ -297,7 +305,11 @@ are mere guesses, and some may be wrong. --- missing misc features ---------------------------------------------- -- conisder whether man(1) fallback code in main.c/fs_*() can find files +- use the default volume headers for sections with suffixes + certainly affects man(7); possibly mdoc(7)?; and also groff(1) + Alejandro Colomar 21 Aug 2022 + +- consider whether man(1) fallback code in main.c/fs_*() can find files like man3c/fopen.3c (illumos, Solaris) and man3p/fopen.3p (POSIX) discussed with Robert Mustacchi 21 Sep 2021 10:39:40 -0700 loc * exist * algo ** size * imp ** @@ -307,12 +319,6 @@ are mere guesses, and some may be wrong. mail to sternenseemann 19 Aug 2021 19:11:50 +0200 loc * exist ** algo ** size * imp ** -- tag.c, tag_put() and callers like man_validate.c, check_tag() - should not mistake "\-" as a word-ending escape sequence but - instead translate it to plain "-" in the tag name - weerd@ 28 Sep 2021 12:44:07 +0200 - loc ** exist * algo * size * imp *** - - handle Unicode letters in tags in both HTML and terminal output thread "section headers with diacritics" starting with Mario Blaettermann 24 Mar 2022 18:13:23 +0100 @@ -341,6 +347,10 @@ are mere guesses, and some may be wrong. (3) undefined, just output the character -> perhaps WARNING loc *** exist ** algo ** size ** imp *** (parser reorg helps) +- man.conf(5) alias aliasname dirname or just -Mb -Mx -Mp + mail to jmc@ Mar 23, 2015 03:53:14PM +0100 + loc * exist * algo * size * imp ** + - kettenis wants base roff, ms, and me Fri, 1 Jan 2010 22:13:15 +0100 (CET) loc ** exist ** algo ** size *** imp * @@ -488,6 +498,10 @@ are mere guesses, and some may be wrong. --- HTML issues -------------------------------------------------------- +- support the idiom .TP .IP .TP for multi-paragraph list item bodies + to: Alejandro Colomar Thu, 19 Oct 2023 16:45:21 +0200 + loc ** exist ** algo ** size ** imp ** + - .Nm without an argument and .Bx cause premature Nab Sun, 5 Jun 2022 18:30:09 +0200 @@ -500,6 +514,9 @@ are mere guesses, and some may be wrong. mail to Oliver Corff 3 Jun 2021 17:28:02 +0200 more feedback from Oliver 3 Jun 2021 18:27:56 +0200 more feedback from Oliver 3 Jun 2021 23:37:18 +0200 + would also be useful for + https://github.com/gbdev/rgbds-www/blob/master/ + maintainer/support/man_postproc.awk - .Bd -unfilled should not use monospaced font anton@ 4 Mar 2021 08:19:35 +0100 @@ -516,6 +533,11 @@ are mere guesses, and some may be wrong. reported by Ted Bullock 11 Jan 2022 16:00:44 -0700 loc * exist * algo ? size ? imp * +- link from flags in the SYNOPSIS to their descriptions + https://github.com/gbdev/rgbds-www/blob/master/ + maintainer/support/man_postproc.awk + 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 @@ -613,6 +635,10 @@ are mere guesses, and some may be wrong. with .ps and .nf/.fi produce execessive blank lines, see libJudy and graphics/dcmtk. The parser reorg may help with this. +- The man(7) .UR macro produces UTF-8 angle brackets in -Tutf8 output mode + with groff, but ASCII <> with mandoc + Alejandro Colomar Mon, 7 Aug 2023 17:13:29 +0200 Subject: hostname + - trailing whitespace must be ignored even when followed by a font escape, see for example makes @@ -628,6 +654,14 @@ are mere guesses, and some may be wrong. - shorten/simplify error messages for usage errors To: deraadt@ 25 Oct 2020 23:37:01 +0100 loc ** exist * algo * size ** imp *** + +- warn about \\ and \. in interpretation mode + gbranden@, groff issue #62776, 10 Nov 2023 01:57:32 -0500 + +- warn about output lines exceeding 80 characters + Alejandro Colomar Aug 22, 2022 + not trivial because -T lint does not call any formatter + loc *** exist * algo ** size ** imp ** - warn about duplicate .Sh/.Ss heads gre(4): Rename duplicate sections 20 Apr 2018 15:27:33 +0200