version 1.40, 2005/09/06 15:50:19 |
version 1.41, 2005/09/07 13:22:24 |
|
|
.Nd macro language processor |
.Nd macro language processor |
.Sh SYNOPSIS |
.Sh SYNOPSIS |
.Nm m4 |
.Nm m4 |
.Op Fl d Ar flags |
.Op Fl gs |
.Op Fl t Ar name |
|
.Op Fl o Ar filename |
|
.Op Fl g |
|
.Op Fl s |
|
.Oo |
.Oo |
.Fl D Ns Ar name Ns Op Ar =value |
.Sm off |
|
.Fl D Ar name Op No = Ar value |
|
.Sm on |
.Oc |
.Oc |
.Op Fl U Ns Ar name |
.Op Fl d Ar flags |
.Op Fl I Ar dirname |
.Op Fl I Ar dirname |
|
.Op Fl o Ar filename |
|
.Bk -words |
|
.Op Fl t Ar macro |
|
.Op Fl U Ns Ar name |
|
.Ek |
.Sh DESCRIPTION |
.Sh DESCRIPTION |
The |
The |
.Nm m4 |
.Nm m4 |
|
|
The options are as follows: |
The options are as follows: |
.Bl -tag -width Ds |
.Bl -tag -width Ds |
.It Fl D Ns Ar name Ns Oo |
.It Fl D Ns Ar name Ns Oo |
.Ar =value |
.Pf = Ns Ar value |
.Oc |
.Oc |
Define the symbol |
Define the symbol |
.Ar name |
.Ar name |
to have some value (or |
to have some value (or |
.Dv NULL ) . |
.Dv NULL ) . |
.It Fl "U" Ns Ar "name" |
|
Undefine the symbol |
|
.Ar name . |
|
.It Fl I Ar "dirname" |
|
Add directory |
|
.Ar dirname |
|
to the include path. |
|
.It Fl d Ar "flags" |
.It Fl d Ar "flags" |
Set trace flags. |
Set trace flags. |
.Ar flags |
.Ar flags |
|
|
.Pp |
.Pp |
By default, trace is set to |
By default, trace is set to |
.Qq eq . |
.Qq eq . |
.It Fl o Ar filename |
|
Send trace output to |
|
.Ar filename . |
|
.It Fl t Ar macro |
|
Turn tracing on for |
|
.Ar macro . |
|
.It Fl g |
.It Fl g |
Activate GNU-m4 compatibility mode. |
Activate GNU-m4 compatibility mode. |
In this mode, translit handles simple character |
In this mode, translit handles simple character |
ranges (e.g., a-z), regular expressions mimic emacs behavior, |
ranges (e.g., a-z), regular expressions mimic emacs behavior, |
multiple m4wrap calls are handled as a stack, |
multiple m4wrap calls are handled as a stack, |
and the number of diversions is unlimited. |
and the number of diversions is unlimited. |
|
.It Fl I Ar "dirname" |
|
Add directory |
|
.Ar dirname |
|
to the include path. |
|
.It Fl o Ar filename |
|
Send trace output to |
|
.Ar filename . |
.It Fl s |
.It Fl s |
Output line synchronization directives, suitable for |
Output line synchronization directives, suitable for |
.Xr cpp 1 . |
.Xr cpp 1 . |
|
.It Fl t Ar macro |
|
Turn tracing on for |
|
.Ar macro . |
|
.It Fl "U" Ns Ar "name" |
|
Undefine the symbol |
|
.Ar name . |
.El |
.El |
.Sh SYNTAX |
.Sh SYNTAX |
.Nm m4 |
.Nm m4 |