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

Diff for /mandoc/mdoc.7 between version 1.240 and 1.249

version 1.240, 2014/10/30 20:10:02 version 1.249, 2015/01/20 19:39:34
Line 433  in the alphabetical
Line 433  in the alphabetical
 .Ss Document preamble and NAME section macros  .Ss Document preamble and NAME section macros
 .Bl -column "Brq, Bro, Brc" description  .Bl -column "Brq, Bro, Brc" description
 .It Sx \&Dd Ta document date: Cm $\&Mdocdate$ | Ar month day , year  .It Sx \&Dd Ta document date: Cm $\&Mdocdate$ | Ar month day , year
 .It Sx \&Dt Ta document title: Ar TITLE section Op Ar volume | arch  .It Sx \&Dt Ta document title: Ar TITLE section Op Ar arch
 .It Sx \&Os Ta operating system version: Op Ar system Op Ar version  .It Sx \&Os Ta operating system version: Op Ar system Op Ar version
 .It Sx \&Nm Ta document name (one argument)  .It Sx \&Nm Ta document name (one argument)
 .It Sx \&Nd Ta document description (one line)  .It Sx \&Nd Ta document description (one line)
Line 454  in the alphabetical
Line 454  in the alphabetical
 .Op Fl compact  .Op Fl compact
 .It Sx \&D1 Ta indented display (one line)  .It Sx \&D1 Ta indented display (one line)
 .It Sx \&Dl Ta indented literal display (one line)  .It Sx \&Dl Ta indented literal display (one line)
   .It Sx \&Ql Ta in-line literal display: Ql text
 .It Sx \&Bl , \&El Ta list block:  .It Sx \&Bl , \&El Ta list block:
 .Fl Ar type  .Fl Ar type
 .Op Fl width Ar val  .Op Fl width Ar val
Line 528  in the alphabetical
Line 529  in the alphabetical
 .It Sx \&Dq , \&Do , \&Dc Ta enclose in typographic double quotes: Dq text  .It Sx \&Dq , \&Do , \&Dc Ta enclose in typographic double quotes: Dq text
 .It Sx \&Qq , \&Qo , \&Qc Ta enclose in typewriter double quotes: Qq text  .It Sx \&Qq , \&Qo , \&Qc Ta enclose in typewriter double quotes: Qq text
 .It Sx \&Sq , \&So , \&Sc Ta enclose in single quotes: Sq text  .It Sx \&Sq , \&So , \&Sc Ta enclose in single quotes: Sq text
 .It Sx \&Ql Ta single-quoted literal text: Ql text  
 .It Sx \&Pq , \&Po , \&Pc Ta enclose in parentheses: Pq text  .It Sx \&Pq , \&Po , \&Pc Ta enclose in parentheses: Pq text
 .It Sx \&Bq , \&Bo , \&Bc Ta enclose in square brackets: Bq text  .It Sx \&Bq , \&Bo , \&Bc Ta enclose in square brackets: Bq text
 .It Sx \&Brq , \&Bro , \&Brc Ta enclose in curly braces: Brq text  .It Sx \&Brq , \&Bro , \&Brc Ta enclose in curly braces: Brq text
Line 777  The
Line 777  The
 must be one of the following:  must be one of the following:
 .Bl -tag -width 13n -offset indent  .Bl -tag -width 13n -offset indent
 .It Fl centered  .It Fl centered
 Produce one output line from each input line, and centre-justify each line.  Produce one output line from each input line, and center-justify each line.
 Using this display type is not recommended; many  Using this display type is not recommended; many
 .Nm  .Nm
 implementations render it poorly.  implementations render it poorly.
Line 822  which has no effect;
Line 822  which has no effect;
 .Cm right ,  .Cm right ,
 which justifies to the right margin; or  which justifies to the right margin; or
 .Cm center ,  .Cm center ,
 which aligns around an imagined centre axis.  which aligns around an imagined center axis.
 .It  .It
 A macro invocation, which selects a predefined width  A macro invocation, which selects a predefined width
 associated with that macro.  associated with that macro.
Line 1185  See also
Line 1185  See also
 and  and
 .Sx \&Dl .  .Sx \&Dl .
 .Ss \&Db  .Ss \&Db
 Switch debugging mode.  This macro is obsolete.
 Its syntax is as follows:  No replacement is needed.
 .Pp  It is ignored by
 .D1 Pf \. Sx \&Db Cm on | off  .Xr mandoc 1
 .Pp  and groff including its arguments.
 This macro is ignored by  It was formerly used to toggle a debugging mode.
 .Xr mandoc 1 .  
 .Ss \&Dc  .Ss \&Dc
 Close a  Close a
 .Sx \&Do  .Sx \&Do
Line 1257  Examples:
Line 1256  Examples:
 .Dl \&.Dl % mandoc mdoc.7 \e(ba less  .Dl \&.Dl % mandoc mdoc.7 \e(ba less
 .Pp  .Pp
 See also  See also
   .Sx \&Ql ,
 .Sx \&Bd  .Sx \&Bd
   .Fl literal ,
 and  and
 .Sx \&D1 .  .Sx \&D1 .
 .Ss \&Do  .Ss \&Do
Line 1300  Its syntax is as follows:
Line 1301  Its syntax is as follows:
 .Pf \. Sx \&Dt  .Pf \. Sx \&Dt
 .Ar TITLE  .Ar TITLE
 .Ar section  .Ar section
 .Op Ar volume | arch  .Op Ar arch
 .Ed  .Ed
 .Pp  .Pp
 Its arguments are as follows:  Its arguments are as follows:
Line 1315  it should by convention be all caps.
Line 1316  it should by convention be all caps.
 The manual section.  The manual section.
 This may be one of  This may be one of
 .Cm 1  .Cm 1
 .Pq utilities ,  .Pq General Commands ,
 .Cm 2  .Cm 2
 .Pq system calls ,  .Pq System Calls ,
 .Cm 3  .Cm 3
 .Pq libraries ,  .Pq Library Functions ,
 .Cm 3p  .Cm 3p
 .Pq Perl libraries ,  .Pq Perl Library ,
 .Cm 4  .Cm 4
 .Pq devices ,  .Pq Device Drivers ,
 .Cm 5  .Cm 5
 .Pq file formats ,  .Pq File Formats ,
 .Cm 6  .Cm 6
 .Pq games ,  .Pq Games ,
 .Cm 7  .Cm 7
 .Pq miscellaneous ,  .Pq Miscellaneous Information ,
 .Cm 8  .Cm 8
 .Pq system utilities ,  .Pq System Manager's Manual ,
 .Cm 9  
 .Pq kernel functions ,  
 .Cm X11  
 .Pq X Window System ,  
 .Cm X11R6  
 .Pq X Window System ,  
 .Cm unass  
 .Pq unassociated ,  
 .Cm local  
 .Pq local system ,  
 .Cm draft  
 .Pq draft manual ,  
 or  or
 .Cm paper  .Cm 9
 .Pq paper .  .Pq Kernel Developer's Manual .
 It should correspond to the manual's filename suffix and defaults to  It should correspond to the manual's filename suffix and defaults to
 the empty string if unspecified.  the empty string if unspecified.
 .It Ar volume  
 This overrides the volume inferred from  
 .Ar section .  
 This field is optional, and if specified, must be one of  
 .Cm USD  
 .Pq users' supplementary documents ,  
 .Cm PS1  
 .Pq programmers' supplementary documents ,  
 .Cm AMD  
 .Pq administrators' supplementary documents ,  
 .Cm SMM  
 .Pq system managers' manuals ,  
 .Cm URM  
 .Pq users' reference manuals ,  
 .Cm PRM  
 .Pq programmers' reference manuals ,  
 .Cm KM  
 .Pq kernel manuals ,  
 .Cm IND  
 .Pq master index ,  
 .Cm MMI  
 .Pq master index ,  
 .Cm LOCAL  
 .Pq local manuals ,  
 .Cm LOC  
 .Pq local manuals ,  
 or  
 .Cm CON  
 .Pq contributed manuals .  
 .It Ar arch  .It Ar arch
 This specifies the machine architecture a manual page applies to,  This specifies the machine architecture a manual page applies to,
 where relevant, for example  where relevant, for example
Line 1386  where relevant, for example
Line 1346  where relevant, for example
 .Cm i386 ,  .Cm i386 ,
 or  or
 .Cm sparc64 .  .Cm sparc64 .
 The list of supported architectures varies by operating system.  The list of valid architectures varies by operating system.
 For the full list of all architectures recognized by  
 .Xr mandoc 1 ,  
 see the file  
 .Pa arch.in  
 in the source distribution.  
 .El  .El
 .Pp  .Pp
 Examples:  Examples:
 .Dl \&.Dt FOO 1  .Dl \&.Dt FOO 1
 .Dl \&.Dt FOO 4 KM  
 .Dl \&.Dt FOO 9 i386  .Dl \&.Dt FOO 9 i386
 .Pp  .Pp
 See also  See also
Line 2136  Its syntax is as follows:
Line 2090  Its syntax is as follows:
 The optional  The optional
 .Ar system  .Ar system
 parameter specifies the relevant operating system or environment.  parameter specifies the relevant operating system or environment.
 Left unspecified, it defaults to the local operating system version.  It is suggested to leave it unspecified, in which case
 This is the suggested form.  .Xr mandoc 1
   uses its
   .Fl Ios
   argument, or, if that isn't specified either,
   .Fa sysname
   and
   .Fa release
   as returned by
   .Xr uname 3 .
 .Pp  .Pp
 Examples:  Examples:
 .Dl \&.Os  .Dl \&.Os
Line 2241  See also
Line 2203  See also
 Close quoted context opened by  Close quoted context opened by
 .Sx \&Qo .  .Sx \&Qo .
 .Ss \&Ql  .Ss \&Ql
 Format a single-quoted literal.  In-line literal display.
   This can for example be used for complete command invocations and
   for multi-word code fragments when more specific markup is not
   appropriate and an indented display is not desired.
   While
   .Xr mandoc 1
   always encloses the arguments in single quotes, other formatters
   usually omit the quotes on non-terminal output devices when the
   arguments have three or more characters.
   .Pp
 See also  See also
 .Sx \&Qq  .Sx \&Dl
 and  and
 .Sx \&Sq .  .Sx \&Bd
   .Fl literal .
 .Ss \&Qo  .Ss \&Qo
 Multi-line version of  Multi-line version of
 .Sx \&Qq .  .Sx \&Qq .
Line 2432  The original C standard.
Line 2404  The original C standard.
 .Pp  .Pp
 .It \-isoC-99  .It \-isoC-99
 .St -isoC-99  .St -isoC-99
 .It \-ansiC-99  
 .St -ansiC-99  
 .br  .br
 The second major version of the C language standard.  The second major version of the C language standard.
 .Pp  .Pp
Line 2533  The following three refer to parts of it.
Line 2503  The following three refer to parts of it.
 .br  .br
 Networking APIs, including sockets.  Networking APIs, including sockets.
 .Pp  .Pp
 .It \-xpg4.3  
 .St -xpg4.3  
 .Pp  
 .It \-svid4  .It \-svid4
 .St -svid4 ,  .St -svid4 ,
 .br  .br
Line 2562  The following refer to parts of it.
Line 2529  The following refer to parts of it.
 .Pp  .Pp
 .It \-xns5  .It \-xns5
 .St -xns5  .St -xns5
 .It \-xns5.2d2.0  
 .St -xns5.2d2.0  
 .It \-xns5.2  .It \-xns5.2
 .St -xns5.2  .St -xns5.2
 .Pp  
 .It \-p1387.2  
 .St -p1387.2  
 .It \-p1387.2-95  
 .St -p1387.2-95  
 .br  
 POSIX software administration.  
 .El  .El
 .It Single UNIX Specification version 3 and related standards  .It Single UNIX Specification version 3
 .Pp  .Pp
 .Bl -tag -width "-p1003.1g-2000X" -compact  .Bl -tag -width "-p1003.1-2001" -compact
 .It \-p1003.1d-99  
 .St -p1003.1d-99  
 .br  
 Additional real-time extensions.  
 .Pp  
 .It \-p1003.1j-2000  
 .St -p1003.1j-2000  
 .br  
 Advanced real-time extensions.  
 .Pp  
 .It \-p1003.1q-2000  
 .St -p1003.1q-2000  
 .br  
 Amendment 7: Tracing [C Language].  
 .Pp  
 .It \-p1003.1-2001  .It \-p1003.1-2001
 .St -p1003.1-2001  .St -p1003.1-2001
 .It \-susv3  .It \-susv3
Line 3338  The following features are unimplemented in mandoc:
Line 3281  The following features are unimplemented in mandoc:
 .Fl offset Cm center  .Fl offset Cm center
 and  and
 .Fl offset Cm right .  .Fl offset Cm right .
 Groff does not implement centred and flush-right rendering either,  Groff does not implement centered and flush-right rendering either,
 but produces large indentations.  but produces large indentations.
 .El  .El
 .Sh SEE ALSO  .Sh SEE ALSO
Legend:
Removed from v.1.240  
changed lines
  Added in v.1.249
CVSweb