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

Diff for /mandoc/TODO between version 1.298 and 1.306

version 1.298, 2019/12/22 13:52:35 version 1.306, 2020/09/07 14:18:49
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.
   
 ************************************************************************  ************************************************************************
 * crashes  * assertion failures
 ************************************************************************  ************************************************************************
   
 - .ce .if n .B two crashes because "return (*roffs[t].sub)" bypasses  - .if n .ce in the middle of .TS data
   the "high level macros abort .ce" safeguard in roff_parseln()    afl case f1/id:000103,sig:06,src:009024+009105,op:splice,rep:2 (jes@)
   reported by espie@ in textproc/fstrcmp    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  * missing features
Line 91  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    Jan Stary 20 Apr 2019 20:16:54 +0200
   loc *  exist ***  algo ***  size **  imp *    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 ----------------------------------------------  --- 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 229  are mere guesses, and some may be wrong.
Line 255  are mere guesses, and some may be wrong.
   
 --- missing misc features ----------------------------------------------  --- missing misc features ----------------------------------------------
   
   - -T man does not handle eqn(7) and tbl(7)
     Stephen Gregoratto 16 Feb 2020 01:28:07 +1100
     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
   
 - italic correction (\/) in PostScript mode  - italic correction (\/) in PostScript mode
Line 575  are mere guesses, and some may be wrong.
Line 605  are mere guesses, and some may be wrong.
 * CGI issues  * 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   - Enable HTTP compression by detecting gzip encoding and filtering
    output through libz.     output through libz.
  - Privilege separation (see OpenSSH).   - Privilege separation (see OpenSSH).
Line 587  are mere guesses, and some may be wrong.
Line 620  are mere guesses, and some may be wrong.
 - delete OS release verification from .Dx, .Fx, .Nx, .Ox etc.  - delete OS release verification from .Dx, .Fx, .Nx, .Ox etc.
   https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=629161    https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=629161
   also Branden Robinson 18 Dec 2019 00:59:52 +1100    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:  - .Cd # arch1, arch2 in section 4 pages:
   find better way to indicate multiple architectures, maybe:    find better way to indicate multiple architectures, maybe:
Legend:
Removed from v.1.298  
changed lines
  Added in v.1.306
CVSweb