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

Diff for /mandoc/TODO between version 1.2 and 1.9

version 1.2, 2010/05/15 09:28:11 version 1.9, 2010/05/25 13:42:51
Line 21 
Line 21 
   reminded by Ludo Smissaert  Mon, 10 May 2010 12:15:11 +0200    reminded by Ludo Smissaert  Mon, 10 May 2010 12:15:11 +0200
   also reported by jmc@ earlier    also reported by jmc@ earlier
   
 - man(7) .TH should recognize "3p" as a section number  
   found in usr.bin/pkg_add OpenBSD::Getopt  
   
 - 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 72 
Line 69 
 - do not break the line after "--", it's probably a long option  - do not break the line after "--", it's probably a long option
   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
   
 - in .Bl -column .It, "\t" seems to be synonymous to " Ta ",  
   see sysctl(3) for many examples;  
   mishandling this results in spurious quotes at EOL  
   reminded by guenther@  Mon, 26 Apr 2010 01:16:52 -0700  
   
 - URGENT, this is making many kernel manuals look bad:  - URGENT, this is making many kernel manuals look bad:
   .Ft/.Fn should MAYBE behave in custom section like in SYNOPSIS?    .Ft/.Fn should MAYBE behave in custom section like in SYNOPSIS?
   autoconf.9:    autoconf.9:
Line 101 
Line 93 
   try e.g. .Bl -column It Ta Ta    try e.g. .Bl -column It Ta Ta
   reported by millert Fri, 02 Apr 2010 16:13:46 -0400    reported by millert Fri, 02 Apr 2010 16:13:46 -0400
   
   - nroff inserts a space before :, mandoc doesn't:
       .Dl expr "/$a" Li : '.*/\e(.*\e)'
   
 ************************************************************************  ************************************************************************
 * formatting issues: gratuitious differences  * formatting issues: gratuitious differences
 ************************************************************************  ************************************************************************
   
 - in literal context, groff disables the right margin  - FIXED OpenBSD mdoc.c 1.52 schwarze 16.5.10
   an example: syslog.conf.5 EXAMPLES section    lines containing blank characters, and nothing else,
   reported by jmc Tue, 13 Apr 2010 10:12:15 +0100  
   solution: raise termp->maxrmargin in literal context  
   
 - lines containing blank characters, and nothing else,  
   in literal context (.Bd -literal):    in literal context (.Bd -literal):
   groff outputs just blank lines "\n"    groff outputs just blank lines "\n"
   mandoc outputs blanks to the left margin,    mandoc outputs blanks to the left margin,
   then the number of balnks minus one    then the number of balnks minus one
     NEEDS MERGING TO bsd.lv
   
   
 ************************************************************************  ************************************************************************
Line 124 
Line 115 
   
 - OpenBSD::PackageName(3p) has "if (block) 90:1" in the parse tree  - OpenBSD::PackageName(3p) has "if (block) 90:1" in the parse tree
   
   ************************************************************************
   * performance issues
   ************************************************************************
   
   Several areas can be cleaned up to make mandoc even faster.  These are
   
   - cache `Bd' display types as `Bl' types are cached (this primarily
     improves code-size by removing the a2disp type functions)
   
   - 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)
   
   - improve hashing mechanism for macros (quite important: performance)
   
   - improve hashing mechanism for characters (not as important)
Legend:
Removed from v.1.2  
changed lines
  Added in v.1.9
CVSweb