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

Diff for /mandoc/man.7 between version 1.37 and 1.38

version 1.37, 2009/09/05 10:37:09 version 1.38, 2009/10/18 19:00:57
Line 119  from input.  These are later re-added, if applicable, 
Line 119  from input.  These are later re-added, if applicable, 
 utility such as  utility such as
 .Xr mandoc 1 .  .Xr mandoc 1 .
 .  .
   .Ss Scaling Widths
   Many macros support scaled widths for their arguments, such as
   stipulating a two-inch paragraph indentation with the following:
   .Bd -literal -offset indent
   \&.HP 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 .
   .
   .Pp
   If a scaling unit is not provided, the numerical value is interpreted
   under the default rules of
   .Sq v
   for vertical spaces and
   .Sq u
   for horizontal ones.
   .Em Note :
   this differs from
   .Xr mdoc 7 ,
   which, if a unit is not provided, will instead interpret the string as
   literal text.
   .
   .
 .Sh MANUAL STRUCTURE  .Sh MANUAL STRUCTURE
 Each  Each
 .Nm  .Nm
Line 317  This section is a canonical reference to all macros, a
Line 384  This section is a canonical reference to all macros, a
 alphabetically.  For the scoping of individual macros, see  alphabetically.  For the scoping of individual macros, see
 .Sx MACRO SYNTAX .  .Sx MACRO SYNTAX .
 .  .
 .  
 .Ss Definitions  
 In this reference, a numerical width may be either a standalone natural  
 number (such as 3, 4, 10, etc.) or a natural number followed by a width  
 multiplier  
 .Qq n ,  
 corresponding to the width of the formatted letter n, or  
 .Qq m ,  
 corresponding to the width of the formatted letter m.  The latter is the  
 default, if unspecified.  Thus,  
 .Bd -literal -offset indent  
 \&.HP 12n  
 .Ed  
 .  
 .Pp  
 indicates an offset of 12  
 .Qq n  
 .Ns -sized  
 letters.  
 .  
 .  
 .Ss Macro Reference  
 .Bl -tag -width Ds  .Bl -tag -width Ds
 .It B  .It B
 Text is rendered in bold face.  Text is rendered in bold face.
Line 367  subsequent output lines are indented, with the followi
Line 412  subsequent output lines are indented, with the followi
 .Ed  .Ed
 .  .
 .Pp  .Pp
 If  If scaling width
 .Va width  .Va width
 is specified, it's saved for later paragraph left-margins; if  is specified, it's saved for later paragraph left-margins; if
 unspecified, the saved or default width is used.  unspecified, the saved or default width is used.
Line 413  Begin a part setting the left margin.  The left margin
Line 458  Begin a part setting the left margin.  The left margin
 offset, following an initial indentation, to un-indented text such as  offset, following an initial indentation, to un-indented text such as
 that of  that of
 .Sq PP .  .Sq PP .
 The width may be specified as following:  A scaling width may be specified as following:
 .Bd -literal -offset indent  .Bd -literal -offset indent
 \&.RS [width]  \&.RS [width]
 .Ed  .Ed
Line 464  followed by a newline; if not, the body follows on the
Line 509  followed by a newline; if not, the body follows on the
 buffer to the indentation width.  Subsequent output lines are indented.  buffer to the indentation width.  Subsequent output lines are indented.
 .  .
 .Pp  .Pp
 The indentation width may be set as follows:  The indentation scaling width may be set as follows:
 .Bd -literal -offset indent  .Bd -literal -offset indent
 \&.TP [width]  \&.TP [width]
 .Ed  .Ed
 .  .
 .Pp  .Pp
 Where  If
 .Va width  
 must be a properly-formed numeric width.  If  
 .Va width  .Va width
 is specified, it's saved for later paragraph left-margins; if  is specified, it's saved for later paragraph left-margins; if
 unspecified, the saved or default width is used.  unspecified, the saved or default width is used.

Legend:
Removed from v.1.37  
changed lines
  Added in v.1.38

CVSweb