gcc/doc/headerdirs.texi

   1 @c Copyright (C) 1988, 1989, 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999, 2000, 2001 Free Software Foundation, Inc.
   2 @c This is part of the GCC manual.
   3 @c For copying conditions, see the file gcc.texi.
   4
   5 @node Header Dirs
   6 @chapter Standard Header File Directories
   7
   8 @code{GCC_INCLUDE_DIR} means the same thing for native and cross.  It is
   9 where GNU CC stores its private include files, and also where GNU CC
  10 stores the fixed include files.  A cross compiled GNU CC runs
  11 @code{fixincludes} on the header files in @file{$(tooldir)/include}.
  12 (If the cross compilation header files need to be fixed, they must be
  13 installed before GNU CC is built.  If the cross compilation header files
  14 are already suitable for ISO C and GNU CC, nothing special need be
  15 done).
  16
  17 @code{GPLUSPLUS_INCLUDE_DIR} means the same thing for native and cross.  It
  18 is where @command{g++} looks first for header files.  The C++ library
  19 installs only target independent header files in that directory.
  20
  21 @code{LOCAL_INCLUDE_DIR} is used only by native compilers.  GNU CC
  22 doesn't install anything there.  It is normally
  23 @file{/usr/local/include}.  This is where local additions to a packaged
  24 system should place header files.
  25
  26 @code{CROSS_INCLUDE_DIR} is used only by cross compilers.  GNU CC
  27 doesn't install anything there.
  28
  29 @code{TOOL_INCLUDE_DIR} is used for both native and cross compilers.  It
  30 is the place for other packages to install header files that GNU CC will
  31 use.  For a cross-compiler, this is the equivalent of
  32 @file{/usr/include}.  When you build a cross-compiler,
  33 @code{fixincludes} processes any header files in this directory.