[BACK]Return to TODO CVS log [TXT][DIR] Up to [cvsweb.bsd.lv] / mandoc

Diff for /mandoc/TODO between version 1.304 and 1.322

version 1.304, 2020/06/24 12:09:29 version 1.322, 2022/03/27 11:08:24
Line 33  Obviously, as the issues have not been solved yet, the
Line 33  Obviously, as the issues have not been solved yet, the
 are mere guesses, and some may be wrong.  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 *
   
   
   ************************************************************************
   * bugs: invalid output
   ************************************************************************
   
   - wrong number of layout columns in tbl(7) code generated by -T man
     https://savannah.gnu.org/bugs/?57720
     The reason likely is that tbl(7) does not support the -Bl -column
     feature of not explicitly specifying the last table column.
     loc **  exist *  algo **  size *  imp ***
   
   - eqn(7) delimiters cause conditional lines to misbehave
     nabijaczleweli 8 Sep 2021 15:24:48 +0200
     loc *  exist ***  algo ***  size *  imp *
   
   - roff.c, roff_expand() should not remove blanks before comments
     to Oliver Corff, Sep 7, 2021
     loc *  exist *  algo *  size *  imp *
     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 ***
   
   
   ************************************************************************
 * missing features  * missing features
 ************************************************************************  ************************************************************************
   
Line 99  are mere guesses, and some may be wrong.
Line 141  are mere guesses, and some may be wrong.
   later handling because they can for example be used in macro names.    later handling because they can for example be used in macro names.
   So they may need handling after roff(7) processing.    So they may need handling after roff(7) processing.
   pointed out by John Gardner 23 Jun 2020 18:28:08 +1000    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 *    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
   
   - \s with arbitrary arg delimiters as already supported for other escapes
     found following jmc@'s mail 28 Apr 2021 18:31:41 +0100
     loc *  exist *  algo *  size *  imp *
   
 --- missing mdoc features ----------------------------------------------  --- missing mdoc features ----------------------------------------------
   
 - .Sh and .Ss should be parsed and partially callable, see groff_mdoc(7)  - .Sh and .Ss should be parsed and partially callable, see groff_mdoc(7)
Line 175  are mere guesses, and some may be wrong.
Line 226  are mere guesses, and some may be wrong.
   
 --- missing man features -----------------------------------------------  --- 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  - groff_www(7) .MTO and .URL
   These macros were used by the GNU grep(1) man page.    These macros were used by the GNU grep(1) man page.
   The groff_www(7) manual page itself uses them, too.    The groff_www(7) manual page itself uses them, too.
Line 239  are mere guesses, and some may be wrong.
Line 297  are mere guesses, and some may be wrong.
   
 --- missing misc features ----------------------------------------------  --- missing misc features ----------------------------------------------
   
   - conisder 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 **
   
   - let makewhatis(8) follow symbolic links to dirs below READ_ALLOWED_PATH
     this may be feasible using fts_set(FTS_FOLLOW)
     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
     loc **  exist *  algo *  size *  imp **
   
 - -T man does not handle eqn(7) and tbl(7)  - -T man does not handle eqn(7) and tbl(7)
   Stephen Gregoratto 16 Feb 2020 01:28:07 +1100    Stephen Gregoratto 16 Feb 2020 01:28:07 +1100
     also https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=901636
   loc **  exist **  algo **  size ***  imp **    loc **  exist **  algo **  size ***  imp **
   
 - man -ks 1,8 route; kn@ Jul 13, 2018 orally  - man -ks 1,8 route; kn@ Jul 13, 2018 orally
Line 317  are mere guesses, and some may be wrong.
Line 397  are mere guesses, and some may be wrong.
 - check features of the Slackware man.conf(5) format  - check features of the Slackware man.conf(5) format
   Carsten Kunze  Wed, 11 Mar 2015 17:57:24 +0100    Carsten Kunze  Wed, 11 Mar 2015 17:57:24 +0100
   
   - look at http://www.snake.net/software/troffcvt/  (troff to HTML)
     mentioned by Oliver Corff  22 Jan 2021 01:36:49 +0100
   
   
 ************************************************************************  ************************************************************************
 * formatting issues: ugly output  * formatting issues: ugly output
 ************************************************************************  ************************************************************************
Line 396  are mere guesses, and some may be wrong.
Line 480  are mere guesses, and some may be wrong.
     add a new <</Type /Font>> block to the PDF files with /BaseFont /Courier      add a new <</Type /Font>> block to the PDF files with /BaseFont /Courier
     and change the /Name from /F0 to the new font (/F5 (?)).      and change the /Name from /F0 to the new font (/F5 (?)).
   re-reported by tb@ Mon, 16 Mar 2015 16:47:21 +0100    re-reported by tb@ Mon, 16 Mar 2015 16:47:21 +0100
   loc *  exist **  algo **  size *  imp **    loc **  exist **  algo **  size *  imp **
   
 --- HTML issues --------------------------------------------------------  --- HTML issues --------------------------------------------------------
   
   - make the HTML scaffolding customozable with -O skip=...
     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
   
   - .Bd -unfilled should not use monospaced font
     anton@  4 Mar 2021 08:19:35 +0100
     loc **  exist *  algo *  size *  imp **
   
   - HTML formatting of .nf should avoid <br/>
     and not close and re-open <pre> on .P
     my mail to ports@ 27 Jun 2021 16:09:20 +0200
     loc **  exist **  algo *  size *  imp **
   
   - tbl(7) HTML output does not implement column width specifications
     reported by Ted Bullock 11 Jan 2022 16:00:44 -0700
     loc *  exist *  algo ?  size ?  imp *
   
 - get rid of the last handful of style= attributes such that  - get rid of the last handful of style= attributes such that
   Content-Security-Policy: can be enabled without unsafe-inline    Content-Security-Policy: can be enabled without unsafe-inline
   suggested by bentley@  Nov 10, 2019 at 06:02:49AM -0700    suggested by bentley@  Nov 10, 2019 at 06:02:49AM -0700
Line 506  are mere guesses, and some may be wrong.
Line 608  are mere guesses, and some may be wrong.
 * warning issues  * 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  - warn about duplicate .Sh/.Ss heads
   gre(4): Rename duplicate sections 20 Apr 2018 15:27:33 +0200    gre(4): Rename duplicate sections 20 Apr 2018 15:27:33 +0200
   loc *  exist *  algo *  size *  imp **    loc *  exist *  algo *  size *  imp **
Line 540  are mere guesses, and some may be wrong.
Line 646  are mere guesses, and some may be wrong.
   of a text line, if it is likely intended to follow the preceding    of a text line, if it is likely intended to follow the preceding
   output without intervening whitespace, in particular after a    output without intervening whitespace, in particular after a
   macro line (from the mdoclint TODO)    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:  - makewhatis -p complains about language subdirectories:
   /usr/local/man//ru: Unknown directory part    /usr/local/man//ru: Unknown directory part

Legend:
Removed from v.1.304  
changed lines
  Added in v.1.322

CVSweb