@c Copyright (c) 1999, 2000, 2001, 2002, 2004
|
@c Copyright (c) 1999, 2000, 2001, 2002, 2004
|
@c Free Software Foundation, Inc.
|
@c Free Software Foundation, Inc.
|
@c This is part of the CPP and GCC manuals.
|
@c This is part of the CPP and GCC manuals.
|
@c For copying conditions, see the file gcc.texi.
|
@c For copying conditions, see the file gcc.texi.
|
|
|
@c ---------------------------------------------------------------------
|
@c ---------------------------------------------------------------------
|
@c Environment variables affecting the preprocessor
|
@c Environment variables affecting the preprocessor
|
@c ---------------------------------------------------------------------
|
@c ---------------------------------------------------------------------
|
|
|
@c If this file is included with the flag ``cppmanual'' set, it is
|
@c If this file is included with the flag ``cppmanual'' set, it is
|
@c formatted for inclusion in the CPP manual; otherwise the main GCC manual.
|
@c formatted for inclusion in the CPP manual; otherwise the main GCC manual.
|
|
|
@vtable @env
|
@vtable @env
|
@item CPATH
|
@item CPATH
|
@itemx C_INCLUDE_PATH
|
@itemx C_INCLUDE_PATH
|
@itemx CPLUS_INCLUDE_PATH
|
@itemx CPLUS_INCLUDE_PATH
|
@itemx OBJC_INCLUDE_PATH
|
@itemx OBJC_INCLUDE_PATH
|
@c Commented out until ObjC++ is part of GCC:
|
@c Commented out until ObjC++ is part of GCC:
|
@c @itemx OBJCPLUS_INCLUDE_PATH
|
@c @itemx OBJCPLUS_INCLUDE_PATH
|
Each variable's value is a list of directories separated by a special
|
Each variable's value is a list of directories separated by a special
|
character, much like @env{PATH}, in which to look for header files.
|
character, much like @env{PATH}, in which to look for header files.
|
The special character, @code{PATH_SEPARATOR}, is target-dependent and
|
The special character, @code{PATH_SEPARATOR}, is target-dependent and
|
determined at GCC build time. For Microsoft Windows-based targets it is a
|
determined at GCC build time. For Microsoft Windows-based targets it is a
|
semicolon, and for almost all other targets it is a colon.
|
semicolon, and for almost all other targets it is a colon.
|
|
|
@env{CPATH} specifies a list of directories to be searched as if
|
@env{CPATH} specifies a list of directories to be searched as if
|
specified with @option{-I}, but after any paths given with @option{-I}
|
specified with @option{-I}, but after any paths given with @option{-I}
|
options on the command line. This environment variable is used
|
options on the command line. This environment variable is used
|
regardless of which language is being preprocessed.
|
regardless of which language is being preprocessed.
|
|
|
The remaining environment variables apply only when preprocessing the
|
The remaining environment variables apply only when preprocessing the
|
particular language indicated. Each specifies a list of directories
|
particular language indicated. Each specifies a list of directories
|
to be searched as if specified with @option{-isystem}, but after any
|
to be searched as if specified with @option{-isystem}, but after any
|
paths given with @option{-isystem} options on the command line.
|
paths given with @option{-isystem} options on the command line.
|
|
|
In all these variables, an empty element instructs the compiler to
|
In all these variables, an empty element instructs the compiler to
|
search its current working directory. Empty elements can appear at the
|
search its current working directory. Empty elements can appear at the
|
beginning or end of a path. For instance, if the value of
|
beginning or end of a path. For instance, if the value of
|
@env{CPATH} is @code{:/special/include}, that has the same
|
@env{CPATH} is @code{:/special/include}, that has the same
|
effect as @samp{@w{-I. -I/special/include}}.
|
effect as @samp{@w{-I. -I/special/include}}.
|
|
|
@c man end
|
@c man end
|
@ifset cppmanual
|
@ifset cppmanual
|
See also @ref{Search Path}.
|
See also @ref{Search Path}.
|
@end ifset
|
@end ifset
|
@c man begin ENVIRONMENT
|
@c man begin ENVIRONMENT
|
|
|
@item DEPENDENCIES_OUTPUT
|
@item DEPENDENCIES_OUTPUT
|
@cindex dependencies for make as output
|
@cindex dependencies for make as output
|
If this variable is set, its value specifies how to output
|
If this variable is set, its value specifies how to output
|
dependencies for Make based on the non-system header files processed
|
dependencies for Make based on the non-system header files processed
|
by the compiler. System header files are ignored in the dependency
|
by the compiler. System header files are ignored in the dependency
|
output.
|
output.
|
|
|
The value of @env{DEPENDENCIES_OUTPUT} can be just a file name, in
|
The value of @env{DEPENDENCIES_OUTPUT} can be just a file name, in
|
which case the Make rules are written to that file, guessing the target
|
which case the Make rules are written to that file, guessing the target
|
name from the source file name. Or the value can have the form
|
name from the source file name. Or the value can have the form
|
@samp{@var{file} @var{target}}, in which case the rules are written to
|
@samp{@var{file} @var{target}}, in which case the rules are written to
|
file @var{file} using @var{target} as the target name.
|
file @var{file} using @var{target} as the target name.
|
|
|
In other words, this environment variable is equivalent to combining
|
In other words, this environment variable is equivalent to combining
|
the options @option{-MM} and @option{-MF}
|
the options @option{-MM} and @option{-MF}
|
@ifset cppmanual
|
@ifset cppmanual
|
(@pxref{Invocation}),
|
(@pxref{Invocation}),
|
@end ifset
|
@end ifset
|
@ifclear cppmanual
|
@ifclear cppmanual
|
(@pxref{Preprocessor Options}),
|
(@pxref{Preprocessor Options}),
|
@end ifclear
|
@end ifclear
|
with an optional @option{-MT} switch too.
|
with an optional @option{-MT} switch too.
|
|
|
@item SUNPRO_DEPENDENCIES
|
@item SUNPRO_DEPENDENCIES
|
@cindex dependencies for make as output
|
@cindex dependencies for make as output
|
This variable is the same as @env{DEPENDENCIES_OUTPUT} (see above),
|
This variable is the same as @env{DEPENDENCIES_OUTPUT} (see above),
|
except that system header files are not ignored, so it implies
|
except that system header files are not ignored, so it implies
|
@option{-M} rather than @option{-MM}. However, the dependence on the
|
@option{-M} rather than @option{-MM}. However, the dependence on the
|
main input file is omitted.
|
main input file is omitted.
|
@ifset cppmanual
|
@ifset cppmanual
|
@xref{Invocation}.
|
@xref{Invocation}.
|
@end ifset
|
@end ifset
|
@ifclear cppmanual
|
@ifclear cppmanual
|
@xref{Preprocessor Options}.
|
@xref{Preprocessor Options}.
|
@end ifclear
|
@end ifclear
|
@end vtable
|
@end vtable
|
|
|
