X-Git-Url: https://oss.titaniummirror.com/gitweb/?a=blobdiff_plain;f=gcc%2Fdoc%2Fcppenv.texi;h=bb29cb2d1407d2f196cb55c94405d89c6ca39506;hb=6fed43773c9b0ce596dca5686f37ac3fc0fa11c0;hp=d60f7eef84cdb21d9e0a57069cc2d170daa94f55;hpb=27b11d56b743098deb193d510b337ba22dc52e5c;p=msp430-gcc.git diff --git a/gcc/doc/cppenv.texi b/gcc/doc/cppenv.texi index d60f7eef..bb29cb2d 100644 --- a/gcc/doc/cppenv.texi +++ b/gcc/doc/cppenv.texi @@ -1,4 +1,4 @@ -@c Copyright (c) 1999, 2000, 2001, 2002 +@c Copyright (c) 1999, 2000, 2001, 2002, 2004 @c Free Software Foundation, Inc. @c This is part of the CPP and GCC manuals. @c For copying conditions, see the file gcc.texi. @@ -10,7 +10,7 @@ @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. -@ftable @env +@vtable @env @item CPATH @itemx C_INCLUDE_PATH @itemx CPLUS_INCLUDE_PATH @@ -20,12 +20,12 @@ 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. The special character, @code{PATH_SEPARATOR}, is target-dependent and -determined at GCC build time. For 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. @env{CPATH} specifies a list of directories to be searched as if specified with @option{-I}, but after any paths given with @option{-I} -options on the command line. The environment variable is used +options on the command line. This environment variable is used regardless of which language is being preprocessed. The remaining environment variables apply only when preprocessing the @@ -33,12 +33,19 @@ particular language indicated. Each specifies a list of directories to be searched as if specified with @option{-isystem}, but after any paths given with @option{-isystem} options on the command line. +In all these variables, an empty element instructs the compiler to +search its current working directory. Empty elements can appear at the +beginning or end of a path. For instance, if the value of +@env{CPATH} is @code{:/special/include}, that has the same +effect as @samp{@w{-I. -I/special/include}}. + +@c man end @ifset cppmanual See also @ref{Search Path}. @end ifset +@c man begin ENVIRONMENT @item DEPENDENCIES_OUTPUT -@anchor{DEPENDENCIES_OUTPUT} @cindex dependencies for make as output If this variable is set, its value specifies how to output dependencies for Make based on the non-system header files processed @@ -63,15 +70,14 @@ with an optional @option{-MT} switch too. @item SUNPRO_DEPENDENCIES @cindex dependencies for make as output -This variable is the same as the environment variable -@env{DEPENDENCIES_OUTPUT} (@pxref{DEPENDENCIES_OUTPUT}), except that -system header files are not ignored, so it implies @option{-M} rather -than @option{-MM}. However, the dependence on the main input file is -omitted. +This variable is the same as @env{DEPENDENCIES_OUTPUT} (see above), +except that system header files are not ignored, so it implies +@option{-M} rather than @option{-MM}. However, the dependence on the +main input file is omitted. @ifset cppmanual @xref{Invocation}. @end ifset @ifclear cppmanual @xref{Preprocessor Options}. @end ifclear -@end ftable +@end vtable