version 1.274, 2018/12/23 22:03:32 |
version 1.279, 2019/07/15 19:20:30 |
Line 516 in the alphabetical |
|
Line 516 in the alphabetical |
|
.Bl -column "Brq, Bro, Brc" description |
.Bl -column "Brq, Bro, Brc" description |
.It Ic \&Em Ta italic font or underline (emphasis) (>0 arguments) |
.It Ic \&Em Ta italic font or underline (emphasis) (>0 arguments) |
.It Ic \&Sy Ta boldface font (symbolic) (>0 arguments) |
.It Ic \&Sy Ta boldface font (symbolic) (>0 arguments) |
.It Ic \&No Ta return to roman font (normal) (no arguments) |
.It Ic \&No Ta return to roman font (normal) (>0 arguments) |
.It Ic \&Bf , \&Ef Ta font block: Fl Ar type | Cm \&Em | \&Li | \&Sy |
.It Ic \&Bf , \&Ef Ta font block: Fl Ar type | Cm \&Em | \&Li | \&Sy |
.El |
.El |
.Ss Physical enclosures |
.Ss Physical enclosures |
|
|
Book or journal page number of an |
Book or journal page number of an |
.Ic \&Rs |
.Ic \&Rs |
block. |
block. |
|
Conventionally, the argument starts with |
|
.Ql p.\& |
|
for a single page or |
|
.Ql pp.\& |
|
for a range of pages, for example: |
|
.Pp |
|
.Dl .%P pp. 42\e(en47 |
.It Ic \&%Q Ar name |
.It Ic \&%Q Ar name |
Institutional author (school, government, etc.) of an |
Institutional author (school, government, etc.) of an |
.Ic \&Rs |
.Ic \&Rs |
|
|
This practise is discouraged. |
This practise is discouraged. |
.It Ic \&Cm Ar keyword ... |
.It Ic \&Cm Ar keyword ... |
Command modifiers. |
Command modifiers. |
Typically used for fixed strings passed as arguments, unless |
Typically used for fixed strings passed as arguments to interactive |
|
commands, to commands in interpreted scripts, or to configuration |
|
file directives, unless |
.Ic \&Fl |
.Ic \&Fl |
is more appropriate. |
is more appropriate. |
Also useful when specifying configuration options or keys. |
|
.Pp |
.Pp |
Examples: |
Examples: |
.Dl ".Nm mt Fl f Ar device Cm rewind" |
.Dl ".Nm mt Fl f Ar device Cm rewind" |
.Dl ".Nm ps Fl o Cm pid , Ns Cm command" |
.Dl ".Nm ps Fl o Cm pid , Ns Cm command" |
.Dl ".Nm dd Cm if= Ns Ar file1 Cm of= Ns Ar file2" |
.Dl ".Nm dd Cm if= Ns Ar file1 Cm of= Ns Ar file2" |
.Dl ".Cm IdentityFile Pa ~/.ssh/id_rsa" |
.Dl ".Ic set Fl o Cm vi" |
.Dl ".Cm LogLevel Dv DEBUG" |
.Dl ".Ic lookup Cm file bind" |
|
.Dl ".Ic permit Ar identity Op Cm as Ar target" |
.It Ic \&D1 Ar line |
.It Ic \&D1 Ar line |
One-line indented display. |
One-line indented display. |
This is formatted by the default rules and is useful for simple indented |
This is formatted by the default rules and is useful for simple indented |
|
|
.Dl \&.Fn \(dqint funcname\(dq \(dqint arg0\(dq \(dqint arg1\(dq |
.Dl \&.Fn \(dqint funcname\(dq \(dqint arg0\(dq \(dqint arg1\(dq |
.Dl \&.Fn funcname \(dqint arg0\(dq |
.Dl \&.Fn funcname \(dqint arg0\(dq |
.Dl \&.Fn funcname arg0 |
.Dl \&.Fn funcname arg0 |
.Pp |
.Bd -literal -offset indent |
.Bd -literal -offset indent -compact |
|
\&.Ft functype |
\&.Ft functype |
\&.Fn funcname |
\&.Fn funcname |
.Ed |
.Ed |
Line 1678 This macro is not implemented in |
|
Line 1686 This macro is not implemented in |
|
.Xr mandoc 1 . |
.Xr mandoc 1 . |
It was used to include the contents of a (header) file literally. |
It was used to include the contents of a (header) file literally. |
.It Ic \&Ic Ar keyword ... |
.It Ic \&Ic Ar keyword ... |
Designate an internal or interactive command. |
Internal or interactive command, or configuration instruction |
This is similar to |
in a configuration file. |
.Ic \&Cm |
See also |
but used for instructions rather than values. |
.Ic \&Cm . |
.Pp |
.Pp |
Examples: |
Examples: |
.Dl \&.Ic :wq |
.Dl \&.Ic :wq |
Line 1933 using semantic annotation macros. |
|
Line 1941 using semantic annotation macros. |
|
.Pp |
.Pp |
Examples: |
Examples: |
.Dl ".Em italic , Sy bold , No and roman" |
.Dl ".Em italic , Sy bold , No and roman" |
.Pp |
.Bd -literal -offset indent |
.Bd -literal -offset indent -compact |
|
\&.Sm off |
\&.Sm off |
\&.Cm :C No / Ar pattern No / Ar replacement No / |
\&.Cm :C No / Ar pattern No / Ar replacement No / |
\&.Sm on |
\&.Sm on |
Line 2891 then the macro accepts an arbitrary number of argument |
|
Line 2898 then the macro accepts an arbitrary number of argument |
|
.It Ic \&Ms Ta Yes Ta Yes Ta >0 |
.It Ic \&Ms Ta Yes Ta Yes Ta >0 |
.It Ic \&Mt Ta Yes Ta Yes Ta >0 |
.It Ic \&Mt Ta Yes Ta Yes Ta >0 |
.It Ic \&Nm Ta Yes Ta Yes Ta n |
.It Ic \&Nm Ta Yes Ta Yes Ta n |
.It Ic \&No Ta Yes Ta Yes Ta 0 |
.It Ic \&No Ta Yes Ta Yes Ta >0 |
.It Ic \&Ns Ta Yes Ta Yes Ta 0 |
.It Ic \&Ns Ta Yes Ta Yes Ta 0 |
.It Ic \&Nx Ta Yes Ta Yes Ta n |
.It Ic \&Nx Ta Yes Ta Yes Ta n |
.It Ic \&Os Ta \&No Ta \&No Ta n |
.It Ic \&Os Ta \&No Ta \&No Ta n |
Line 2971 exclamation mark |
|
Line 2978 exclamation mark |
|
Note that even a period preceded by a backslash |
Note that even a period preceded by a backslash |
.Pq Sq \e.\& |
.Pq Sq \e.\& |
gets this special handling; use |
gets this special handling; use |
.Sq \e&. |
.Sq \e&.\& |
to prevent that. |
to prevent that. |
.Pp |
.Pp |
Many in-line macros interrupt their scope when they encounter |
Many in-line macros interrupt their scope when they encounter |
Line 2998 in the same way as a plain |
|
Line 3005 in the same way as a plain |
|
.Sq \&| |
.Sq \&| |
character. |
character. |
Using this predefined string is not recommended in new manuals. |
Using this predefined string is not recommended in new manuals. |
|
.Pp |
|
Appending a zero-width space |
|
.Pq Sq \e& |
|
to the end of an input line is also useful to prevent the interpretation |
|
of a trailing period, exclamation or question mark as the end of a |
|
sentence, for example when an abbreviation happens to occur |
|
at the end of a text or macro input line. |
.Ss Font handling |
.Ss Font handling |
In |
In |
.Nm |
.Nm |