tm.texi: Update documentation to reflect reality of exec and start file search behaviours.

gcc/

2007-01-09  Carlos O'Donell  <carlos@codesourcery.com>

	* 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.

From-SVN: r120622
This commit is contained in:
Carlos O'Donell 2007-01-09 21:08:19 +00:00 committed by Carlos O'Donell
parent 97b8365caf
commit fe037b8a3d
3 changed files with 44 additions and 13 deletions

View File

@ -1,3 +1,10 @@
2007-01-09 Carlos O'Donell <carlos@codesourcery.com>
* 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 <ubizjak@gmail.com> 2007-01-09 Uros Bizjak <ubizjak@gmail.com>
* config/i386/i386.md (*sinxf2): Rename to *sinxf2_i387. * config/i386/i386.md (*sinxf2): Rename to *sinxf2_i387.

View File

@ -13947,7 +13947,8 @@ If GCC cannot find the subprogram using the specified prefix, it
tries looking in the usual places for the subprogram. tries looking in the usual places for the subprogram.
The default value of @env{GCC_EXEC_PREFIX} is 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. of @code{prefix} when you ran the @file{configure} script.
Other prefixes specified with @option{-B} take precedence over this prefix. 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 alternate directory name. Thus, with @option{-Bfoo/}, GCC will search
@file{foo/bar} where it would normally search @file{/usr/local/lib/bar}. @file{foo/bar} where it would normally search @file{/usr/local/lib/bar}.
These alternate directories are searched first; the standard directories 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 @item COMPILER_PATH
@findex COMPILER_PATH @findex COMPILER_PATH

View File

@ -1,5 +1,5 @@
@c Copyright (C) 1988,1989,1992,1993,1994,1995,1996,1997,1998,1999,2000,2001, @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 This is part of the GCC manual.
@c For copying conditions, see the file gcc.texi. @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}. Any prefixes specified by the user with @option{-B}.
@item @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 @item
The directories specified by the environment variable @code{COMPILER_PATH}. The directories specified by the environment variable @code{COMPILER_PATH}.
@item @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 @item
@file{/usr/lib/gcc/}. The location @file{/usr/libexec/gcc/}, but only if this is a native compiler.
@item @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 @end enumerate
Here is the order of prefixes tried for startfiles: 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}. Any prefixes specified by the user with @option{-B}.
@item @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 @item
The directories specified by the environment variable @code{LIBRARY_PATH} The directories specified by the environment variable @code{LIBRARY_PATH}
(or port-specific name; native only, cross compilers do not use this). (or port-specific name; native only, cross compilers do not use this).
@item @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 @item
@file{/usr/lib/gcc/}. The location @file{/usr/lib/gcc/}, but only if this is a native compiler.
@item @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 @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 @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 @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/}. @file{/lib/}.
@item @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/}. @file{/usr/lib/}.
@end enumerate @end enumerate