Changeset 174d1bf

Timestamp:

02/15/2022 07:29:35 AM (2 years ago)

Author:

Xi Ruoyao <xry111@…>

Branches:

11.1, 11.1-rc1, 11.2, 11.2-rc1, 11.3, 11.3-rc1, 12.0, 12.0-rc1, 12.1, 12.1-rc1, arm, bdubbs/gcc13, multilib, renodr/libudev-from-systemd, s6-init, trunk, xry111/arm64, xry111/arm64-12.0, xry111/clfs-ng, xry111/lfs-next, xry111/loongarch, xry111/loongarch-12.0, xry111/loongarch-12.1, xry111/mips64el, xry111/pip3, xry111/rust-wip-20221008, xry111/update-glibc

Children:

2cf3c176

Parents:

81d3242

Message:

libstdc++ pass 1: rephrase the explanation for --with-gxx-include-dir

I just received a private mail from some guy obviously puzzled by this
switch. Expand the explanation a little to make it more clear.

File:

• chapter05/libstdc++.xml (modified) (1 diff)

chapter05/libstdc++.xml

@@ -93 +93 @@
         <term><parameter>--with-gxx-include-dir=/tools/$LFS_TGT/include/c++/&gcc-version;</parameter></term>
         <listitem>
-          <para>This is the location where the C++ compiler should search for the
-          standard include files. In a normal build, this information
+          <para>This specifies the installation directory for include files.
+          Because libstdc++ is the standard C++ library for LFS, this
+          directory should match the location where the C++ compiler
+          (<command>$LFS_TGT-g++</command>) would search for the
+          standard C++ include files. In a normal build, this information
           is automatically passed to the libstdc++ <command>configure</command>
           options from the top level directory. In our case, this information
-          must be explicitly given.</para>
+          must be explicitly given.
+          The C++ compiler will prepend the sysroot path
+          <filename class="directory">$LFS</filename> (specified building
+          GCC pass 1) to the include file search path, so it will actually
+          search in
+          <filename class="directory">$LFS/tools/$LFS_TGT/include/c++/&gcc-version;</filename>.  The combination of the <parameter>DESTDIR</parameter>
+          variable (in the <command>make install</command> command below)
+          and this switch ensures to install the headers there.</para>
         </listitem>
       </varlistentry>