AT&T UNIX™PC Unix System V Users Manual - tenox

CPP ( l ) CPP ( l )
NAME
cpp - the C language preprocessor
SYNOPSIS
/lib/ cpp [ option ... ] [ ifile [ ofile ] ]
/lib/mcpp -
DESCRIPTION
Cpp is the C language preprocessor which is invoked as the first
pass of any C compilation using the cc(l) command. Thus the
output of cpp is designed to be in a form acceptable as input to
the next pass of the C compiler. As the C language evolves, cpp
and the rest of the C compilation package will be modified to follow
these changes. Therefore, the use of cpp other than in this
framework is not suggested. The preferred way to invoke cpp is
through the cc(l) command since the functionality of cpp may
someday be moved elsewhere. See m4(1) for a general macro processor.
Cpp optionally accepts two file names as arguments. lfile and
ofile are respectively the input and output for the preprocessor.
They default to standard input and standard output if not supplied.
The following options to cpp are recognized:
-P Preprocess the input without producing the line control
information used by the next pass of the C compiler.
-C By default, cpp strips C-style comments. If the -C
option is specified, all comments (except those found on
cpp directive lines) are passed along.
-Uname
Remove any initial definition of name, where name is a
reserved symbol that is predefined by the particular
preprocessor. The current list of these possibly reserved
symbols includes:
operating system: ibm, gcos, os, tss, unix
hardware: interdata, pdpll, u370, u3b, vax,
mc68K
UNIX variant: RES, RT
-Dname
-Dname=def
Define name as if by a #define directive. If no =def is
given, name is defined as 1.
-ldir Change the algorithm for searching for #include files
whose names do not begin with / to look in dir before
looking in the directories on the standard list. Thus,
#include files whose names are enclosed in " " will be
searched for first in the directory of the ifile argument,
then in directories named in -1 options, and last in directories
on a standard list. For #include files whose names
are enclosed in < >, the directory of the ifile argument is
not searched.
- 1 -