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

Diff for /mandoc/mdoc.7 between version 1.12 and 1.13

version 1.12, 2009/03/21 13:47:02 version 1.13, 2009/03/22 08:52:27
Line 30  The
Line 30  The
 language is used to format  language is used to format
 .Bx  .Bx
 .Ux  .Ux
 manuals.  An  manuals.  In this reference document, we describe the syntax, ontology
   and structure of the
 .Nm  .Nm
   language.
   .\" PARAGRAPH
   .Pp
   An
   .Nm
 document follows simple rules:  lines beginning with the control  document follows simple rules:  lines beginning with the control
 character  character
 .Sq \.  .Sq \.
 are parsed for macros.  Other lines are interpreted within the scope of  are parsed for macros.  Other lines are interpreted within the scope of
 prior macros.  This document describes the encoding, ontology and syntax  prior macros:
 of these macros.  .Bd -literal -offset XXX
   \&.Sh Macro lines change control state.
   Other lines are interpreted within the current state.
   .Ed
   .\" PARAGRAPH
   .Pp
   Macros are two- or three-character sequences whose scope rules, rules
   that dictate handling of subsequent-line or same-line arguments, are
   governed by one of five classifications described in this document.
 .\" SECTION  .\" SECTION
 .Sh CHARACTER ENCODING  .Sh INPUT ENCODING
 .Nm  .Nm
 documents may contain only printable characters, the space character  documents may contain only graphable 7-bit ASCII characters, the space
   character
 .Sq \  ,  .Sq \  ,
 and, in certain circumstances, the tab character  and, in certain circumstances, the tab character
 .Sq \et .  .Sq \et .
Line 529  Special symbols:
Line 544  Special symbols:
 .El  .El
 .\" SECTION  .\" SECTION
 .Sh ONTOLOGY  .Sh ONTOLOGY
 Macros are classified in an ontology described by scope rules.  Macros are classified in an ontology described by their scope rules.
   Some macros are allowed to deviate from their classifications to
   preserve backward-compatibility with old macro combinations still found
   in the manual corpus.  These are specifically noted on a per-macro
   basis.
 .\" SUB-SECTION  .\" SUB-SECTION
 .Ss Scope  .Ss Scope
 .Bl -inset  .Bl -inset
Line 729  close at the invocation's end-of-line.
Line 748  close at the invocation's end-of-line.
 .It \&.Dl    Ta    \&No  Ta    Yes  .It \&.Dl    Ta    \&No  Ta    Yes
 .It \&.Ql    Ta    Yes   Ta    Yes  .It \&.Ql    Ta    Yes   Ta    Yes
 .El  .El
   .\" PARAGRAPH
   .Pp
   The
   .Sq \&Op
   may be broken by \&Oc as in the following example:
   .Bd -literal -offset XXXX
   \&.Oo
   \&.Op Fl a Oc
   .Ed
   .Pp
   In the above example, the scope of
   .Sq \&Op
   is technically broken by
   .Sq \&Oc ,
   however, due to the overwhelming existence of this sequence, it's
   allowed.
 .\" SUB-SECTION  .\" SUB-SECTION
 .Ss Block partial-explicit  .Ss Block partial-explicit
 Each of these contains at least a body and, in limited circumstances, a  Each of these contains at least a body and, in limited circumstances, a
Legend:
Removed from v.1.12  
changed lines
  Added in v.1.13
CVSweb