This is the mail archive of the
gcc-patches@gcc.gnu.org
mailing list for the GCC project.
[patch, docs] Document --enable-stage1-langauges configure option.
- From: Brooks Moses <brooks dot moses at codesourcery dot com>
- To: gcc-patches at gcc dot gnu dot org
- Cc: Paolo Bonzini <paolo dot bonzini at lu dot unisi dot ch>
- Date: Sun, 11 Mar 2007 21:57:25 -0700
- Subject: [patch, docs] Document --enable-stage1-langauges configure option.
This is a revised version of the patch I proposed six weeks ago, which
takes into account Paolo Bonzini's suggestions on the content. (Sorry
for taking so long to follow up on this, Paolo!)
Tested with "make pdf" and "make info" on i686-pc-linux-gnu. Ok for trunk?
------------------------------------------------------------------
2007-03-11 Brooks Moses <brooks.moses@codesourcery.com>
PR 30635
* doc/install.texi: Document --enable-stage1-languages
------------------------------------------------------------------
- Brooks
Index: install.texi
===================================================================
--- install.texi (revision 122674)
+++ install.texi (working copy)
@@ -1136,6 +1136,21 @@
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