version 1.53, 2009/11/15 06:45:31 |
version 1.55, 2010/01/07 19:10:09 |
|
|
Terms may be text-decorated using the |
Terms may be text-decorated using the |
.Sq \ef |
.Sq \ef |
escape followed by an indicator: B (bold), I, (italic), R (Roman), or P |
escape followed by an indicator: B (bold), I, (italic), R (Roman), or P |
(revert to previous mode): |
(revert to previous mode): |
.Pp |
.Pp |
.D1 \efBbold\efR \efIitalic\efP |
.D1 \efBbold\efR \efIitalic\efP |
.Pp |
.Pp |
Line 110 A numerical representation 3, 2, or 1 (bold, italic, a |
|
Line 110 A numerical representation 3, 2, or 1 (bold, italic, a |
|
respectively) may be used instead. A text decoration is only valid, if |
respectively) may be used instead. A text decoration is only valid, if |
specified in free-form text, until the next macro invocation; if |
specified in free-form text, until the next macro invocation; if |
specified within a macro, it's only valid until the macro closes scope. |
specified within a macro, it's only valid until the macro closes scope. |
|
Note that macros like |
|
.Sx \&BR |
|
open and close a font scope with each argument. |
.Pp |
.Pp |
Text may also be sized with the |
Text may also be sized with the |
.Sq \es |
.Sq \es |
Line 292 the C library, this may be as follows: |
|
Line 295 the C library, this may be as follows: |
|
.D1 Standard C Library (libc, -lc) |
.D1 Standard C Library (libc, -lc) |
.It Em SYNOPSIS |
.It Em SYNOPSIS |
Documents the utility invocation syntax, function call syntax, or device |
Documents the utility invocation syntax, function call syntax, or device |
configuration. |
configuration. |
.Pp |
.Pp |
For the first, utilities (sections 1, 6, and 8), this is |
For the first, utilities (sections 1, 6, and 8), this is |
generally structured as follows: |
generally structured as follows: |
Line 307 And for the third, configurations (section 4): |
|
Line 310 And for the third, configurations (section 4): |
|
.Pp |
.Pp |
.D1 \&.B name* at cardbus ? function ? |
.D1 \&.B name* at cardbus ? function ? |
.Pp |
.Pp |
Manuals not in these sections generally don't need a |
Manuals not in these sections generally don't need a |
.Em SYNOPSIS . |
.Em SYNOPSIS . |
.It Em DESCRIPTION |
.It Em DESCRIPTION |
This expands upon the brief, one-line description in |
This expands upon the brief, one-line description in |
.Em NAME . |
.Em NAME . |
It usually contains a break-down of the options (if documenting a |
It usually contains a break-down of the options (if documenting a |
command). |
command). |
Line 358 Documents error handling in sections 2, 3, and 9. |
|
Line 361 Documents error handling in sections 2, 3, and 9. |
|
. |
. |
.It Em SEE ALSO |
.It Em SEE ALSO |
References other manuals with related topics. This section should exist |
References other manuals with related topics. This section should exist |
for most manuals. |
for most manuals. |
.Pp |
.Pp |
.D1 \&.BR bar \&( 1 \&), |
.D1 \&.BR bar \&( 1 \&), |
.Pp |
.Pp |
Line 501 sub-section, closed by a section or |
|
Line 504 sub-section, closed by a section or |
|
.Sx \&SS ; |
.Sx \&SS ; |
part, closed by a section, sub-section, or |
part, closed by a section, sub-section, or |
.Sx \&RE ; |
.Sx \&RE ; |
or paragraph, closed by a section, sub-section, part, |
or paragraph, closed by a section, sub-section, part, |
.Sx \&HP , |
.Sx \&HP , |
.Sx \&IP , |
.Sx \&IP , |
.Sx \&LP , |
.Sx \&LP , |
|
|
. |
. |
. |
. |
.Ss \&BI |
.Ss \&BI |
Text is rendered alternately in bold face and italic. Thus, |
Text is rendered alternately in bold face and italic. Thus, |
.Sq .BI this word and that |
.Sq .BI this word and that |
causes |
causes |
.Sq this |
.Sq this |
and |
and |
.Sq and |
.Sq and |
to render in bold face, while |
to render in bold face, while |
.Sq word |
.Sq word |
and |
and |
.Sq that |
.Sq that |
|
|
.Cm width |
.Cm width |
argument must conform to |
argument must conform to |
.Sx Scaling Widths . |
.Sx Scaling Widths . |
If not specified, the saved or default width is used. |
If not specified, the saved or default width is used. |
. |
. |
. |
. |
.Ss \&SB |
.Ss \&SB |
Line 957 Insert vertical spaces into output with the following |
|
Line 960 Insert vertical spaces into output with the following |
|
.Op Cm height |
.Op Cm height |
.Ed |
.Ed |
.Pp |
.Pp |
Insert |
Insert |
.Cm height |
.Cm height |
spaces, which must conform to |
spaces, which must conform to |
.Sx Scaling Widths . |
.Sx Scaling Widths . |