version 1.69, 2015/01/29 00:33:57 |
version 1.76, 2017/02/21 23:44:43 |
|
|
.\" $Id$ |
.\" $Id$ |
.\" |
.\" |
.\" Copyright (c) 2010, 2011, 2012 Kristaps Dzonsons <kristaps@bsd.lv> |
.\" Copyright (c) 2010, 2011, 2012 Kristaps Dzonsons <kristaps@bsd.lv> |
.\" Copyright (c) 2010, 2011, 2013, 2014 Ingo Schwarze <schwarze@openbsd.org> |
.\" Copyright (c) 2010, 2011, 2013-2015 Ingo Schwarze <schwarze@openbsd.org> |
.\" |
.\" |
.\" Permission to use, copy, modify, and distribute this software for any |
.\" Permission to use, copy, modify, and distribute this software for any |
.\" purpose with or without fee is hereby granted, provided that the above |
.\" purpose with or without fee is hereby granted, provided that the above |
|
|
.D1 \efI\e^XtFree\e^\efP. |
.D1 \efI\e^XtFree\e^\efP. |
.Pp |
.Pp |
in the input stream, and thus in the output: \fI\^XtFree\^\fP. |
in the input stream, and thus in the output: \fI\^XtFree\^\fP. |
|
Each occurrence of \e\e$* is replaced with all the arguments, |
|
joined together with single blank characters. |
.Pp |
.Pp |
Since macros and user-defined strings share a common string table, |
Since macros and user-defined strings share a common string table, |
defining a macro |
defining a macro |
Line 1057 If the first character of COND is |
|
Line 1059 If the first character of COND is |
|
.Pq string defined , |
.Pq string defined , |
.Sq e |
.Sq e |
.Pq even page , |
.Pq even page , |
.Sq r |
|
.Pq register accessed , |
|
.Sq t |
.Sq t |
.Pq troff mode , |
.Pq troff mode , |
or |
or |
|
|
.Pq vroff mode , |
.Pq vroff mode , |
COND evaluates to false. |
COND evaluates to false. |
.It |
.It |
|
If the first character of COND is |
|
.Sq r , |
|
it evaluates to true if the rest of COND is the name of an existing |
|
number register; otherwise, it evaluates to false. |
|
.It |
If COND starts with a parenthesis or with an optionally signed |
If COND starts with a parenthesis or with an optionally signed |
integer number, it is evaluated according to the rules of |
integer number, it is evaluated according to the rules of |
.Sx Numerical expressions |
.Sx Numerical expressions |
Line 1196 This is a Heirloom extension and currently unsupported |
|
Line 1201 This is a Heirloom extension and currently unsupported |
|
Set an input line trap. |
Set an input line trap. |
Its syntax is as follows: |
Its syntax is as follows: |
.Pp |
.Pp |
.D1 Pf . Cm it Ar number macro |
.D1 Pf . Cm it Ar expression macro |
.Pp |
.Pp |
The named |
The named |
.Ar macro |
.Ar macro |
will be invoked after processing the specified |
will be invoked after processing the number of input text lines |
.Ar number |
specified by the numerical |
of input text lines. |
.Ar expression . |
|
While evaluating the |
|
.Ar expression , |
|
the unit suffixes described below |
|
.Sx Scaling Widths |
|
are ignored. |
.Ss \&itc |
.Ss \&itc |
Set an input line trap, not counting lines ending with \ec. |
Set an input line trap, not counting lines ending with \ec. |
Currently unsupported. |
Currently unsupported. |
Line 1332 Currently unsupported. |
|
Line 1342 Currently unsupported. |
|
Temporarily turn off line numbering. |
Temporarily turn off line numbering. |
Currently unsupported. |
Currently unsupported. |
.Ss \&nop |
.Ss \&nop |
Exexute the rest of the input line as a request or macro line. |
Execute the rest of the input line as a request or macro line. |
Currently unsupported. |
Currently unsupported. |
.Ss \&nr |
.Ss \&nr |
Define or change a register. |
Define or change a register. |
|
|
Takes an arbitrary number of arguments. |
Takes an arbitrary number of arguments. |
Currently unsupported. |
Currently unsupported. |
.Ss \&tc |
.Ss \&tc |
Change tab repetion character. |
Change tab repetition character. |
Currently unsupported. |
Currently unsupported. |
.Ss \&TE |
.Ss \&TE |
End a table context. |
End a table context. |
Line 1674 Notify on change of string or macro. |
|
Line 1684 Notify on change of string or macro. |
|
This is a Heirloom extension and currently ignored. |
This is a Heirloom extension and currently ignored. |
.Ss \&watchlength |
.Ss \&watchlength |
On change, report the contents of macros and strings |
On change, report the contents of macros and strings |
up to the sepcified length. |
up to the specified length. |
This is a Heirloom extension and currently ignored. |
This is a Heirloom extension and currently ignored. |
.Ss \&watchn |
.Ss \&watchn |
Notify on change of register. |
Notify on change of register. |
Line 1769 minimum (not available in C) |
|
Line 1779 minimum (not available in C) |
|
maximum (not available in C) |
maximum (not available in C) |
.El |
.El |
.Pp |
.Pp |
There is no concept of precendence; evaluation proceeds from left to right, |
There is no concept of precedence; evaluation proceeds from left to right, |
except when subexpressions are enclosed in parantheses. |
except when subexpressions are enclosed in parentheses. |
Inside parentheses, whitespace is ignored. |
Inside parentheses, whitespace is ignored. |
.Sh ESCAPE SEQUENCE REFERENCE |
.Sh ESCAPE SEQUENCE REFERENCE |
The |
The |
Line 1829 For short names, there are variants |
|
Line 1839 For short names, there are variants |
|
.No \e* Ns Ar c |
.No \e* Ns Ar c |
and |
and |
.No \e*( Ns Ar cc . |
.No \e*( Ns Ar cc . |
|
.Ss \e, |
|
Left italic correction (groff extension); ignored by |
|
.Xr mandoc 1 . |
.Ss \e- |
.Ss \e- |
Special character |
Special character |
.Dq mathematical minus sign . |
.Dq mathematical minus sign . |
|
.Ss \e/ |
|
Right italic correction (groff extension); ignored by |
|
.Xr mandoc 1 . |
.Ss \e[ Ns Ar name ] |
.Ss \e[ Ns Ar name ] |
.Sx Special Characters |
.Sx Special Characters |
with names of arbitrary length, see |
with names of arbitrary length, see |
|
|
with zero width and height; ignored by |
with zero width and height; ignored by |
.Xr mandoc 1 . |
.Xr mandoc 1 . |
.Ss \ez |
.Ss \ez |
Output the next character without advancing the cursor position; |
Output the next character without advancing the cursor position. |
approximated in |
|
.Xr mandoc 1 |
|
by simply skipping the next character. |
|
.Sh COMPATIBILITY |
.Sh COMPATIBILITY |
The |
The |
.Xr mandoc 1 |
.Xr mandoc 1 |