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

Diff for /mandoc/man.7 between version 1.62 and 1.67

version 1.62, 2010/04/13 05:26:49 version 1.67, 2010/05/12 08:41:17
Line 126  and
Line 126  and
 .Sq \ef  .Sq \ef
 attributes are forgotten when entering or exiting a macro block.  attributes are forgotten when entering or exiting a macro block.
 .Ss Whitespace  .Ss Whitespace
 Unless specifically escaped, consecutive blocks of whitespace are pruned  Whitespace consists of the space character.
 from input.  These are later re-added, if applicable, by a front-end  In free-form lines, whitespace is preserved within a line; un-escaped
 utility such as  trailing spaces are stripped from input (unless in a literal context).
 .Xr mandoc 1 .  Blank free-form lines, which may include spaces, are permitted and
   rendered as an empty line.
   .Pp
   In macro lines, whitespace delimits arguments and is discarded.  If
   arguments are quoted, whitespace within the quotes is retained.
 .Ss Dates  .Ss Dates
 The  The
 .Sx \&TH  .Sx \&TH
Line 228  are generally structured as follows:
Line 232  are generally structured as follows:
 The \efBfoo\efR utility processes files...  The \efBfoo\efR utility processes files...
 \&.  \&.
 \&.\e\*q .SH IMPLEMENTATION NOTES  \&.\e\*q .SH IMPLEMENTATION NOTES
 \&.\e\*q The next is for sections 1 & 8 only.  
 \&.\e\*q .SH EXIT STATUS  
 \&.\e\*q The next is for sections 2, 3, & 9 only.  \&.\e\*q The next is for sections 2, 3, & 9 only.
 \&.\e\*q .SH RETURN VALUES  \&.\e\*q .SH RETURN VALUES
 \&.\e\*q The next is for sections 1, 6, 7, & 8 only.  \&.\e\*q The next is for sections 1, 6, 7, & 8 only.
 \&.\e\*q .SH ENVIRONMENT  \&.\e\*q .SH ENVIRONMENT
 \&.\e\*q .SH FILES  \&.\e\*q .SH FILES
   \&.\e\*q The next is for sections 1 & 8 only.
   \&.\e\*q .SH EXIT STATUS
 \&.\e\*q .SH EXAMPLES  \&.\e\*q .SH EXAMPLES
 \&.\e\*q The next is for sections 1, 4, 6, 7, & 8 only.  \&.\e\*q The next is for sections 1, 4, 6, 7, & 8 only.
 \&.\e\*q .SH DIAGNOSTICS  \&.\e\*q .SH DIAGNOSTICS
Line 294  command).
Line 298  command).
 Implementation-specific notes should be kept here.  This is useful when  Implementation-specific notes should be kept here.  This is useful when
 implementing standard functions that may have side effects or notable  implementing standard functions that may have side effects or notable
 algorithmic implications.  algorithmic implications.
 .It Em EXIT STATUS  
 Command exit status for section 1, 6, and 8 manuals.  This section is  
 the dual of  
 .Em RETURN VALUES ,  
 which is used for functions.  Historically, this information was  
 described in  
 .Em DIAGNOSTICS ,  
 a practise that is now discouraged.  
 .It Em RETURN VALUES  .It Em RETURN VALUES
 This section is the dual of  This section is the dual of
 .Em EXIT STATUS ,  .Em EXIT STATUS ,
Line 313  Documents any usages of environment variables, e.g.,
Line 309  Documents any usages of environment variables, e.g.,
 .It Em FILES  .It Em FILES
 Documents files used.  It's helpful to document both the file and a  Documents files used.  It's helpful to document both the file and a
 short description of how the file is used (created, modified, etc.).  short description of how the file is used (created, modified, etc.).
   .It Em EXIT STATUS
   Command exit status for section 1, 6, and 8 manuals.  This section is
   the dual of
   .Em RETURN VALUES ,
   which is used for functions.  Historically, this information was
   described in
   .Em DIAGNOSTICS ,
   a practise that is now discouraged.
 .It Em EXAMPLES  .It Em EXAMPLES
 Example usages.  This often contains snippets of well-formed,  Example usages.  This often contains snippets of well-formed,
 well-tested invocations.  Make doubly sure that your examples work  well-tested invocations.  Make doubly sure that your examples work
Line 886  language.
Line 890  language.
 In quoted literals, GNU troff allowed pair-wise double-quotes to produce  In quoted literals, GNU troff allowed pair-wise double-quotes to produce
 a standalone double-quote in formatted output.  It is not known whether  a standalone double-quote in formatted output.  It is not known whether
 this behaviour is exhibited by other formatters.  this behaviour is exhibited by other formatters.
 .It  
 Blocks of whitespace are stripped from macro and free-form text lines  
 (except when in literal mode) in mandoc.  This is not the case for GNU  
 troff: for maximum portability, whitespace sensitive blocks should be  
 enclosed in literal contexts.  
 .It  .It
 The  The
 .Sx \&sp  .Sx \&sp
Legend:
Removed from v.1.62  
changed lines
  Added in v.1.67
CVSweb