Changeset e9c46b3

Timestamp:

12/07/2022 05:10:58 PM (17 months ago)

Author:

David Bryant <davidbryant@…>

Branches:

11.3, 11.3-rc1, 12.0, 12.0-rc1, 12.1, 12.1-rc1, bdubbs/gcc13, multilib, renodr/libudev-from-systemd, trunk, xry111/arm64, xry111/arm64-12.0, xry111/clfs-ng, xry111/loongarch, xry111/loongarch-12.0, xry111/loongarch-12.1, xry111/mips64el, xry111/update-glibc

Children:

8e751f7

Parents:

8f10e6fa

Message:

Add more details to the descriptiion of what this package does.
Correct capitalizatiom throughout, and tweak English idiom.

File:

• chapter08/libffi.xml (modified) (6 diffs)

chapter08/libffi.xml

@@ -27 +27 @@
     interface to various calling conventions. This allows a programmer to call
     any function specified by a call interface description at run time.</para>
+  
+    <para>FFI stands for Foreign Function Interface. An FFI allows a program written
+    in one language to call a program written in another language. Specifically,
+    Libffi can provide a bridge between an interpreter like Perl, or Python, and
+    shared library subroutines written in C, or C++.</para>
 
     <segmentedlist>
@@ -44 +49 @@
 
     <note>
-      <para>Similar to GMP, libffi builds with optimizations specific
+      <para>Like GMP, Libffi builds with optimizations specific
       to the processor in use. If building for another system, change the
       value of the <parameter>--with-gcc-arch=</parameter> parameter in the
@@ -53 +58 @@
     </note>
 
-    <para>Prepare libffi for compilation:</para>
+    <para>Prepare Libffi for compilation:</para>
 
     <screen><userinput remap="configure">./configure --prefix=/usr          \
@@ -68 +73 @@
           <para>Ensure GCC optimizes for the current system.  If this
           is not specified, the system is guessed and the code generated
-          may not be correct for some systems.  If the generated code
+          may not be correct.  If the generated code
           will be copied from the native system to a less capable
           system, use the less capable system as a parameter. For details
@@ -81 +86 @@
         <term><parameter>--disable-exec-static-tramp</parameter></term>
         <listitem>
-          <para>Disable static trampoline support.  It's a new security
-          feature in libffi, but some BLFS packages (notably
+          <para>Disable static trampoline support, a new security
+          feature in Libffi. Some BLFS packages (notably
           <application>GJS</application>) have not been adapted for it.</para>
         </listitem>
@@ -122 +127 @@
         <term><filename class="libraryfile">libffi</filename></term>
         <listitem>
-          <para>contains the foreign function interface API functions</para>
+          <para>Contains the foreign function interface API functions</para>
           <indexterm zone="ch-system-libffi">
             <primary sortas="c-libffi">libffi</primary>