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

Diff for /mandoc/mandoc.1 between version 1.20 and 1.22

version 1.20, 2009/06/17 19:12:03 version 1.22, 2009/06/22 12:04:05
Line 98  were provided.
Line 98  were provided.
 .Pp  .Pp
 .Ex -std mandoc  .Ex -std mandoc
 .\" SUB-SECTION  .\" SUB-SECTION
 .Ss Punctuation  .Ss Punctuation and Spacing
 If punctuation is set apart from words, such as in the phrase  If punctuation is set apart from words, such as in the phrase
 .Dq to be \&, or not to be ,  .Dq to be \&, or not to be ,
 it's processed by  it's processed by
 .Nm  .Nm
 according to the following rules.  Opening punctuation  according to the following rules:  opening punctuation
 .Po  .Po
 .Sq \&( ,  .Sq \&( ,
 .Sq \&[ ,  .Sq \&[ ,
 and  and
 .Sq \&{  .Sq \&{
 .Pc  .Pc
 is not followed by a space. Closing punctuation  is not followed by a space; closing punctuation
 .Po  .Po
 .Sq \&. ,  .Sq \&. ,
 .Sq \&, ,  .Sq \&, ,
Line 128  is not preceded by whitespace.
Line 128  is not preceded by whitespace.
 If the input is  If the input is
 .Xr mdoc 7 ,  .Xr mdoc 7 ,
 these rules are also applied to macro arguments when appropriate.  these rules are also applied to macro arguments when appropriate.
   .Pp
   White-space, in non-literal (normal) mode, is stripped from input and
   replaced on output by a single space.  Thus, if you wish to preserve
   multiple spaces, they must be space-escaped
   .Sq \e\  .
   or used in a literal display mode, e.g.,
   .Sq \&.Bd \-literal
   in
   .Xr mdoc 7 .
 .\" SUB-SECTION  .\" SUB-SECTION
 .Ss Input Formats  .Ss Input Formats
 The  The
Line 210  flag.
Line 219  flag.
 When rewinding the scope of a block macro, forces the compiler to ignore  When rewinding the scope of a block macro, forces the compiler to ignore
 scope violations.  This can seriously mangle the resulting tree.  scope violations.  This can seriously mangle the resulting tree.
 .Pq mdoc only  .Pq mdoc only
 .It Fl f Ns Ar ign-escape  .It Fl f Ns Ar no-ign-escape
 Ignore invalid escape sequences.  Don't ignore invalid escape sequences.
 .It Fl f Ns Ar ign-macro  
 Ignore unknown macros at the start of input lines (default for  
 .Xr man 7  
 parsing).  
 .It Fl f Ns Ar no-ign-macro  .It Fl f Ns Ar no-ign-macro
 Do not ignore unknown macros at the start of input lines (default for  Do not ignore unknown macros at the start of input lines.
 .Xr mdoc 7  .It Fl f Ns Ar no-ign-chars
 parsing).  Do not ignore disallowed characters.
   .It Fl f Ns Ar strict
   Implies
   .Fl f Ns Ar no-ign-escape ,
   .Fl f Ns Ar no-ign-macro
   and
   .Fl f Ns Ar no-ign-chars .
 .El  .El
 .\" PARAGRAPH  .\" PARAGRAPH
 .Pp  .Pp
Line 228  As with the
Line 239  As with the
 flag, multiple  flag, multiple
 .Fl f  .Fl f
 options may be grouped and delimited with a comma.  Using  options may be grouped and delimited with a comma.  Using
 .Fl f Ns Ar ign-scope,ign-escape ,  .Fl f Ns Ar ign-scope,no-ign-escape ,
 for example, will try to ignore scope and character-escape errors.  for example, will try to ignore scope and not ignore character-escape
   errors.
 .\" SECTION  .\" SECTION
 .Sh EXAMPLES  .Sh EXAMPLES
 To page manuals to the terminal:  To page manuals to the terminal:
 .\" PARAGRAPH  .\" PARAGRAPH
 .Pp  .Pp
 .D1 % mandoc \-Wall,error mandoc.1 2>&1 | less  .D1 % mandoc \-Wall,error \-fstrict mandoc.1 2>&1 | less
 .Pp  
 .D1 % mandoc mandoc.1 mdoc.3 mdoc.7 | less  .D1 % mandoc mandoc.1 mdoc.3 mdoc.7 | less
 .\" SECTION  .\" SECTION
 .Sh COMPATIBILITY  .Sh COMPATIBILITY
Line 251  A list or display following
Line 262  A list or display following
 .Sq \&.Ss  .Sq \&.Ss
 does not assert a prior vertical break, just as it doesn't with  does not assert a prior vertical break, just as it doesn't with
 .Sq \&.Sh .  .Sq \&.Sh .
 .\" LIST-ITEM  
 .It  .It
 The \-literal and \-unfilled  The \-literal and \-unfilled
 .Sq \&.Bd  .Sq \&.Bd
 displays types are synonyms, as are \-filled and \-ragged.  displays types are synonyms, as are \-filled and \-ragged.
 .\" LIST-ITEM  
 .It  .It
 Words aren't hyphenated.  Words aren't hyphenated.
   .It
   In normal mode (not a literal block), blocks of spaces aren't preserved,
   so double spaces following sentence closure
   .Pq Qq French spacing
   are reduced to a single space.
 .El  .El
 .\" SECTION  .\" SECTION
 .Sh SEE ALSO  .Sh SEE ALSO
Legend:
Removed from v.1.20  
changed lines
  Added in v.1.22
CVSweb