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

Diff for /mandoc/TODO between version 1.240 and 1.246

version 1.240, 2017/07/19 21:48:37 version 1.246, 2017/07/24 11:15:12
Line 436  are mere guesses, and some may be wrong.
Line 436  are mere guesses, and some may be wrong.
   Probably, this should be fixed somewhere in termp_it_pre(), not sure.    Probably, this should be fixed somewhere in termp_it_pre(), not sure.
   loc *  exist **  algo **  size *  imp **    loc *  exist **  algo **  size *  imp **
   
 - .Nx 1.0a  
   should be "NetBSD 1.0A", not "NetBSD 1.0a",  
   see OpenBSD ccdconfig(8).  
   loc *  exist *  algo *  size *  imp **  
   
 - In .Bl -tag, if a tag exceeds the right margin and must be continued  
   on the next line, it must be indented by -width, not width+1;  
   see "rule block|pass" in OpenBSD ifconfig(8).  
   loc *  exist ***  algo **  size *  imp **  
   
 - When the -width string contains macros, the macros must be rendered  - When the -width string contains macros, the macros must be rendered
   before measuring the width, for example    before measuring the width, for example
     .Bl -tag -width ".Dv message"      .Bl -tag -width ".Dv message"
Line 481  are mere guesses, and some may be wrong.
Line 471  are mere guesses, and some may be wrong.
 * warning issues  * warning issues
 ************************************************************************  ************************************************************************
   
   - style message about macros inside .Bd -literal and .Dl, in particular
     font changing macros like .Cm, .Ar, .Fa (from the mdoclint TODO)
   
   - style message about mismatches between the section number in the
     file name (if it is known) and the section number in .Dt
     (from the mdoclint TODO)
   
   - style message about NULL without .Dv (from the mdoclint TODO)
   
   - style message about error constants without .Er (from the mdoclint TODO)
   
 - warn when .Sh or .Ss contain other macros  - warn when .Sh or .Ss contain other macros
   Steffen Nurpmeso, savannah.gnu.org/bugs/index.php?45034    Steffen Nurpmeso, savannah.gnu.org/bugs/index.php?45034
   loc *  exist *  algo *  size *  imp **    loc *  exist *  algo *  size *  imp **
   
   - style message about violations of the convention
     .An name Aq Mt localpart@domain in AUTHORS (from the mdoclint TODO)
   
 - warn about attempts to call non-callable macros  - warn about attempts to call non-callable macros
   Steffen Nurpmeso  Tue, 11 Nov 2014 22:55:16 +0100    Steffen Nurpmeso  Tue, 11 Nov 2014 22:55:16 +0100
   Note that formatting is inconsistent in groff.    Note that formatting is inconsistent in groff.
Line 493  are mere guesses, and some may be wrong.
Line 497  are mere guesses, and some may be wrong.
   all over mdoc_macro.c and all subtly different.    all over mdoc_macro.c and all subtly different.
   loc **  exist **  algo **  size **  imp **    loc **  exist **  algo **  size **  imp **
   
   - style message about suspicious uses of - vs. \- vs. \(mi
     e.g. -1 is likely wrong (from the mdoclint TODO)
   
   - warn about punctuation - e.g. ',' and ';' - at the beginning
     of a text line, if it is likely intended to follow the preceding
     output without intervening whitespace, in particular after a
     macro line (from the mdoclint TODO)
   
 - mandoc_special does not really check the escape sequence,  - mandoc_special does not really check the escape sequence,
   but just the overall format    but just the overall format
   loc **  exist **  algo ***  size **  imp **    loc **  exist **  algo ***  size **  imp **
   
 - -Tlint parser errors and warnings to stdout  
   to tech@mdocml, naddy@  Wed, 28 Sep 2011 11:21:46 +0200  
   wait!  kristaps@  Sun, 02 Oct 2011 17:12:52 +0200  
   
 ************************************************************************  ************************************************************************
 * documentation issues  * documentation issues
 ************************************************************************  ************************************************************************
   
   - dashes, hyphens, and minus signs in manual pages
     jmc@ Fri, 28 Mar 2014 07:19:27 +0000
   
 - mark macros as: page structure domain, manual domain, general text domain  - mark macros as: page structure domain, manual domain, general text domain
   is this useful?    is this useful?
   
Line 517  are mere guesses, and some may be wrong.
Line 528  are mere guesses, and some may be wrong.
 * performance issues  * performance issues
 ************************************************************************  ************************************************************************
   
 - Why are we using MAP_SHARED, not MAP_PRIVATE for mmap(2)?  
   from kristaps@  Sat, 09 Aug 2014 13:51:36 +0200  
   
 Several areas can be cleaned up to make mandoc even faster.  These are  
   
 - the PDF file is HUGE: this can be reduced by using relative offsets  - the PDF file is HUGE: this can be reduced by using relative offsets
   
 ************************************************************************  ************************************************************************
Line 539  Several areas can be cleaned up to make mandoc even fa
Line 545  Several areas can be cleaned up to make mandoc even fa
   same-line from different-line input.  That plainly doesn't work    same-line from different-line input.  That plainly doesn't work
   with user-defined macros, leading to random breakage.    with user-defined macros, leading to random breakage.
   
   - Is it possible to further simplify ENDBODY_SPACE?
   
 - Find better ways to prevent endless loops  - Find better ways to prevent endless loops
   in roff(7) macro and string expansion.    in roff(7) macro and string expansion.
   
   - make buffers for parsing functions const
     christos@ via wiz@  Fri, 18 Dec 2015 17:10:01 +0100
   
 - struct mparse refactoring  - struct mparse refactoring
   Steffen Nurpmeso  Thu, 04 Sep 2014 12:50:00 +0200    Steffen Nurpmeso  Thu, 04 Sep 2014 12:50:00 +0200
Legend:
Removed from v.1.240  
changed lines
  Added in v.1.246
CVSweb