Changeset 0c0bf1f

Timestamp:

06/16/2023 03:57:50 PM (12 months ago)

Author:

Xi Ruoyao <xry111@…>

Branches:

12.0, 12.1, kea, ken/TL2024, ken/tuningfonts, lazarus, lxqt, plabs/newcss, python3.11, rahul/power-profiles-daemon, renodr/vulkan-addition, trunk, xry111/llvm18, xry111/xf86-video-removal

Children:

677cf19b

Parents:

fa47dacd

git-author:

Xi Ruoyao <xry111@…> (06/16/2023 03:52:12 PM)

git-committer:

Xi Ruoyao <xry111@…> (06/16/2023 03:57:50 PM)

Message:

gcc: Reword description for --enable-languages

jit needs --enable-host-shared which slows down GCC, so separate
--enable-host-shared --enable-languages=jit out.

File:

• general/prog/gcc.xml (modified) (2 diffs)

general/prog/gcc.xml

@@ -302 +302 @@
       <parameter>--enable-languages=c,c++,fortran,go,objc,obj-c++,m2</parameter>:
       This command identifies which languages to build. You may modify
-      this command to remove undesired languages. Other languages can be
-      added, including Ada, D,
-      and JIT (add <parameter>jit</parameter> to the list of enabled
-      languages), a library which can be linked into interpreters that want to
-      generate machine code <quote>on the fly</quote> at run-time. They have not
-      been tested by the BLFS developers.
+      this command to remove undesired languages.  GCC also supports Ada
+      and D, but building GCC with Ada (or D) support needs an existing
+      Ada (or D) compiler.  So they are not enabled here.
     </para>
 
@@ -342 +339 @@
       its content) will be incorrect. This command changes the ownership to the
       <systemitem class="username">root</systemitem> user and group.
+    </para>
+
+    <para>
+      <option>--enable-host-shared --enable-languages=jit</option>:
+      Build <systemitem class="library">libgccjit</systemitem>, a library
+      for embedding GCC inside programs and libraries for generating machine
+      code.  Despite <quote>JIT</quote> (just-in-time) in the name, the
+      library can be used for AOT (ahead-of-time) compilation as well.
+      <option>--enable-host-shared</option> is needed for building
+      <systemitem class="library">libgccjit</systemitem>, but it
+      significantly slows down GCC.  So
+      <systemitem class="library">libgccjit</systemitem> should be built and
+      installed separately, not as a part of the <quote>main</quote> GCC
+      installation.  If you need this library, configure GCC with
+      these two options and install the library by running
+      <!-- from Arch, not tested -->
+      <command>make -C gcc jit.install-common jit.install-info</command>
+      as the &root; user.  This library is not used by any BLFS package,
+      nor tested by the BLFS developers.
     </para>