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

Diff for /mandoc/TODO between version 1.16 and 1.22

version 1.16, 2010/06/13 22:44:33 version 1.22, 2010/07/03 00:48:09
Line 6 
Line 6 
   at the end of the enclosing block, e.g. .Bl It (El) Sh    at the end of the enclosing block, e.g. .Bl It (El) Sh
   reminded by stsp@  in net/pptp pptp.8  Fri, 23 Apr 2010 20:32:39 +0200    reminded by stsp@  in net/pptp pptp.8  Fri, 23 Apr 2010 20:32:39 +0200
   
   - fix bad block nesting involving multiple identical explicit blocks
     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 13 
Line 26 
   lib/libc/gen/signal.3    lib/libc/gen/signal.3
   lib/libc/sys/sigaction.2    lib/libc/sys/sigaction.2
   
 - .Bk / .Ek is broken, e.g.  
   $ man ssh  
   [...]  
   ssh [-1246AaCfgKkMNnqsTtVvXxYy] [-b bind_address] [-c cipher_spec] [-D  
   [bind_address:]port] [-e escape_char] [-F configfile] [-I pkcs11]  
   reminded by Ludo Smissaert  Mon, 10 May 2010 12:15:11 +0200  
   also reported by jmc@ earlier  
   
 - 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 28 
Line 33 
   \\ 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
       on Wed, 2 Jun 2010 11:01:29 +0200
   
 - look at pages generated from reStructeredText, e.g. devel/mercurial hg(1)  - look at pages generated from reStructeredText, e.g. devel/mercurial hg(1)
   These are a weird mixture of man(7) and custom autogenerated low-level    These are a weird mixture of man(7) and custom autogenerated low-level
Line 51 
Line 67 
   
 - ignore horrendous m[] font colouring  - ignore horrendous m[] font colouring
   reported by J.C. Roberts    reported by J.C. Roberts
   
   - prohibit `Nm' from having non-text HEAD children
     (e.g., NetBSD mDNSShared/dns-sd.1)
     (mdoc_html.c and mdoc_term.c `Nm' handlers can be slightly simplified)
   
 ************************************************************************  ************************************************************************
 * formatting issues: ugly output  * formatting issues: ugly output
Line 67 
Line 87 
         or by enclosing          or by enclosing
   reported by jmc Tue, 13 Apr 2010 08:48:14 +0100    reported by jmc Tue, 13 Apr 2010 08:48:14 +0100
   
 - URGENT, this is making many kernel manuals look bad:  
   .Ft/.Fn should MAYBE behave in custom section like in SYNOPSIS?  
   autoconf.9:  
     .Sh DIRECT CONFIGURATION  
     .nr nS 1  
     .Ft "struct device *"  
     .Fn config_found_sm "struct device *parent"  
   groff:  
     DIRECT CONFIGURATION  
       struct device *  
       config_found_sm(struct device *parent, ...  
   reported by sthen  Tue, 20 Apr 2010 13:42:51 +0100  
   
 - indentation got lost in SYNOPSIS, e.g.  - indentation got lost in SYNOPSIS, e.g.
    SYNOPSIS     SYNOPSIS
         date [-ajnu] [-d dst] [-r seconds] [-t minutes_west] [+format]          date [-ajnu] [-d dst] [-r seconds] [-t minutes_west] [+format]
Line 95 
Line 102 
 * formatting issues: gratuitious differences  * formatting issues: gratuitious differences
 ************************************************************************  ************************************************************************
   
 - FIXED OpenBSD mdoc.c 1.52 schwarze 16.5.10  - none reported right now (yet schwarze@ knows of some)
   lines containing blank characters, and nothing else,  
   in literal context (.Bd -literal):  
   groff outputs just blank lines "\n"  
   mandoc outputs blanks to the left margin,  
   then the number of balnks minus one  
   NEEDS MERGING TO bsd.lv  
   
   
 ************************************************************************  ************************************************************************
 * parser errors without any effect on formatting  
 ************************************************************************  
   
 - OpenBSD::PackageName(3p) has "if (block) 90:1" in the parse tree  
   
 ************************************************************************  
 * performance issues  * performance issues
 ************************************************************************  ************************************************************************
   
Line 120  Several areas can be cleaned up to make mandoc even fa
Line 114  Several areas can be cleaned up to make mandoc even fa
   that they need not be recalculated between front- and back-ends (also    that they need not be recalculated between front- and back-ends (also
   reduces code size and complexity):    reduces code size and complexity):
     `Bl -column' pointer      `Bl -column' pointer
     `Bf' font type  
   
 - improve hashing mechanism for macros (quite important: performance)  - improve hashing mechanism for macros (quite important: performance)
   
Legend:
Removed from v.1.16  
changed lines
  Added in v.1.22
CVSweb