summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authoraoliva <aoliva@138bc75d-0d04-0410-961f-82ee72b054a4>2003-01-28 23:15:16 +0000
committeraoliva <aoliva@138bc75d-0d04-0410-961f-82ee72b054a4>2003-01-28 23:15:16 +0000
commitedf1be12a76cd03afbcf6c53f4377fe1bfb932ec (patch)
treea997314097ea9baf1face89cc7d7379487861b78
parent3102e37dcc58688f1d44e0ff0e61105a4354c0a7 (diff)
downloadppe42-gcc-edf1be12a76cd03afbcf6c53f4377fe1bfb932ec.tar.gz
ppe42-gcc-edf1be12a76cd03afbcf6c53f4377fe1bfb932ec.zip
* doc/install.texi: Add documentation for installation into
tooldirs and with DESTDIR. git-svn-id: svn+ssh://gcc.gnu.org/svn/gcc/trunk@62044 138bc75d-0d04-0410-961f-82ee72b054a4
-rw-r--r--gcc/ChangeLog5
-rw-r--r--gcc/doc/install.texi28
2 files changed, 33 insertions, 0 deletions
diff --git a/gcc/ChangeLog b/gcc/ChangeLog
index fdccdbbcfe4..49754d025f9 100644
--- a/gcc/ChangeLog
+++ b/gcc/ChangeLog
@@ -1,3 +1,8 @@
+2003-01-28 Christian Cornelssen <ccorn@cs.tu-berlin.de>
+
+ * doc/install.texi: Add documentation for installation into
+ tooldirs and with DESTDIR.
+
2003-01-28 Richard Henderson <rth@redhat.com>
* config.gcc (ia64*-*-aix*): Remove.
diff --git a/gcc/doc/install.texi b/gcc/doc/install.texi
index 1b0f258529b..185562789fc 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}.
OpenPOWER on IntegriCloud