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

Diff for /mandoc/Attic/mdoc.3 between version 1.12 and 1.16

version 1.12, 2009/02/27 08:20:15 version 1.16, 2009/03/12 23:05:21
Line 200  an asterisk and non-open-parenthesis 
Line 200  an asterisk and non-open-parenthesis 
 .Sq \&*  .Sq \&*
 for single-character sequences; or one of a small set of standalone  for single-character sequences; or one of a small set of standalone
 single characters for other escapes.  single characters for other escapes.
   .\" PARAGRAPH
 .Pp  .Pp
 Examples:  Examples:
 .Pp  .Pp
Line 230  prints
Line 231  prints
 .Dq \*q  .Dq \*q
 .Pq double-quote  .Pq double-quote
 .El  .El
   .\" PARAGRAPH
   .Pp
   All escaped sequences are syntax-checked, but it's up to the front-end
   system to correctly render them to the output device.
 .\" SUBSECTION  .\" SUBSECTION
 .Ss Abstract Syntax Tree  .Ss Abstract Syntax Tree
 The  The
Line 355  parsed(mdoc, node);
Line 360  parsed(mdoc, node);
 mdoc_free(mdoc);  mdoc_free(mdoc);
 .Ed  .Ed
 .\" SECTION  .\" SECTION
   .Sh COMPATIBILITY
   In general, only those macros specified by
   .Xr mdoc.samples 7
   and
   .Xr mdoc 7
   for
   .Ox
   and
   .Nx
   are supported; support for other
   .Bx
   systems is in progress.
   .Bl -bullet
   .\" LIST-ITEM
   .It
   .Sq \&Cd
   isn't labelled as callable but is.
   .\" LIST-ITEM
   .It
   NetBSD
   .Sq \&It \-nested
   is assumed for all lists: any list may be nested and
   .Sq \-enum
   lists will restart the sequence only for the sub-list.
   .\" LIST-ITEM
   .It
   Newer NetBSD-style
   .Sq \&It \-column
   syntax, where column widths may be preceeded by other arguments (instead
   of proceeded), is not supported.
   .\" LIST-ITEM
   .It
   The
   .Sq \&At
   macro only accepts a single parameter.
   .\" LIST-ITEM
   .It
   Some manuals use
   .Sq \&Li
   incorrectly by following it with a delimeter (see
   .Xr mdoc.samples 7 )
   and expecting the delimiter to render.  This is not supported.
   .\" LIST-ITEM
   .It
   The system-name macros (
   .Ns Sq \&At ,
   .Sq \&Bsx ,
   .Sq \&Bx ,
   .Sq \&Fx ,
   .Sq \&Nx ,
   .Sq \&Ox ,
   and
   .Sq \&Ux )
   are callable.
   .El
   .\" SECTION
 .Sh SEE ALSO  .Sh SEE ALSO
 .Xr mdoc 7 ,  .Xr mdoc 7 ,
 .Xr mdoc.samples 7 ,  .Xr mdoc.samples 7 ,
Line 367  The
Line 428  The
 utility was written by  utility was written by
 .An Kristaps Dzonsons Aq kristaps@kth.se .  .An Kristaps Dzonsons Aq kristaps@kth.se .
 .\" SECTION  .\" SECTION
 .Sh BUGS  .Sh CAVEATS
 Bugs, un-implemented macros and incompabilities are documented in this  .Bl -bullet
 section.  The baseline for determining whether macro parsing is  .\" LIST-ITEM
 .Qq incompatible  .It
 is the default  The
 .Xr groff 1  
 system bundled with  
 .Ox .  
 .\" PARAGRAPH  
 .Pp  
 Un-implemented: the  
 .Sq \&Xc  .Sq \&Xc
 and  and
 .Sq \&Xo  .Sq \&Xo
Line 385  macros aren't handled when used to span lines for the
Line 440  macros aren't handled when used to span lines for the
 .Sq \&It  .Sq \&It
 macro.  Such usage is specifically discouraged in  macro.  Such usage is specifically discouraged in
 .Xr mdoc.samples 7 .  .Xr mdoc.samples 7 .
 .\" PARAGRAPH  .\" LIST-ITEM
 .Pp  .It
 Bugs: when  The
 .Sq \&It \-column  .Sq \&Bsx
 is invoked, whitespace is not stripped around  macro doesn't understand yet the arguments as dictated for
 .Sq \&Ta  .Nx .
 or tab-character separators.  .El
 .\" PARAGRAPH  
 .Pp  
 Bugs: elements within columns for  
 .Sq \&It \-column  
 are not yet supported.  
 .\" PARAGRAPH  
 .Pp  
 Incompatible: the  
 .Sq \&At  
 macro only accepts a single parameter.  Furthermore, several macros  
 .Pf ( Sq \&Pp ,  
 .Sq \&It ,  
 and possibly others) accept multiple arguments with a warning.  
 .\" PARAGRAPH  
 .Pp  
 Incompatible: only those macros specified by  
 .Xr mdoc.samples 7  
 and  
 .Xr mdoc 7  
 for  
 .Ox  
 are supported; support for  
 .Nx  
 and other  
 .Bx  
 systems is in progress.  
Legend:
Removed from v.1.12  
changed lines
  Added in v.1.16
CVSweb