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

Diff for /mandoc/mdoc.7 between version 1.44 and 1.45

version 1.44, 2009/07/17 12:08:08 version 1.45, 2009/07/17 12:40:48
Line 414  then the macro accepts an arbitrary number of argument
Line 414  then the macro accepts an arbitrary number of argument
 .It \&Vt     Ta    Yes      Ta    Yes      Ta    >0  .It \&Vt     Ta    Yes      Ta    Yes      Ta    >0
 .It \&Xr     Ta    Yes      Ta    Yes      Ta    >0, <3  .It \&Xr     Ta    Yes      Ta    Yes      Ta    >0, <3
 .It \&br     Ta    \&No     Ta    \&No     Ta    0  .It \&br     Ta    \&No     Ta    \&No     Ta    0
   .It \&sp     Ta    \&No     Ta    \&No     Ta    1
 .El  .El
 .\" SECTION---------------------------------------------  .\" SECTION---------------------------------------------
 .Sh COMPATIBILITY  .Sh COMPATIBILITY
Line 431  file re-write 
Line 432  file re-write 
 .Bl -dash -compact  .Bl -dash -compact
 .\" LIST-ITEM  .\" LIST-ITEM
 .It  .It
   The
   .Sq \&sp
   macro does not accept negative numbers.
   .\" LIST-ITEM
   .It
 Some character sequences in groff are not handled depending on escape  Some character sequences in groff are not handled depending on escape
 style, e.g.,  style, e.g.,
 .Sq \e(ba  .Sq \e(ba
Line 457  made historic groff
Line 463  made historic groff
 but is a proper delimiter in this implementation.  but is a proper delimiter in this implementation.
 .\" LIST-ITEM  .\" LIST-ITEM
 .It  .It
 .Sq \&.It \-nested  .Sq \&It \-nested
 is assumed for all lists (it wasn't in historic groff): any list may be  is assumed for all lists (it wasn't in historic groff): any list may be
 nested and  nested and
 .Sq \-enum  .Sq \-enum
 lists will restart the sequence only for the sub-list.  lists will restart the sequence only for the sub-list.
 .\" LIST-ITEM  .\" LIST-ITEM
 .It  .It
 .Sq \&.It \-column  .Sq \&It \-column
 syntax where column widths may be preceded by other arguments (instead  syntax where column widths may be preceded by other arguments (instead
 of proceeded) is not supported.  of proceeded) is not supported.
 .\" LIST-ITEM  .\" LIST-ITEM
 .It  .It
 The  The
 .Sq \&.At  .Sq \&At
 macro only accepts a single parameter.  macro only accepts a single parameter.
 .\" LIST-ITEM  .\" LIST-ITEM
 .It  .It
 Some manuals use  Some manuals use
 .Sq \&.Li  .Sq \&Li
 incorrectly by following it with a reserved character and expecting the  incorrectly by following it with a reserved character and expecting the
 delimiter to render.  This is not supported.  delimiter to render.  This is not supported.
 .\" LIST-ITEM  .\" LIST-ITEM
Line 487  versions of groff seem to dither on this.
Line 493  versions of groff seem to dither on this.
 .\" LIST-ITEM  .\" LIST-ITEM
 .It  .It
 In groff, the  In groff, the
 .Sq \&.Fo  .Sq \&Fo
 macro only produces the first parameter.  This is no longer the case.  macro only produces the first parameter.  This is no longer the case.
 .El  .El
 .\" SECTION---------------------------------------------  .\" SECTION---------------------------------------------
Line 508  There are many ambiguous parts of mdoc.
Line 514  There are many ambiguous parts of mdoc.
 .Bl -dash -compact  .Bl -dash -compact
 .\" LIST-ITEM  .\" LIST-ITEM
 .It  .It
 .Sq \&.Fa  .Sq \&Fa
 should be  should be
 .Sq \&.Va  .Sq \&Va
 as function arguments are variables.  as function arguments are variables.
 .\" LIST-ITEM  .\" LIST-ITEM
 .It  .It
 .Sq \&.Ft  .Sq \&Ft
 should be  should be
 .Sq \&.Vt  .Sq \&Vt
 as function return types are still types.  Furthermore, the  as function return types are still types.  Furthermore, the
 .Sq \&.Ft  .Sq \&Ft
 should be removed and  should be removed and
 .Sq \&.Fo ,  .Sq \&Fo ,
 which ostensibly follows it, should follow the same convention as  which ostensibly follows it, should follow the same convention as
 .Sq \&.Va .  .Sq \&Va .
 .\" LIST-ITEM  .\" LIST-ITEM
 .It  .It
 .Sq \&.Va  .Sq \&Va
 should formalise that only one or two arguments are acceptable: a  should formalise that only one or two arguments are acceptable: a
 variable name and optional, preceding type.  variable name and optional, preceding type.
 .\" LIST-ITEM  .\" LIST-ITEM
 .It  .It
 .Sq \&.Fd  .Sq \&Fd
 is ambiguous.  It's commonly used to indicate an include file in the  is ambiguous.  It's commonly used to indicate an include file in the
 synopsis section.  synopsis section.
 .Sq \&.In  .Sq \&In
 should be used, instead.  should be used, instead.
 .\" LIST-ITEM  .\" LIST-ITEM
 .It  .It
 Only the  Only the
 .Sq \-literal  .Sq \-literal
 argument to  argument to
 .Sq \&.Bd  .Sq \&Bd
 makes sense.  The remaining ones should be removed.  makes sense.  The remaining ones should be removed.
 .\" LIST-ITEM  .\" LIST-ITEM
 .It  .It
 The  The
 .Sq \&.Xo  .Sq \&Xo
 and  and
 .Sq \&.Xc  .Sq \&Xc
 macros should be deprecated.  macros should be deprecated.
 .\" LIST-ITEM  .\" LIST-ITEM
 .It  .It
 The  The
 .Sq \&.Dt  .Sq \&Dt
 macro lacks clarity.  It should be absolutely clear which title will  macro lacks clarity.  It should be absolutely clear which title will
 render when formatting the manual page.  render when formatting the manual page.
 .\" LIST-ITEM  .\" LIST-ITEM
 .It  .It
 A  A
 .Sq \&.Lx  .Sq \&Lx
 should be provided for Linux (\(`a la  should be provided for Linux (\(`a la
 .Sq \&.Ox ,  .Sq \&Ox ,
 .Sq \&.Nx  .Sq \&Nx
 etc.).  etc.).
 .\" LIST-ITEM  .\" LIST-ITEM
 .It  .It
 There's no way to refer to references in  There's no way to refer to references in
 .Sq \&.Rs/.Re  .Sq \&Rs/Re
 blocks.  blocks.
 .\" LIST-ITEM  .\" LIST-ITEM
 .It  .It
 The \-split and \-nosplit arguments to  The \-split and \-nosplit arguments to
 .Sq \&.An  .Sq \&An
 are inane.  are inane.
 .El  .El
Legend:
Removed from v.1.44  
changed lines
  Added in v.1.45
CVSweb