clisp: Add optional patch, add title of dependencies, explain more configure options. I note that this adds extra spaces after the package names in the libsigsegv/libffcall explanations, maybe we should move from xml to rst <joke/>.

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@18942 af4574ff-66df-0310-9fd7-8a98e5e911e0

general/prog/clisp.xml

@@ -70,6 +70,16 @@
       </listitem>
     </itemizedlist>
 
+    <bridgehead renderas="sect3">Additional Downloads</bridgehead>
+    <itemizedlist spacing='compact'>
+      <listitem>
+        <para>Optional patch: <ulink
+          url="&patch-root;/clisp-&clisp-version;-readline7_fixes-1.patch"/>
+          (required if building against libffcall)</para>
+      </listitem>
+    </itemizedlist>
+
+    <bridgehead renderas="sect3">Clisp Dependencies</bridgehead>
     <bridgehead renderas="sect4">Recommended</bridgehead>
     <para role="recommended">
       <xref linkend="libsigsegv"/>
@@ -105,6 +115,19 @@
       commands:
     </para>
 
+    <para>
+      If you are building <package>clisp</package> against
+      <package>libffcall</package>, apply the patch to fix a build failure
+      with current <package>readline</package>:
+    </para>
+
+    <para>
+      Install <application>Clisp</application> by running the following
+      commands:
+    </para>
+
+<screen><userinput>patch -Np1 -i ../fuse-3.1.0-upstream_fix-1.patch</userinput></screen>
+
 <screen><userinput>mkdir build &amp;&amp;
 cd    build &amp;&amp;
 
@@ -131,10 +154,31 @@ make -j1</userinput></screen>
     <title>Command Explanations</title>
 
     <para>
-      <command>uimit -s 16384</command>: this increases the maximum stack
+      <command>ulimit -s 16384</command>: this increases the maximum stack
       size, as recommended by the <command>configure</command>.
     </para>
 
+    <para>
+      <command>--docdir=/usr/share/doc/clisp-&clisp-version;</command>:
+      this ensures the html documentation will go into a versioned directory
+      instead of straight into <filename
+      class="directory">/usr/share/html/</filename>.
+    </para>
+
+    <para>
+      <command>--with-libsigsegv-prefix=/usr</command>: use this to tell
+      <command>configure</command> that you have installed
+      <package>libsigsegv</package> in /usr, otherwise it will not be
+      found.
+    </para>
+
+    <para>
+      <option>--with-libffcall-prefix=/usr</option>: use this to tell
+      <command>configure</command> that you have installed the optional
+      <package>libffcall</package> in /usr, otherwise like
+      <package>libsigsegv</package> it will not be found.
+    </para>
+
   </sect2>
 
   <sect2 role="content">

introduction/welcome/changelog.xml

@@ -44,6 +44,11 @@
     <listitem>
       <para>July 14th, 2017</para>
       <itemizedlist>
+       <listitem>
+          <para>[ken] - Add optional patch for clisp, required if
+          building it against libffcall. Fixes
+          <ulink url="&blfs-ticket-root;9474">#9474</ulink>.</para>
+       </listitem>
        <listitem>
          <para>[bdubbs] - Update to mariadb-10.2.7. Fixes
          <ulink url="&blfs-ticket-root;9478">#9478</ulink>.</para>