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

Diff for /mandoc/TODO between version 1.22 and 1.33

version 1.22, 2010/07/03 00:48:09 version 1.33, 2010/07/25 18:22:18
Line 1 
Line 1 
 ************************************************************************  ************************************************************************
   * Official mandoc TODO.  May not be quite up to date.
   * $Id$
   ************************************************************************
   
   ************************************************************************
 * missing features  * missing features
 ************************************************************************  ************************************************************************
   
Line 9 
Line 14 
 - fix bad block nesting involving multiple identical explicit blocks  - fix bad block nesting involving multiple identical explicit blocks
   see the OpenBSD mdoc_macro.c 1.47 commit message    see the OpenBSD mdoc_macro.c 1.47 commit message
   
 - we need real .ds; for example, terminfo.3 has  
   .ds n 5  
   and then later  
   \fBterminfo\fR(\*n)  
   reported orally by halex@ during c2k10  
   
 - \*(Pu is not implemented, but used in mdoc.samples  
   implementing .ds would solve this as well  
   reminded by jmc@, last on Sun, 27 Jun 2010 15:29:18 +0100  
   
 - .Bl -column .Xo support is missing  - .Bl -column .Xo support is missing
   ultimate goal:    ultimate goal:
   restore .Xr and .Dv to    restore .Xr and .Dv to
Line 26 
Line 21 
   lib/libc/gen/signal.3    lib/libc/gen/signal.3
   lib/libc/sys/sigaction.2    lib/libc/sys/sigaction.2
   
   - edge case: decide how to deal with blk_full bad nesting, e.g.
     .Sh .Nm .Bk .Nm .Ek .Sh found by jmc@ in ssh-keygen(1)
     from jmc@  Wed, 14 Jul 2010 18:10:32 +0100
   
   - auto-Bk in the SYNOPSIS
     patch from kristaps@  Fri, 16 Jul 2010 14:51:24 +0200
     to be revisited after OpenBSD 4.8 tree unlock
   
 - implement \\  - implement \\
   in plain text, identical to \e    in plain text, identical to \e
   as a macro argument, identical to \ i.e. escaping the next character    as a macro argument, identical to \ i.e. escaping the next character
Line 33 
Line 36 
   \\ must behave in a macro def like in a macro argument,    \\ must behave in a macro def like in a macro argument,
   and when using the macro, it must expand yet again.    and when using the macro, it must expand yet again.
   
 - implement \s (physical font size)  
   \sN - set to N  
   \s+N - increment by N, 1 <= N <= 8  
   \s-N - decrement by N, 1 <= N <= 8  
   \s0 - restore previous size  
   \s(nn \s+-(nn \s'+-nn' \s+-'nn' \s[+-nn] \s+-[nn] - disambiguate  
   registers: .s .ps .sr .psr  
   used by e.g. cu(1), tip(1)  
   
 - look at bsd.lv tbl(1)  - look at bsd.lv tbl(1)
   from kristaps@  Fri, 11 Sep 2009 17:10:53 +0200    from kristaps@  Fri, 11 Sep 2009 17:10:53 +0200
   also look at the mail from Thomas Klausner wiz at NetBSD    also look at the mail from Thomas Klausner wiz at NetBSD
Line 65 
Line 59 
   
 - have a blank `It' head for `Bl -tag' not puke  - have a blank `It' head for `Bl -tag' not puke
   
 - ignore horrendous m[] font colouring  
   reported by J.C. Roberts  
   
 - prohibit `Nm' from having non-text HEAD children  - prohibit `Nm' from having non-text HEAD children
   (e.g., NetBSD mDNSShared/dns-sd.1)    (e.g., NetBSD mDNSShared/dns-sd.1)
   (mdoc_html.c and mdoc_term.c `Nm' handlers can be slightly simplified)    (mdoc_html.c and mdoc_term.c `Nm' handlers can be slightly simplified)
Line 76 
Line 67 
 * formatting issues: ugly output  * formatting issues: ugly output
 ************************************************************************  ************************************************************************
   
 - outside list context, text following .Sm off  - boot_config.8
   seems to follow without a blank (TERM_NOBLANK reset late?) e.g.      .Bd -literal
         .Sm off      .No UKC> Ic find ne
         .Xo      24 ne0 at isa0
         .Op Ar bind_address No /    should be
         .Ar port      UKC> find ne
         .Xc      24 ne0 at isa0
         .Sm on    but is
         or by enclosing      UKC>find ne24 ne0 at isa0
   reported by jmc Tue, 13 Apr 2010 08:48:14 +0100    from jmc@  Wed, 21 Jul 2010 22:40:02 +0100
   
 - indentation got lost in SYNOPSIS, e.g.  - perl(1) SYNOPSIS looks bad; reported by deraadt@
    SYNOPSIS    1) man(7) seems to need SYNOPSIS .Nm blocks, too
         date [-ajnu] [-d dst] [-r seconds] [-t minutes_west] [+format]  
   -          [[[[[[cc]yy]mm]dd]HH]MM[.SS]]  
   +     [[[[[[cc]yy]mm]dd]HH]MM[.SS]]  
   reminded by Ludo Smissaert  Mon, 10 May 2010 12:15:11 +0200  
   
 - empty phrases in .Bl column produce too few blanks  - empty phrases in .Bl column produce too few blanks
   try e.g. .Bl -column It Ta Ta    try e.g. .Bl -column It Ta Ta
Line 110 
Line 97 
   
 Several areas can be cleaned up to make mandoc even faster.  These are  Several areas can be cleaned up to make mandoc even faster.  These are
   
 - improve caching mechanism to handle other per-element arguments so  
   that they need not be recalculated between front- and back-ends (also  
   reduces code size and complexity):  
     `Bl -column' pointer  
   
 - improve hashing mechanism for macros (quite important: performance)  - improve hashing mechanism for macros (quite important: performance)
   
 - improve hashing mechanism for characters (not as important)  - improve hashing mechanism for characters (not as important)
   
   ************************************************************************
   * structural issues
   ************************************************************************
   
   - rendering frontend code can calculate widths only for plain strings,
     not for strings containing escape sequences.  For example, this
     hinders calculation of the indent required for .Nm \&[ in text(1).
     comments from kristaps@  Wed, 21 Jul 2010 23:26:08 +0200
   
Legend:
Removed from v.1.22  
changed lines
  Added in v.1.33
CVSweb