From 53b50ac1373a94e49ce47b7e355caec0a7bb670e Mon Sep 17 00:00:00 2001 From: Christian Cornelssen Date: Wed, 29 Jan 2003 00:15:16 +0100 Subject: [PATCH] install.texi: Add documentation for installation into tooldirs and with DESTDIR. * doc/install.texi: Add documentation for installation into tooldirs and with DESTDIR. From-SVN: r62044 --- gcc/ChangeLog | 5 +++++ gcc/doc/install.texi | 28 ++++++++++++++++++++++++++++ 2 files changed, 33 insertions(+) diff --git a/gcc/ChangeLog b/gcc/ChangeLog index fdccdbbcfe48..49754d025f91 100644 --- a/gcc/ChangeLog +++ b/gcc/ChangeLog @@ -1,3 +1,8 @@ +2003-01-28 Christian Cornelssen + + * doc/install.texi: Add documentation for installation into + tooldirs and with DESTDIR. + 2003-01-28 Richard Henderson * config.gcc (ia64*-*-aix*): Remove. diff --git a/gcc/doc/install.texi b/gcc/doc/install.texi index 1b0f258529bc..185562789fc5 100644 --- a/gcc/doc/install.texi +++ b/gcc/doc/install.texi @@ -1405,6 +1405,34 @@ in @file{@var{libdir}} (normally @file{@var{prefix}/lib}); internal parts of the compiler in @file{@var{libdir}/gcc-lib}; documentation in info format in @file{@var{infodir}} (normally @file{@var{prefix}/info}). +When installing cross-compilers, GCC's executables +are not only installed into @file{@var{bindir}}, that +is, @file{@var{exec-prefix}/bin}, but additionally into +@file{@var{exec-prefix}/@var{target-alias}/bin}, if that directory +exists. Typically, such @dfn{tooldirs} hold target-specific +binutils, including assembler and linker. + +Installation into a temporary staging area or into a @command{chroot} +jail can be achieved with the command + +@example +make DESTDIR=@var{path-to-rootdir} install +@end example + +@noindent where @var{path-to-rootdir} is the absolute path of +a directory relative to which all installation paths will be +interpreted. Note that the directory specified by @code{DESTDIR} +need not exist yet; it will be created if necessary. + +There is a subtle point with tooldirs and @code{DESTDIR}: +If you relocate a cross-compiler installation with +e.g.@: @samp{DESTDIR=@var{rootdir}}, then the directory +@file{@var{rootdir}/@var{exec-prefix}/@var{target-alias}/bin} will +be filled with duplicated GCC executables only if it already exists, +it will not be created otherwise. This is regarded as a feature, +not as a bug, because it gives slightly more control to the packagers +using the @code{DESTDIR} feature. + If you built a released version of GCC using @samp{make bootstrap} then please quickly review the build status page for your release, available from @uref{http://gcc.gnu.org/buildstat.html}. -- 2.43.5