[lfs] branch trunk updated: gcc: Fix the rationale not to enable more languages

This is an automated email from the git hooks/post-receive script.

git pushed a commit to branch trunk
in repository lfs.

The following commit(s) were added to refs/heads/trunk by this push:
     new 0e167aaad gcc: Fix the rationale not to enable more languages
0e167aaad is described below

commit 0e167aaad9fc090adc9a0eb5471887dd161fd272
Author: Xi Ruoyao <[email protected]>
AuthorDate: Fri Sep 5 11:24:16 2025 +0800

    gcc: Fix the rationale not to enable more languages
    
    The prior rationale ("missing dependencies") is just wrong and it is
    confusing people in a heated discussion.  No matter how the discussion
    will conclude, we should provide the correct information anyway.
    
    Also document the --disable-bootstrap option that we'd not documented
    elsewhere.
    
    Now technically we may remove the BLFS GCC page as all its info is
    already here, but doing so would be highly debatable.
---
 chapter08/gcc.xml | 34 ++++++++++++++++++++++++++++++----
 1 file changed, 30 insertions(+), 4 deletions(-)

diff --git a/chapter08/gcc.xml b/chapter08/gcc.xml
index da439145d..bbf384ec1 100644
--- a/chapter08/gcc.xml
+++ b/chapter08/gcc.xml
@@ -69,10 +69,20 @@ cd       build</userinput></screen>
              --disable-fixincludes    \
              --with-system-zlib</userinput></screen>
 
-    <para>GCC supports seven different computer languages, but the
-    prerequisites for most of them have not yet been installed. See the
-    <ulink url="&blfs-book;general/gcc.html">BLFS Book GCC page</ulink>
-    for instructions on how to build all of GCC's supported languages.</para>
+    <para>We only enable C and C++ here to save the build time as no
+    packages in LFS and BLFS require GCC to compile other languages. Append
+    <literal>cobol</literal> for Cobol (note that it will cause GCC fail
+    to build on a 32-bit LFS system),
+    <literal>fortran</literal> for Fortran,
+    <literal>go</literal> for Go,
+    <literal>objc</literal> for Objective C,
+    <literal>obj-c++</literal> for Objective C++, and/or
+    <literal>m2</literal> for Modula 2 into the value of
+    <parameter>--enable-languages</parameter> option if you want to compile
+    programs in one or more of those languages with GCC.  The support for
+    Ada or D cannot be enabled here because its compiler in GCC is written
+    in Ada or D itself and it can only be built with an existing Ada or D
+    compiler installation.</para>
 
     <variablelist>
       <title>The meaning of the new configure parameters:</title>
@@ -86,6 +96,22 @@ cd       build</userinput></screen>
         </listitem>
       </varlistentry>
 
+      <varlistentry>
+        <term><parameter>--disable-bootstrap</parameter></term>
+        <listitem>
+          <para>By default, the build system of GCC will bootstrap it in
+          3 stages unless it's built as a cross-compiler or it is being
+          cross-compiled.  The bootstrap process is needed for robustness,
+          especially when upgrading GCC to a new version.  In LFS we are
+          using a different method to bootstrap GCC (as we introduced in
+          <xref linkend='ch-tools-toolchaintechnotes'/>), so here we don't
+          need the bootstrap process provided by the build system and we
+          disable it to significantly reduce the build time.  Remove this
+          option when you upgrade GCC on a complete LFS system (instead of
+          building LFS).</para>
+        </listitem>
+      </varlistentry>
+
       <varlistentry>
         <term><parameter>--disable-fixincludes</parameter></term>
         <listitem>

-- 
To stop receiving notification emails like this one, please contact
the administrator of this repository.

-- 
http://lists.linuxfromscratch.org/sympa/info/lfs-book
Unsubscribe: See the above information page