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

Diff for /mandoc/mdoc.7 between version 1.185 and 1.189

version 1.185, 2011/04/06 11:39:25 version 1.189, 2011/07/11 08:45:02
Line 97  Within a macro line, the following terms are reserved:
Line 97  Within a macro line, the following terms are reserved:
 .Pq reserved-word vertical bar  .Pq reserved-word vertical bar
 .El  .El
 .Pp  .Pp
 Use of reserved terms is described in  
 .Sx MACRO SYNTAX .  
 For general use in macro lines, these can be escaped with a non-breaking  For general use in macro lines, these can be escaped with a non-breaking
 space  space
 .Pq Sq \e& .  .Pq Sq \e& .
Line 298  sections, although this varies between manual sections
Line 296  sections, although this varies between manual sections
 .Pp  .Pp
 The following is a well-formed skeleton  The following is a well-formed skeleton
 .Nm  .Nm
 file:  file for a utility
   .Qq progname :
 .Bd -literal -offset indent  .Bd -literal -offset indent
 \&.Dd $\&Mdocdate$  \&.Dd $\&Mdocdate$
 \&.Dt mdoc 7  \&.Dt PROGNAME section
 \&.Os  \&.Os
 \&.Sh NAME  \&.Sh NAME
 \&.Nm foo  \&.Nm progname
 \&.Nd a description goes here  \&.Nd a description goes here
 \&.\e\*q .Sh LIBRARY  \&.\e\*q .Sh LIBRARY
 \&.\e\*q For sections 2, 3, & 9 only.  \&.\e\*q For sections 2, 3, & 9 only.
 \&.\e\*q Not used in OpenBSD.  \&.\e\*q Not used in OpenBSD.
 \&.Sh SYNOPSIS  \&.Sh SYNOPSIS
 \&.Nm foo  \&.Nm progname
 \&.Op Fl options  \&.Op Fl options
 \&.Ar  \&.Ar
 \&.Sh DESCRIPTION  \&.Sh DESCRIPTION
Line 1176  See also
Line 1175  See also
 and  and
 .Sx \&Sy .  .Sx \&Sy .
 .Ss \&Bk  .Ss \&Bk
 Keep the output generated from each macro input line together  For each macro, keep its output together on the same output line,
 on one single output line.  until the end of the macro or the end of the input line is reached,
   whichever comes first.
 Line breaks in text lines are unaffected.  Line breaks in text lines are unaffected.
 The syntax is as follows:  The syntax is as follows:
 .Pp  .Pp
Line 1691  See also
Line 1691  See also
 and  and
 .Sx \&Os .  .Sx \&Os .
 .Ss \&Dv  .Ss \&Dv
 Defined variables such as preprocessor constants.  Defined variables such as preprocessor constants, constant symbols,
   enumeration values, and so on.
 .Pp  .Pp
 Examples:  Examples:
   .Dl \&.Dv NULL
 .Dl \&.Dv BUFSIZ  .Dl \&.Dv BUFSIZ
 .Dl \&.Dv STDOUT_FILENO  .Dl \&.Dv STDOUT_FILENO
 .Pp  .Pp
 See also  See also
 .Sx \&Er .  .Sx \&Er
   and
   .Sx \&Ev
   for special-purpose constants and
   .Sx \&Va
   for variable symbols.
 .Ss \&Dx  .Ss \&Dx
 Format the DragonFly BSD version provided as an argument, or a default  Format the DragonFly BSD version provided as an argument, or a default
 value if no argument is provided.  value if no argument is provided.
Line 1774  argument is used as the enclosure head, for example, s
Line 1781  argument is used as the enclosure head, for example, s
 will emulate  will emulate
 .Sx \&Do .  .Sx \&Do .
 .Ss \&Er  .Ss \&Er
 Display error constants.  Error constants for definitions of the
   .Va errno
   libc global variable.
 .Pp  .Pp
 Examples:  Examples:
 .Dl \&.Er EPERM  .Dl \&.Er EPERM
 .Dl \&.Er ENOENT  .Dl \&.Er ENOENT
 .Pp  .Pp
 See also  See also
 .Sx \&Dv .  .Sx \&Dv
   for general constants.
 .Ss \&Es  .Ss \&Es
 This macro is obsolete and not implemented.  This macro is obsolete and not implemented.
 .Ss \&Ev  .Ss \&Ev
Line 1791  Environmental variables such as those specified in
Line 1801  Environmental variables such as those specified in
 Examples:  Examples:
 .Dl \&.Ev DISPLAY  .Dl \&.Ev DISPLAY
 .Dl \&.Ev PATH  .Dl \&.Ev PATH
   .Pp
   See also
   .Sx \&Dv
   for general constants.
 .Ss \&Ex  .Ss \&Ex
 Insert a standard sentence regarding exit values.  Insert a standard sentence regarding exit values.
 Its syntax is as follows:  Its syntax is as follows:

Legend:
Removed from v.1.185  
changed lines
  Added in v.1.189

CVSweb