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

Diff for /mandoc/mdoc.7 between version 1.59 and 1.61

version 1.59, 2009/08/20 13:32:09 version 1.61, 2009/10/18 13:58:48
Line 73  whitespace are stripped from input.
Line 73  whitespace are stripped from input.
 .  .
 .Ss Reserved Characters  .Ss Reserved Characters
 Within a macro line, the following characters are reserved:  Within a macro line, the following characters are reserved:
   .Pp
 .Bl -tag -width Ds -offset indent -compact  .Bl -tag -width Ds -offset indent -compact
 .It \&.  .It \&.
 .Pq period  .Pq period
Line 208  considered literal text.  Thus, the following produces
Line 209  considered literal text.  Thus, the following produces
 .Pp  .Pp
 In free-form mode, quotes are regarded as opaque text.  In free-form mode, quotes are regarded as opaque text.
 .  .
   .Ss Scaling Widths
   Many macros support scaled widths for their arguments, such as
   stipulating a two-inch list indentation with the following:
   .Bd -literal -offset indent
   \&.Bl -tag -width 2i
   .Ed
 .  .
   .Pp
   The syntax for scaled widths is
   .Sq Li [+-]?[0-9]*.[0-9]*[unit] ,
   where a decimal must be preceded or proceeded by at least one digit.
   Negative numbers, while accepted, are truncated to zero.  The following
   scaling units are accepted:
   .Pp
   .Bl -tag -width Ds -offset indent -compact
   .It c
   centimetre
   .It i
   inch
   .It P
   pica (~1/6 inch)
   .It p
   point (~1/72 inch)
   .It f
   synonym for
   .Sq u
   .It v
   default vertical span
   .It m
   width of rendered
   .Sq m
   .Pq em
   character
   .It n
   width of rendered
   .Sq n
   .Pq en
   character
   .It u
   default horizontal span
   .It M
   mini-em (~1/100 em)
   .El
   .Pp
   Using anything other than
   .Sq m ,
   .Sq n ,
   .Sq u ,
   or
   .Sq v
   is necessarily non-portable across output media.  See
   .Sx COMPATIBILITY .
   .
   .
 .Sh MANUAL STRUCTURE  .Sh MANUAL STRUCTURE
 Each  Each
 .Nm  .Nm
Line 297  The
Line 351  The
 column indicates that the macro may be called subsequent to the initial  column indicates that the macro may be called subsequent to the initial
 line-macro.  If a macro is not callable, then its invocation after the  line-macro.  If a macro is not callable, then its invocation after the
 initial line macro is interpreted as opaque text, such that  initial line macro is interpreted as opaque text, such that
 .Sq \&.Fl Sh  .Sq \&.Fl \&Sh
 produces  produces
 .Sq Fl Sh .  .Sq Fl \&Sh .
 .  .
 .Pp  .Pp
 The  The
Line 544  file re-write
Line 598  file re-write
 .  .
 .Pp  .Pp
 .Bl -dash -compact  .Bl -dash -compact
   .It
   Negative scaling units are now truncated to zero instead of creating
   interesting conditions, such as with
   .Sq \&sp -1i .
   Furthermore, the
   .Sq f
   scaling unit, while accepted, is rendered as the default unit.
 .It  .It
 The  The
 .Sq \-split  .Sq \-split
Legend:
Removed from v.1.59  
changed lines
  Added in v.1.61
CVSweb