Return to unifdef.1 CVS log

Up to [CSRG BSD Unix] / 43BSDTahoe / man / man1

Annotation of 43BSDTahoe/man/man1/unifdef.1, revision 1.1.1.1

1.1       root        1: .\" Copyright (c) 1985 Regents of the University of California.
                      2: .\" All rights reserved.  The Berkeley software License Agreement
                      3: .\" specifies the terms and conditions for redistribution.
                      4: .\"
                      5: .\"    @(#)unifdef.1   6.1 (Berkeley) 4/29/85
                      6: .\"
                      7: .TH UNIFDEF 1 "April 29, 1985"
                      8: .UC 6
                      9: .SH NAME
                     10: unifdef \- remove ifdef'ed lines
                     11: .SH SYNOPSIS
                     12: .B unifdef
                     13: [
                     14: .B \-t
                     15: .B \-l
                     16: .B \-c
                     17: .BI \-D sym
                     18: .BI \-U sym
                     19: .BI \-id sym
                     20: .BI \-iu sym
                     21: ] ...  [ file ]
                     22: .SH DESCRIPTION
                     23: .I Unifdef
                     24: is useful for removing ifdef'ed lines from a file while otherwise leaving the
                     25: file alone.
                     26: .I Unifdef
                     27: is like a stripped-down C preprocessor:
                     28: it is smart enough to deal with the nested ifdefs, comments,
                     29: single and double
                     30: quotes of C syntax so that it can do its job, but it doesn't do any including
                     31: or interpretation of macros.
                     32: Neither does it strip out comments, though it recognizes and ignores them.
                     33: You specify which symbols you want defined
                     34: .BI \-D sym
                     35: or undefined
                     36: .BI \-U sym
                     37: and the lines inside those ifdefs will be copied to the output or removed as
                     38: appropriate.
                     39: The ifdef, ifndef, else, and endif lines associated with
                     40: .I sym
                     41: will also be removed.
                     42: Ifdefs involving symbols you don't specify are untouched and copied out
                     43: along with their associated
                     44: ifdef, else, and endif lines.
                     45: If an ifdef X occurs nested inside another ifdef X, then the
                     46: inside ifdef is treated as if it were an unrecognized symbol.
                     47: If the same symbol appears in more than one argument, only the first
                     48: occurrence is significant.
                     49: .PP
                     50: The
                     51: .B \-l
                     52: option causes
                     53: .I unifdef
                     54: to replace removed lines with blank lines
                     55: instead of deleting them.
                     56: .PP
                     57: If you use ifdefs to delimit non-C lines, such as comments
                     58: or code which is under construction,
                     59: then you must tell
                     60: .I unifdef
                     61: which symbols are used for that purpose so that it won't try to parse
                     62: for quotes and comments
                     63: in those ifdef'ed lines.
                     64: You specify that you want the lines inside certain ifdefs to be ignored
                     65: but copied out with
                     66: .BI \-id sym
                     67: and
                     68: .BI \-iu sym
                     69: similar to
                     70: .BI \-D sym
                     71: and
                     72: .BI \-U sym
                     73: above.
                     74: .PP
                     75: If you want to use
                     76: .I unifdef
                     77: for plain text (not C code), use the
                     78: .B \-t
                     79: option.
                     80: This makes
                     81: .I unifdef
                     82: refrain from attempting to recognize comments and single and double quotes.
                     83: .PP
                     84: .I Unifdef
                     85: copies its output to
                     86: .I stdout
                     87: and will take its input from
                     88: .I stdin
                     89: if no
                     90: .I file
                     91: argument is given.
                     92: If the
                     93: .B \-c
                     94: argument is specified, then the operation of
                     95: .I unifdef
                     96: is complemented,
                     97: i.e. the lines that would have been removed or blanked
                     98: are retained and vice versa.
                     99: .SH "SEE ALSO"
                    100: diff(1)
                    101: .SH DIAGNOSTICS
                    102: Premature EOF, inappropriate else or endif.
                    103: .PP
                    104: Exit status is 0 if output is exact copy of input, 1 if not, 2 if trouble.
                    105: .SH BUGS
                    106: Does not know how to deal with \fIcpp\fP consructs such as
                    107: .br
                    108: .sp
                    109: .nf
                    110:        #if     defined(X) || defined(Y)
                    111: .sp
                    112: .fi
                    113: .SH AUTHOR
                    114: Dave Yost

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.