diff --git a/gcc/ChangeLog b/gcc/ChangeLog index 642ae649d98..c0c883874a6 100644 --- a/gcc/ChangeLog +++ b/gcc/ChangeLog @@ -1,3 +1,10 @@ +2007-01-09 Carlos O'Donell + + * doc/tm.texi: Update documentation to reflect reality of exec + and start file search behaviours. Update copyright year. + * doc/invoke.texi: Explain how GCC_EXEC_PREFIX is used to find + header file directories. + 2007-01-09 Uros Bizjak * config/i386/i386.md (*sinxf2): Rename to *sinxf2_i387. diff --git a/gcc/doc/invoke.texi b/gcc/doc/invoke.texi index b9b52dd7cd9..5d4a0abc0ed 100644 --- a/gcc/doc/invoke.texi +++ b/gcc/doc/invoke.texi @@ -13947,7 +13947,8 @@ If GCC cannot find the subprogram using the specified prefix, it tries looking in the usual places for the subprogram. The default value of @env{GCC_EXEC_PREFIX} is -@file{@var{prefix}/lib/gcc/} where @var{prefix} is the value +@file{@var{prefix}/lib/gcc/} where @var{prefix} is the prefix to +the installed compiler. In many cases @var{prefix} is the value of @code{prefix} when you ran the @file{configure} script. Other prefixes specified with @option{-B} take precedence over this prefix. @@ -13963,7 +13964,9 @@ replacing that beginning with the specified prefix to produce an alternate directory name. Thus, with @option{-Bfoo/}, GCC will search @file{foo/bar} where it would normally search @file{/usr/local/lib/bar}. These alternate directories are searched first; the standard directories -come next. +come next. If a standard directory begins with the configured +@var{prefix} then the value of @var{prefix} is replaced by +@env{GCC_EXEC_PREFIX} when looking for header files. @item COMPILER_PATH @findex COMPILER_PATH diff --git a/gcc/doc/tm.texi b/gcc/doc/tm.texi index 9e8ad0e99df..dcf7e02cef2 100644 --- a/gcc/doc/tm.texi +++ b/gcc/doc/tm.texi @@ -1,5 +1,5 @@ @c Copyright (C) 1988,1989,1992,1993,1994,1995,1996,1997,1998,1999,2000,2001, -@c 2002, 2003, 2004, 2005, 2006 Free Software Foundation, Inc. +@c 2002, 2003, 2004, 2005, 2006, 2007 Free Software Foundation, Inc. @c This is part of the GCC manual. @c For copying conditions, see the file gcc.texi. @@ -615,19 +615,26 @@ Here is the order of prefixes tried for exec files: Any prefixes specified by the user with @option{-B}. @item -The environment variable @code{GCC_EXEC_PREFIX}, if any. +The environment variable @code{GCC_EXEC_PREFIX} or, if @code{GCC_EXEC_PREFIX} +is not set and the compiler has not been installed in the configure-time +@var{prefix}, the location in which the compiler has actually been installed. @item The directories specified by the environment variable @code{COMPILER_PATH}. @item -The macro @code{STANDARD_EXEC_PREFIX}. +The macro @code{STANDARD_EXEC_PREFIX}, if the compiler has been installed +in the configured-time @var{prefix}. @item -@file{/usr/lib/gcc/}. +The location @file{/usr/libexec/gcc/}, but only if this is a native compiler. @item -The macro @code{MD_EXEC_PREFIX}, if any. +The location @file{/usr/lib/gcc/}, but only if this is a native compiler. + +@item +The macro @code{MD_EXEC_PREFIX}, if defined, but only if this is a native +compiler. @end enumerate Here is the order of prefixes tried for startfiles: @@ -637,31 +644,45 @@ Here is the order of prefixes tried for startfiles: Any prefixes specified by the user with @option{-B}. @item -The environment variable @code{GCC_EXEC_PREFIX}, if any. +The environment variable @code{GCC_EXEC_PREFIX} or its automatically determined +value based on the installed toolchain location. @item The directories specified by the environment variable @code{LIBRARY_PATH} (or port-specific name; native only, cross compilers do not use this). @item -The macro @code{STANDARD_EXEC_PREFIX}. +The macro @code{STANDARD_EXEC_PREFIX}, but only if the toolchain is installed +in the configured @var{prefix} or this is a native compiler. @item -@file{/usr/lib/gcc/}. +The location @file{/usr/lib/gcc/}, but only if this is a native compiler. @item -The macro @code{MD_EXEC_PREFIX}, if any. +The macro @code{MD_EXEC_PREFIX}, if defined, but only if this is a native +compiler. @item -The macro @code{MD_STARTFILE_PREFIX}, if any. +The macro @code{MD_STARTFILE_PREFIX}, if defined, but only if this is a +native compiler, or we have a target system root. @item -The macro @code{STANDARD_STARTFILE_PREFIX}. +The macro @code{MD_STARTFILE_PREFIX_1}, if defined, but only if this is a +native compiler, or we have a target system root. @item +The macro @code{STANDARD_STARTFILE_PREFIX}, with any sysroot modifications. +If this path is relative it will be prefixed by @code{GCC_EXEC_PREFIX} and +the machine suffix or @code{STANDARD_EXEC_PREFIX} and the machine suffix. + +@item +The macro @code{STANDARD_STARTFILE_PREFIX_1}, but only if this is a native +compiler, or we have a target system root. The default for this macro is @file{/lib/}. @item +The macro @code{STANDARD_STARTFILE_PREFIX_2}, but only if this is a native +compiler, or we have a target system root. The default for this macro is @file{/usr/lib/}. @end enumerate