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

Diff for /mandoc/TODO between version 1.65 and 1.70

version 1.65, 2010/11/29 13:04:31 version 1.70, 2010/12/26 14:38:10
Line 22 
Line 22 
 * missing features  * missing features
 ************************************************************************  ************************************************************************
   
   - pod2man expects `tr' to be implemented for \*(-- to work
   
 - explicit blocks with missing end macro should be implicitely closed  - explicit blocks with missing end macro should be implicitely closed
   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
Line 52 
Line 54 
   and when using the macro, it must expand yet again.    and when using the macro, it must expand yet again.
   
 - implement basic non-parametric .de to support e.g. sox(1)  - implement basic non-parametric .de to support e.g. sox(1)
   .de SP  
   .if t .sp .5  
   .if n .sp  
   ..  
   .de EX  
   .SP  
   .nf  
   .ft CW  
   ..  
   .de EE  
   .ft R  
   .SP  
   .fi  
   ..  
   reported by naddy@ Sat, 16 Oct 2010 23:51:57 +0200    reported by naddy@ Sat, 16 Oct 2010 23:51:57 +0200
     *** sox(1) still doesn't work, tbl(1) errors need investigation
   
 - implement parametric .de to support e.g.  
   /usr/xenocara/lib/libXxf86vm/manXF86VM.man  
   .de ZN  
   .ie t \fB\^\\$1\^\fR\\$2  
   .el \fI\^\\$1\^\fP\\$2  
   ..  
   .ZN -lXxf86vm  
   
 - clean up escape sequence handling, creating three classes:  - clean up escape sequence handling, creating three classes:
   (1) fully implemented, or parsed and ignored without loss of content    (1) fully implemented, or parsed and ignored without loss of content
   (2) unimplemented, potentially causing loss of content    (2) unimplemented, potentially causing loss of content
Line 114 
Line 95 
   (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)
   
 - allow `Qq', `Dq', `Sq', `Aq', `Bq' to have 0 arguments  
   noted by Alex Kozlov 08/06/10 23:05  
   
 - Have `Sh', `It', `Ss' and others complain if `Pp' is invoked prior to  
   close (in the post validation) or prior to open (pre).  This noted by  
   jmc@ a thousand years ago.  
   
 - xloadimage(1) wants .ti (temporary indent), rep by naddy@  - xloadimage(1) wants .ti (temporary indent), rep by naddy@
   
 - bashbug(1) complains "line scope broken" after  - bashbug(1) complains "line scope broken" after
Line 133 
Line 107 
 * formatting issues: ugly output  * formatting issues: ugly output
 ************************************************************************  ************************************************************************
   
   - double quotes inside double quotes are escaped by doubling them
     implement this in man(7) and mdoc(7)
     reminded by millert@  Thu, 09 Dec 2010 17:29:52 -0500
   
 - perl(1) SYNOPSIS looks bad; reported by deraadt@  - perl(1) SYNOPSIS looks bad; reported by deraadt@
   1) man(7) seems to need SYNOPSIS .Nm blocks, too    1) man(7) seems to need SYNOPSIS .Nm blocks, too
   
Line 156 
Line 134 
   or not (run a manual without `Nm blah' to see this).  I'm not sure    or not (run a manual without `Nm blah' to see this).  I'm not sure
   that this exists in the wild, but it's still an error.    that this exists in the wild, but it's still an error.
   
 - .%T should be quoted, not underlined, when .%J is also present,  
   to better distinguish the contents of .%T and .%J,  
   see for example OpenBSD cat(1)  
   
 - In .Bl -bullet, the groff bullet is "+\b+\bo\bo", the mandoc bullet  - In .Bl -bullet, the groff bullet is "+\b+\bo\bo", the mandoc bullet
   is just "o\bo".    is just "o\bo".
   see for example OpenBSD ksh(1)    see for example OpenBSD ksh(1)
Line 172 
Line 146 
 - A bogus .Pp between two .It must not produce a double blank line,  - A bogus .Pp between two .It must not produce a double blank line,
   see between -R and -r in OpenBSD rm(1), before "update" in mount(8),    see between -R and -r in OpenBSD rm(1), before "update" in mount(8),
   or in DIAGNOSTICS in init(8).    or in DIAGNOSTICS in init(8).
     Also have `It' complain if `Pp' is invoked at certain times (not
     -compact?).
   
 - .Bd -literal and .Bd -unfilled are *not* identical.  - .Bd -literal and .Bd -unfilled are *not* identical.
   In -literal, tabs are 8 spaces.    In -literal, tabs are 8 spaces.
Line 217  Several areas can be cleaned up to make mandoc even fa
Line 193  Several areas can be cleaned up to make mandoc even fa
 ************************************************************************  ************************************************************************
 * structural issues  * structural issues
 ************************************************************************  ************************************************************************
   
   - Find better ways to prevent endless loops
     in roff(7) macro and string expansion.
   
Legend:
Removed from v.1.65  
changed lines
  Added in v.1.70
CVSweb