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

Diff for /mandoc/TODO between version 1.83 and 1.89

version 1.83, 2011/01/24 01:34:56 version 1.89, 2011/02/03 10:24:21
Line 7 
Line 7 
 * parser bugs  * parser bugs
 ************************************************************************  ************************************************************************
   
   - It should be noted that in mandoc, the TBL macros are interpreted as
     real roff macros (e.g., `.  TS' is ok), while the troff preprocessor
     only looks for `.TS' (static string).  This should be noted in the
     COMPATIBILITY section.  The same applies for nascent `.EQ' (as it is
     now, `.EN' is processed as a static string).
   
 - .TP before .SH is still FATAL in man(7)  - .TP before .SH is still FATAL in man(7)
   reported by brad@  Sat, 15 Jan 2011 15:54:54 -0500    reported by brad@  Sat, 15 Jan 2011 15:54:54 -0500
   
Line 160 
Line 166 
 * formatting issues: ugly output  * formatting issues: ugly output
 ************************************************************************  ************************************************************************
   
   - a column list with blank `Ta' cells triggers a spurrious
     start-with-whitespace printing of a newline
   
 - double quotes inside double quotes are escaped by doubling them  - double quotes inside double quotes are escaped by doubling them
   implement this in mdoc(7), too    implement this in mdoc(7), too
   so far, we only have it in roff(7) and man(7)    so far, we only have it in roff(7) and man(7)
Line 225 
Line 234 
   should be "NetBSD 1.0A", not "NetBSD 1.0a",    should be "NetBSD 1.0A", not "NetBSD 1.0a",
   see OpenBSD ccdconfig(8).    see OpenBSD ccdconfig(8).
   
 - The space character joining .Dx .Fx .Nx .Ox (are these all?) to its  
   argument is non-breaking.  See the cdio(1) HISTORY and many others.  
   
 - .Bx uses a dash before its argument, not a space,  
   see for example the chpass(1) and column(1) HISTORY.  
   Besides, the second argument is capitalized, for example,  
     .Bx 4.3 tahoe .  
   produces 4.3BSD-Tahoe.  
   
 - In .Bl -tag, if a tag exceeds the right margin and must be continued  - 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;    on the next line, it must be indented by -width, not width+1;
   see "rule block|pass" in OpenBSD ifconfig(8).    see "rule block|pass" in OpenBSD ifconfig(8).
Line 252 
Line 252 
   should be indented, see e.g. rpc(3);    should be indented, see e.g. rpc(3);
   reported by jmc@ on discuss@  Fri, 29 Oct 2010 13:48:33 +0100    reported by jmc@ on discuss@  Fri, 29 Oct 2010 13:48:33 +0100
   
 - .Ns should only be effective when called by another macro,  
   not as a stand-alone macro at the beginning of a line;  
   see for example the awk(1) SYNOPSIS.  
   
 - .Ns should work when called at the end of an input line, see  - .Ns should work when called at the end of an input line, see
   the following code in vi(1):    the following code in vi(1):
     .It Xo      .It Xo
Line 264 
Line 260 
     .Op Cm !\&      .Op Cm !\&
     .Xc      .Xc
     The input text is appended after the specified line.      The input text is appended after the specified line.
   
 - When we have both .%T and .%B in .Rs, .%T uses "", not underline, see  
   for example arp(4); admittedly, arp(4) is abusing both .%T and .%B,  
   but when dealing with anthologies, sensible use of of both in the  
   same .Rs can occur.  
   
 - Header lines of excessive length:  - Header lines of excessive length:
   Port OpenBSD man_term.c rev. 1.25 to mdoc_term.c    Port OpenBSD man_term.c rev. 1.25 to mdoc_term.c

Legend:
Removed from v.1.83  
changed lines
  Added in v.1.89

CVSweb