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

Diff for /mandoc/TODO between version 1.304 and 1.319

version 1.304, 2020/06/24 12:09:29 version 1.319, 2021/09/21 17:58:13
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{\"
   
   
   ************************************************************************
 * missing features  * missing features
 ************************************************************************  ************************************************************************
   
Line 99  are mere guesses, and some may be wrong.
Line 136  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 221  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 292  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 **
   
 - -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 381  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 464  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 **
   
 - 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 588  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 626  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.319
CVSweb