scc

  1.TH SCC-CPP 1 scc\-VERSION
  2.SH NAME
  3scc-cpp \- C preprocessor wrapper
  4.SH SYNOPSIS
  5.B scc-cpp
  6.RB [ \-dw ]
  7.RB [ \-M ]
  8.RB [ \-D
  9.IR def[=val] ] ...
 10.RB [ \-I
 11.IR dir ] ...
 12.RB [ \-U
 13.IR def ] ...
 14.RB [ \-o
 15.IR outfile ]
 16.RI [ sourcefile ...]
 17.SH DESCRIPTION
 18.B scc-cpp
 19is a wrapper that invokes the C preprocessor stage of the scc compiler.
 20It is equivalent to running
 21.B scc-cc \-E
 22with the same arguments.
 23The preprocessor expands macros, processes
 24.B #include
 25directives, handles conditional compilation, and strips comments,
 26producing preprocessed C source on standard output or in the specified
 27output file.
 28.SH OPTIONS
 29The following options are meaningful to the preprocessor.
 30All other options accepted by
 31.BR scc-cc (1)
 32are silently passed through but have no effect during preprocessing.
 33.TP
 34.B \-d
 35Output internal tool messages.
 36.TP
 37.BI \-D " define[=value]"
 38Predefine
 39.I define
 40as a macro, optionally with a replacement text
 41.IR value .
 42This option may be specified multiple times.
 43.TP
 44.BI \-I " directory"
 45Add
 46.I directory
 47to the list of directories searched for
 48.B #include
 49files.
 50User-specified directories are searched before the standard system
 51include directories.
 52This option may be specified multiple times.
 53.TP
 54.B \-M
 55Instead of producing preprocessed output, output a rule suitable for
 56.BR make (1)
 57describing the dependencies of the main source file.
 58.TP
 59.BI \-o " outfile"
 60Write output to
 61.I outfile
 62instead of standard output.
 63.TP
 64.BI \-U " define"
 65Undefine
 66.IR define ,
 67cancelling any previous definition made with
 68.B \-D
 69or by the compiler's built-in predefined macros.
 70This option may be specified multiple times.
 71.TP
 72.B \-w
 73or
 74.BI \-W " param"
 75Enable warning messages.
 76The parameter of
 77.B \-W
 78is ignored for compatibility reasons.
 79.SH ENVIRONMENT VARIABLES
 80The following environment variables influence the behaviour of
 81.BR scc-cpp ,
 82which are inherited from
 83.BR scc-cc (1).
 84.TP
 85.B ARCH
 86Defines the target architecture (e.g.
 87.IR amd64 ,
 88.IR i386 ).
 89This affects predefined macros exposed to the preprocessor.
 90.TP
 91.B SYS
 92Defines the target operating system (e.g.
 93.IR linux ,
 94.IR openbsd ).
 95This affects predefined macros exposed to the preprocessor.
 96.TP
 97.B ABI
 98Defines the target application binary interface (e.g.
 99.IR sysv ).
100.TP
101.B FORMAT
102Defines the format of the output object file.
103.TP
104.B SCCPREFIX
105Defines the path prefix under which the scc suite is installed.
106.B scc-cpp
107uses this to locate
108.BR scc-cc (1).
109If not set, the scc tools fall back to their compile-time
110.BR PREFIX .
111.SH EXAMPLES
112Preprocess a source file and print the result to standard output:
113.IP
114.EX
115scc-cpp hello.c
116.EE
117.PP
118Preprocess with macro definitions and an extra include path:
119.IP
120.EX
121scc-cpp \-DDEBUG \-DVERSION=2 \-I./include \-o hello.i hello.c
122.EE
123.PP
124Generate
125.BR make (1)
126dependency rules:
127.IP
128.EX
129scc-cpp \-M hello.c
130.EE
131.PP
132Undefine a macro before preprocessing:
133.IP
134.EX
135scc-cpp \-UFOO hello.c
136.EE
137.SH SEE ALSO
138.BR scc-cc (1),
139.BR scc (1)