PR 30635

* doc/install.texi: Document --enable-stage1-languages

git-svn-id: svn+ssh://gcc.gnu.org/svn/gcc/trunk@122861 138bc75d-0d04-0410-961f-82ee72b054a4

diff --git a/gcc/ChangeLog b/gcc/ChangeLog
index a9abd65661c95b90fc179a72a16c2f21cd24262c..85c05fbbb4a84d4b72f8da2721698eda057a53e0 100644 (file)
--- a/gcc/ChangeLog
+++ b/gcc/ChangeLog
@@ -1,3 +1,8 @@
+2007-03-12  Brooks Moses  <brooks.moses@codesourcery.com>
+
+       PR 30635
+       * doc/install.texi: Document --enable-stage1-languages
+
 2007-03-12  Steven Bosscher  <steven@gcc.gnu.org>
 
        * tree-pass.h (pass_into_cfg_layout_mode,

diff --git a/gcc/doc/install.texi b/gcc/doc/install.texi
index fa2b2657c5b3d8f0ff891780e190feb8a18fd301..569a399e72ee30dbcddd9a5a0cc7286be6a4e2f4 100644 (file)
--- a/gcc/doc/install.texi
+++ b/gcc/doc/install.texi
@@ -1136,6 +1136,21 @@ Re-defining @code{LANGUAGES} when calling @samp{make} @strong{does not}
 work anymore, as those language sub-directories might not have been
 configured!
 
+@item --enable-stage1-languages=@var{lang1},@var{lang2},@dots{}
+Specify that a particular subset of compilers and their runtime
+libraries should be built with the system C compiler during stage 1 of
+the bootstrap process, rather than only in later stages with the
+bootstrapped C compiler.  The list of valid values is the same as for
+@option{--enable-languages}, and the option @code{all} will select all
+of the languages enabled by @option{--enable-languages}.  This option is
+primarily useful for GCC development; for instance, when a development
+version of the compiler cannot bootstrap due to compiler bugs, or when
+one is debugging front ends other than the C front end.  When this
+option is used, one can then build the target libraries for the
+specified languages with the stage-1 compiler by using @command{make
+stage1-bubble all-target}, or run the testsuite on the stage-1 compiler
+for the specified languages using @command{make stage1-start check-gcc}.
+
 @item --disable-libada
 Specify that the run-time libraries and tools used by GNAT should not
 be built.  This can be useful for debugging, or for compatibility with