Imported gcc-4.4.3

[msp430-gcc.git] / gcc / doc / cppenv.texi

diff --git a/gcc/doc/cppenv.texi b/gcc/doc/cppenv.texi
index d60f7eef84cdb21d9e0a57069cc2d170daa94f55..bb29cb2d1407d2f196cb55c94405d89c6ca39506 100644 (file)
--- 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