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