sys/man/1/cpp

   1 .TH CPP 1
   2 .SH NAME
   3 cpp \- C language preprocessor
   4 .SH SYNOPSIS
   5 .B cpp
   6 [
   7 .I option ...
   8 ]
   9 [
  10 .I ifile
  11 [
  12 .I ofile
  13 ]
  14 ]
  15 .SH DESCRIPTION
  16 .I Cpp\^
  17 interprets ANSI C preprocessor directives
  18 and does macro substitution.
  19 The input
  20 .I ifile
  21 and output
  22 .I ofile
  23 default to standard input and standard output respectively.
  24 .PP
  25 The options are:
  26 .TP
  27 .BI -D name\^
  28 .PD 0
  29 .TP
  30 .BI -D name=def\^
  31 .TP
  32 .BI -I dir\^
  33 Same as in
  34 .IR 2c "(1): add
  35 .I dir
  36 to the search for
  37 .CW search
  38 directives.
  39 .PD
  40 .TP
  41 .B -M
  42 Generate no output except a list of include files
  43 in a form suitable for specifying dependencies to
  44 .IR mk (1).
  45 Use twice to list files in angle brackets.
  46 .TP
  47 .B -N
  48 Turn off default include directories.  All must be
  49 specified with
  50 .BR -I ,
  51 or in the environment variable
  52 .BR include .
  53 Without this option,
  54 .B /$objtype/include
  55 and
  56 .B /sys/include
  57 are used as the last two searched directories for include directives,
  58 where
  59 .B $objtype
  60 is read from the environment.
  61 .TP
  62 .B -V
  63 Print extra debugging information.
  64 .TP
  65 .B -P
  66 Do not insert
  67 .RB `` #line ''
  68 directives into the output.
  69 .TP
  70 .B -.
  71 Inhibit include search in the source's directory.
  72 .TP
  73 .B -i
  74 Print the list of directories searched when
  75 .I #include
  76 is found.
  77 Last listed are searched first.
  78 .PD
  79 .PP
  80 In the absence of the
  81 .B -P
  82 option, the processed text output is sprinkled
  83 with lines that show the original input line numbering:
  84 .IP
  85 .B #line
  86 .I linenumber
  87 .L
  88 "\fIifile\fP"
  89 .PP
  90 The command reads the environment variable
  91 .IR include
  92 and adds its (blank-separated) list of directories to
  93 the standard search path for
  94 .CW #include
  95 directives.  They are looked at before any directories specified with
  96 .BR -I ,
  97 which are looked at before the default directories.
  98 .PP
  99 The input language is as described in the ANSI C standard.
 100 The standard Plan 9 C compilers do not use
 101 .IR cpp ;
 102 they contain their own simple but adequate preprocessor, so
 103 .I cpp
 104 is usually superfluous.
 105 .SH FILES
 106 .TF /objtype/include
 107 .TP
 108 .B /sys/include
 109 directory for machine-independent include files
 110 .TP
 111 .B /$objtype/include
 112 directory for machine-dependent include files
 113 .SH SOURCE
 114 .B /sys/src/cmd/cpp
 115 .SH SEE ALSO
 116 .IR 2c (1)