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

Diff for /mandoc/man.7 between version 1.74 and 1.77

version 1.74, 2010/05/26 14:03:54 version 1.77, 2010/07/19 10:48:36
Line 61  Blank lines are acceptable; where found, the output wi
Line 61  Blank lines are acceptable; where found, the output wi
 vertical space.  vertical space.
 .Ss Comments  .Ss Comments
 Text following a  Text following a
 .Sq \e\*" ,  .Sq \e\*q ,
 whether in a macro or free-form text line, is ignored to the end of  whether in a macro or free-form text line, is ignored to the end of
 line.  line.
 A macro line with only a control character and comment escape,  A macro line with only a control character and comment escape,
 .Sq \&.\e" ,  .Sq \&.\e\*q ,
 is also ignored.  is also ignored.
 Macro lines with only a control character and optionally whitespace are  Macro lines with only a control character and optionally whitespace are
 stripped from input.  stripped from input.
Line 106  Note that macros like
Line 106  Note that macros like
 .Sx \&BR  .Sx \&BR
 open and close a font scope with each argument.  open and close a font scope with each argument.
 .Pp  .Pp
 Text may also be sized with the  The
 .Sq \es  
 escape, whose syntax is one of  
 .Sq \es+-n  
 for one-digit numerals;  
 .Sq \es(+-nn  
 or  
 .Sq \es+-(nn  
 for two-digit numerals; and  
 .Sq \es[+-N] ,  
 .Sq \es+-[N] ,  
 .Sq \es'+-N' ,  
 or  
 .Sq \es+-'N'  
 for arbitrary-digit numerals:  
 .Pp  
 .D1 \es+1bigger\es-1  
 .D1 \es[+10]much bigger\es[-10]  
 .D1 \es+(10much bigger\es-(10  
 .D1 \es+'100'much much bigger\es-'100'  
 .Pp  
 Both  
 .Sq \es  
 and  
 .Sq \ef  .Sq \ef
 attributes are forgotten when entering or exiting a macro block.  attribute is forgotten when entering or exiting a macro block.
 .Ss Whitespace  .Ss Whitespace
 Whitespace consists of the space character.  Whitespace consists of the space character.
 In free-form lines, whitespace is preserved within a line; un-escaped  In free-form lines, whitespace is preserved within a line; un-escaped
Line 238  at least one macro or text node must appear in the doc
Line 215  at least one macro or text node must appear in the doc
 Documents are generally structured as follows:  Documents are generally structured as follows:
 .Bd -literal -offset indent  .Bd -literal -offset indent
 \&.TH FOO 1 2009-10-10  \&.TH FOO 1 2009-10-10
 \&.  
 \&.SH NAME  \&.SH NAME
 \efBfoo\efR \e(en a description goes here  \efBfoo\efR \e(en a description goes here
 \&.\e\*q The next is for sections 2 & 3 only.  \&.\e\*q The next is for sections 2 & 3 only.
 \&.\e\*q .SH LIBRARY  \&.\e\*q .SH LIBRARY
 \&.  
 \&.SH SYNOPSIS  \&.SH SYNOPSIS
 \efBfoo\efR [\efB\e-options\efR] arguments...  \efBfoo\efR [\efB\e-options\efR] arguments...
 \&.  
 \&.SH DESCRIPTION  \&.SH DESCRIPTION
 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 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
Line 936  implementations of the
Line 909  implementations of the
 language.  language.
 .Pp  .Pp
 .Bl -dash -compact  .Bl -dash -compact
   .It
   The \es (font size), \em (font colour), and \eM (font filling colour)
   font decoration escapes are all discarded in mandoc.
 .It  .It
 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.  a standalone double-quote in formatted output.
Legend:
Removed from v.1.74  
changed lines
  Added in v.1.77
CVSweb