summaryrefslogtreecommitdiff
path: root/usr.bin/unifdef/unifdef.1
diff options
context:
space:
mode:
Diffstat (limited to 'usr.bin/unifdef/unifdef.1')
-rw-r--r--usr.bin/unifdef/unifdef.1118
1 files changed, 66 insertions, 52 deletions
diff --git a/usr.bin/unifdef/unifdef.1 b/usr.bin/unifdef/unifdef.1
index b1dc97854c6..48cc9e3ebe5 100644
--- a/usr.bin/unifdef/unifdef.1
+++ b/usr.bin/unifdef/unifdef.1
@@ -1,4 +1,4 @@
-.\" $OpenBSD: unifdef.1,v 1.14 2003/10/23 09:09:13 jmc Exp $
+.\" $OpenBSD: unifdef.1,v 1.15 2007/04/02 14:12:51 jmc Exp $
.\" Copyright (c) 1985, 1991, 1993
.\" The Regents of the University of California. All rights reserved.
.\"
@@ -42,16 +42,19 @@
.Sh SYNOPSIS
.Nm
.Op Fl ceklst
+.Sm off
.Oo
-.Fl I Ns Ar path
-.Fl D Ns Ar sym
-.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
+.Fl D Ar sym
+.Op = Ar val
+.Oc
+.Op Fl I Ar path
+.Oo
+.Fl iD Ar sym
+.Op = Ar val
.Oc
-.Ar ...
+.Op Fl iU Ar sym
+.Op Fl U Ar sym
+.Sm on
.Op Ar file
.Sh DESCRIPTION
The
@@ -114,23 +117,9 @@ or affected by a backslash-continued line.
It spots unusually-formatted preprocessor directives
and knows when the layout is too odd to handle.
.Pp
-Available options:
-.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
-.It Fl U Ns Ar sym
-Specify that a symbol is undefined.
-If the same symbol appears in more than one argument,
-the last occurrence dominates.
+The options are as follows:
.Pp
+.Bl -tag -width indent -compact
.It Fl c
If the
.Fl c
@@ -141,6 +130,20 @@ is complemented,
i.e., the lines that would have been removed or blanked
are retained and vice versa.
.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
Because
.Nm
@@ -159,6 +162,39 @@ option changes the behavior so that,
where possible,
such lines are left unprocessed instead of reporting an error.
.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
Process
.Ic #if
@@ -197,33 +233,11 @@ and line continuations,
which is useful
for plain text.
.Pp
-.It Fl iD Ns Ar sym
-.Ns Op = Ns Ar val
-.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
-.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.
+.It Fl U Ns Ar sym
+Specify that a symbol is undefined.
+If the same symbol appears in more than one argument,
+the last occurrence dominates.
+.Pp
.El
.Pp
The