version 1.14, 2003/10/23 09:09:13 |
version 1.15, 2007/04/02 14:12:51 |
|
|
.Sh SYNOPSIS |
.Sh SYNOPSIS |
.Nm |
.Nm |
.Op Fl ceklst |
.Op Fl ceklst |
|
.Sm off |
.Oo |
.Oo |
.Fl I Ns Ar path |
.Fl D Ar sym |
.Fl D Ns Ar sym |
.Op = Ar val |
.Ns Op = Ns Ar val |
|
.Fl U Ns Ar sym |
|
.Fl iD Ns Ar sym |
|
.Ns Op = Ns Ar val |
|
.Fl iU Ns Ar sym |
|
.Oc |
.Oc |
.Ar ... |
.Op Fl I Ar path |
|
.Oo |
|
.Fl iD Ar sym |
|
.Op = Ar val |
|
.Oc |
|
.Op Fl iU Ar sym |
|
.Op Fl U Ar sym |
|
.Sm on |
.Op Ar file |
.Op Ar file |
.Sh DESCRIPTION |
.Sh DESCRIPTION |
The |
The |
|
|
It spots unusually-formatted preprocessor directives |
It spots unusually-formatted preprocessor directives |
and knows when the layout is too odd to handle. |
and knows when the layout is too odd to handle. |
.Pp |
.Pp |
Available options: |
The options are as follows: |
.Bl -tag -width indent -compact |
|
.It Fl D Ns Ar sym |
|
.Ns Op = Ns Ar val |
|
Specify that a symbol is defined, |
|
and optionally specify what value to give it |
|
for the purpose of handling |
|
.Ic #if |
|
and |
|
.Ic #elif |
|
directives. |
|
.Pp |
.Pp |
.It Fl U Ns Ar sym |
.Bl -tag -width indent -compact |
Specify that a symbol is undefined. |
|
If the same symbol appears in more than one argument, |
|
the last occurrence dominates. |
|
.Pp |
|
.It Fl c |
.It Fl c |
If the |
If the |
.Fl c |
.Fl c |
|
|
i.e., the lines that would have been removed or blanked |
i.e., the lines that would have been removed or blanked |
are retained and vice versa. |
are retained and vice versa. |
.Pp |
.Pp |
|
.Sm off |
|
.It Xo |
|
.Fl D Ar sym |
|
.Op = Ar val |
|
.Xc |
|
.Sm on |
|
Specify that a symbol is defined, |
|
and optionally specify what value to give it |
|
for the purpose of handling |
|
.Ic #if |
|
and |
|
.Ic #elif |
|
directives. |
|
.Pp |
.It Fl e |
.It Fl e |
Because |
Because |
.Nm |
.Nm |
|
|
where possible, |
where possible, |
such lines are left unprocessed instead of reporting an error. |
such lines are left unprocessed instead of reporting an error. |
.Pp |
.Pp |
|
.Sm off |
|
.It Xo |
|
.Fl iD Ar sym |
|
.Op = Ar val |
|
.Xc |
|
.Sm on |
|
.It Fl iU Ns Ar sym |
|
Ignore |
|
.Ic #ifdef Ns s . |
|
If your C code uses |
|
.Ic #ifdef Ns s |
|
to delimit non-C lines, |
|
such as comments |
|
or code which is under construction, |
|
then you must tell |
|
.Nm |
|
which symbols are used for that purpose so that it will not try to parse |
|
comments and line continuations |
|
inside those |
|
.Ic #ifdef Ns s . |
|
One specifies ignored symbols with |
|
.Sm off |
|
.Fl iD Ar sym Op = Ar val |
|
.Sm on |
|
and |
|
.Fl iU Ns Ar sym , |
|
similar to |
|
.Sm off |
|
.Fl D Ar sym Op = Ar val |
|
.Sm on |
|
and |
|
.Fl U Ns Ar sym . |
|
.Pp |
.It Fl k |
.It Fl k |
Process |
Process |
.Ic #if |
.Ic #if |
|
|
which is useful |
which is useful |
for plain text. |
for plain text. |
.Pp |
.Pp |
.It Fl iD Ns Ar sym |
.It Fl U Ns Ar sym |
.Ns Op = Ns Ar val |
Specify that a symbol is undefined. |
.It Fl iU Ns Ar sym |
If the same symbol appears in more than one argument, |
Ignore |
the last occurrence dominates. |
.Ic #ifdef Ns s . |
.Pp |
If your C code uses |
|
.Ic #ifdef Ns s |
|
to delimit non-C lines, |
|
such as comments |
|
or code which is under construction, |
|
then you must tell |
|
.Nm |
|
which symbols are used for that purpose so that it will not try to parse |
|
comments and line continuations |
|
inside those |
|
.Ic #ifdef Ns s . |
|
One specifies ignored symbols with |
|
.Fl iD Ns Ar sym |
|
.Ns Oo = Ns Ar val Oc |
|
and |
|
.Fl iU Ns Ar sym |
|
similar to |
|
.Fl D Ns Ar sym |
|
.Ns Op = Ns Ar val |
|
and |
|
.Fl U Ns Ar sym |
|
above. |
|
.El |
.El |
.Pp |
.Pp |
The |
The |