version 1.109, 2018/12/16 00:17:02 |
version 1.110, 2018/12/16 01:34:56 |
Line 44 utility supports a subset of |
|
Line 44 utility supports a subset of |
|
requests and escapes. |
requests and escapes. |
Even though this manual page lists all |
Even though this manual page lists all |
.Nm |
.Nm |
requests, it only has partial information about requests not supported by |
requests and escape sequences, it only contains partial information |
|
about requests not supported by |
.Xr mandoc 1 |
.Xr mandoc 1 |
and about language features that do not matter for manual pages. |
and about language features that do not matter for manual pages. |
For complete |
For complete |
Line 86 indicates the start of an escape sequence, used for ex |
|
Line 87 indicates the start of an escape sequence, used for ex |
|
.Sx Comments |
.Sx Comments |
and |
and |
.Sx Special Characters . |
.Sx Special Characters . |
For a listing of escape sequences, consult the |
For a complete listing of escape sequences, consult the |
.Sx ESCAPE SEQUENCE REFERENCE |
.Sx ESCAPE SEQUENCE REFERENCE |
below. |
below. |
.Ss Comments |
.Ss Comments |
|
|
.It i |
.It i |
inch |
inch |
.It P |
.It P |
pica (~1/6 inch) |
pica (1/6 inch) |
.It p |
.It p |
point (~1/72 inch) |
point (1/72 inch) |
.It f |
.It f |
scale |
scale |
.Sq u |
.Sq u |
|
|
.It u |
.It u |
default horizontal span for the terminal |
default horizontal span for the terminal |
.It M |
.It M |
mini-em (~1/100 em) |
mini-em (1/100 em) |
.El |
.El |
.Pp |
.Pp |
Using anything other than |
Using anything other than |
Line 640 macros, whichever applies to the document in question. |
|
Line 641 macros, whichever applies to the document in question. |
|
.Pp |
.Pp |
Specifying a custom |
Specifying a custom |
.Ar endmacro |
.Ar endmacro |
macro works in the same way as for |
works in the same way as for |
.Ic \&ig ; |
.Ic \&ig ; |
namely, the call to |
namely, the call to |
.Sq Pf . Ar endmacro |
.Sq Pf . Ar endmacro |
|
|
.Xr mandoc 1 |
.Xr mandoc 1 |
.Nm |
.Nm |
parser recognises the following escape sequences. |
parser recognises the following escape sequences. |
Note that the |
|
.Nm |
|
language defines more escape sequences not implemented in |
|
.Xr mandoc 1 . |
|
In |
In |
.Xr mdoc 7 |
.Xr mdoc 7 |
and |
and |
Line 1862 described in the |
|
Line 1859 described in the |
|
.Sx LANGUAGE SYNTAX |
.Sx LANGUAGE SYNTAX |
section above. |
section above. |
.Pp |
.Pp |
In |
A backslash followed by any character not listed here |
.Xr mandoc 1 , |
|
a backslash followed by any character not listed here |
|
simply prints that character itself. |
simply prints that character itself. |
.Bl -tag -width Ds |
.Bl -tag -width Ds |
.It Ic \e<newline> |
.It Ic \e<newline> |
Line 1875 on both lines together as if it were on a single input |
|
Line 1870 on both lines together as if it were on a single input |
|
The escape sequence backslash-space |
The escape sequence backslash-space |
.Pq Sq \e\ \& |
.Pq Sq \e\ \& |
is an unpaddable space-sized non-breaking space character; see |
is an unpaddable space-sized non-breaking space character; see |
.Sx Whitespace . |
.Sx Whitespace |
|
and |
|
.Xr mandoc_char 7 . |
.It Ic \e! |
.It Ic \e! |
Embed text up to and including the end of the input line into the |
Embed text up to and including the end of the input line into the |
current diversion or into intermediate output without interpreting |
current diversion or into intermediate output without interpreting |
Line 1897 Macro argument expansion, see |
|
Line 1894 Macro argument expansion, see |
|
Hyphenation allowed at this point of the word; ignored by |
Hyphenation allowed at this point of the word; ignored by |
.Xr mandoc 1 . |
.Xr mandoc 1 . |
.It Ic \e& |
.It Ic \e& |
Non-printing zero-width character; see |
Non-printing zero-width character, |
.Sx Whitespace . |
often used for various kinds of escaping; see |
|
.Sx Whitespace , |
|
.Xr mandoc_char 7 , |
|
and the |
|
.Dq MACRO SYNTAX |
|
and |
|
.Dq Delimiters |
|
sections in |
|
.Xr mdoc 7 . |
.It Ic \e\(aq |
.It Ic \e\(aq |
Acute accent special character; use |
Acute accent special character; use |
.Ic \e(aa |
.Ic \e(aa |
Line 1944 Left italic correction (groff extension); ignored by |
|
Line 1949 Left italic correction (groff extension); ignored by |
|
.Xr mandoc 1 . |
.Xr mandoc 1 . |
.It Ic \e- |
.It Ic \e- |
Special character |
Special character |
.Dq mathematical minus sign . |
.Dq mathematical minus sign ; |
|
see |
|
.Xr mandoc_char 7 |
|
for details. |
.It Ic \e/ |
.It Ic \e/ |
Right italic correction (groff extension); ignored by |
Right italic correction (groff extension); ignored by |
.Xr mandoc 1 . |
.Xr mandoc 1 . |
|
|
.Ar string |
.Ar string |
conforms to the syntax of |
conforms to the syntax of |
.Sx Numerical expressions |
.Sx Numerical expressions |
explained above and |
explained above or |
.Sq 0 |
.Sq 0 |
otherwise. |
otherwise. |
.It Ic \eb\(aq Ns Ar string Ns Ic \(aq |
.It Ic \eb\(aq Ns Ar string Ns Ic \(aq |
Line 2022 Move down by half a line; ignored by |
|
Line 2030 Move down by half a line; ignored by |
|
Escape character intended to not be interpreted in copy mode. |
Escape character intended to not be interpreted in copy mode. |
In |
In |
.Xr mandoc 1 , |
.Xr mandoc 1 , |
it does the same as |
it currently does the same as |
.Ic \e |
.Ic \e |
itself for now. |
itself. |
.It Ic \ee |
.It Ic \ee |
Backslash special character. |
Backslash special character. |
.It Ic \eF[ Ns Ar name Ns Ic \&] |
.It Ic \eF[ Ns Ar name Ns Ic \&] |