aboutsummaryrefslogtreecommitdiff
path: root/gcc/doc
diff options
context:
space:
mode:
authorPaolo Bonzini <bonzini@gnu.org>2006-06-01 12:28:11 +0000
committerPaolo Bonzini <bonzini@gcc.gnu.org>2006-06-01 12:28:11 +0000
commitf5c3bb4bf0fd0fb39cdfa948dc2a62a3b9d2c9bd (patch)
treecc95ffef214e57365d11675fa098dd90a6537c72 /gcc/doc
parent028098486c768c0f666bf4daa03cf8adfe230599 (diff)
downloadgcc-f5c3bb4bf0fd0fb39cdfa948dc2a62a3b9d2c9bd.zip
gcc-f5c3bb4bf0fd0fb39cdfa948dc2a62a3b9d2c9bd.tar.gz
gcc-f5c3bb4bf0fd0fb39cdfa948dc2a62a3b9d2c9bd.tar.bz2
re PR bootstrap/25453 (--disable-bootstrap is not documented)
2006-06-01 Paolo Bonzini <bonzini@gnu.org> PR 25453 * doc/install.texi: Document --enable-bootstrap and --disable-bootstrap. From-SVN: r114305
Diffstat (limited to 'gcc/doc')
-rw-r--r--gcc/doc/install.texi27
1 files changed, 23 insertions, 4 deletions
diff --git a/gcc/doc/install.texi b/gcc/doc/install.texi
index 0494f28..dae27c4 100644
--- a/gcc/doc/install.texi
+++ b/gcc/doc/install.texi
@@ -1052,6 +1052,20 @@ catalog, configuring with @option{--enable-maintainer-mode} will enable
this. Note that you need a recent version of the @code{gettext} tools
to do so.
+@item --disable-bootstrap
+For a native build, the default configuration is to perform
+a 3-stage bootstrap of the compiler when @samp{make} is invoked,
+testing that GCC can compile itself correctly. If you want to disable
+this process, you can configure with @option{--disable-bootstrap}.
+
+@item --enable-bootstrap
+In special cases, you may want to perform a 3-stage build
+even if the target and host triplets are different.
+This could happen when the host can run code compiled for
+the target (e.g.@: host is i686-linux, target is i486-linux).
+Starting from GCC 4.2, to do this you have to configure explicitly
+with @option{--enable-bootstrap}.
+
@item --enable-generated-files-in-srcdir
Neither the .c and .h files that are generated from Bison and flex nor the
info manuals and man pages that are built from the .texi files are present
@@ -1571,10 +1585,15 @@ documentation pre-built for the unmodified documentation in the release.
@section Building a native compiler
-For a native build, the command @samp{make} will trigger a 3-stage
-bootstrap of the compiler. This will build the entire GCC system
-and ensure that it compiles itself correctly, by doing the
-following steps:
+For a native build, the default configuration is to perform
+a 3-stage bootstrap of the compiler when @samp{make} is invoked.
+This will build the entire GCC system and ensure that it compiles
+itself correctly. It can be disabled with the @option{--disable-bootstrap}
+parameter to @samp{configure}, but bootstrapping is suggested because
+the compiler will be tested more completely and could also have
+better performance.
+
+The bootstrapping process will complete the following steps:
@itemize @bullet
@item