From 202701932087c70a86109360d87a6a3b5eaa5dd1 Mon Sep 17 00:00:00 2001
From: Randy McMurchy <randy@linuxfromscratch.org>
Date: Sat, 6 Aug 2005 04:12:57 +0000
Subject: [PATCH] Updated to S-Lang-2.0.4

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@4887 af4574ff-66df-0310-9fd7-8a98e5e911e0
---
 general.ent                        |   4 +-
 general/genlib/slang.xml           | 110 +++++++++++++++++++----------
 introduction/welcome/changelog.xml |   4 ++
 3 files changed, 80 insertions(+), 38 deletions(-)

diff --git a/general.ent b/general.ent
index 934ff861af..40b76caca9 100644
--- a/general.ent
+++ b/general.ent
@@ -1,4 +1,4 @@
-<!ENTITY day          "05">
+<!ENTITY day          "06">
 <!ENTITY month        "08">
 <!ENTITY year         "2005">
 <!ENTITY version      "svn-&year;&month;&day;">
@@ -67,7 +67,7 @@
 <!-- Chapter 8 -->
 <!ENTITY pcre-version                 "6.2">
 <!ENTITY popt-version                 "1.7">
-<!ENTITY slang-version                "1.4.9">
+<!ENTITY slang-version                "2.0.4">
 <!ENTITY fam-version                  "2.7.0">
 <!ENTITY libxml-version               "1.8.17">
 <!ENTITY libxml2-version              "2.6.20">
diff --git a/general/genlib/slang.xml b/general/genlib/slang.xml
index 1ba3daccd9..2d878ea903 100644
--- a/general/genlib/slang.xml
+++ b/general/genlib/slang.xml
@@ -4,15 +4,15 @@
   <!ENTITY % general-entities SYSTEM "../../general.ent">
   %general-entities;
 
-  <!ENTITY slang-download-http "http://gd.tuwien.ac.at/editors/davis/slang/v1.4/slang-&slang-version;.tar.bz2">
-  <!ENTITY slang-download-ftp "ftp://space.mit.edu/pub/davis/slang/v1.4/slang-&slang-version;.tar.bz2">
-  <!ENTITY slang-md5sum "4fbb1a7f1257e065ca830deefe13d350">
-  <!ENTITY slang-size "624 KB">
-  <!ENTITY slang-buildsize "10.7 MB">
-  <!ENTITY slang-time "0.2 SBU">
+  <!ENTITY slang-download-http "http://gd.tuwien.ac.at/editors/davis/slang/v2.0/slang-&slang-version;.tar.bz2">
+  <!ENTITY slang-download-ftp "ftp://space.mit.edu/pub/davis/slang/v2.0/slang-&slang-version;.tar.bz2">
+  <!ENTITY slang-md5sum "85d968e5d1ea2d79beba40d625732700">
+  <!ENTITY slang-size "1.0 MB">
+  <!ENTITY slang-buildsize "24.3 MB">
+  <!ENTITY slang-time "0.5 SBU">
 ]>
 
-<sect1 id="slang" xreflabel="slang-&slang-version;">
+<sect1 id="slang" xreflabel="S-Lang-&slang-version;">
   <?dbhtml filename="slang.html"?>
 
   <sect1info>
@@ -20,17 +20,17 @@
     <date>$Date$</date>
   </sect1info>
 
-  <title>Slang-&slang-version;</title>
+  <title>S-Lang-&slang-version;</title>
 
   <indexterm zone="slang">
-    <primary sortas="a-Slang">Slang</primary>
+    <primary sortas="a-S-Lang">S-Lang</primary>
   </indexterm>
 
   <sect2 role="package">
-    <title>Introduction to Slang</title>
+    <title>Introduction to S-Lang</title>
 
-    <para>The <application>slang</application> package contains the
-    <application>slang</application> library, which provides facilities
+    <para>The <application>S-Lang</application> package contains the
+    <application>S-Lang</application> library, which provides facilities
     such as display/screen management, keyboard input, and keymaps.</para>
 
     <bridgehead renderas="sect3">Package Information</bridgehead>
@@ -55,44 +55,62 @@
       </listitem>
     </itemizedlist>
 
+    <bridgehead renderas="sect3">S-Lang Dependencies</bridgehead>
+
+    <bridgehead renderas="sect4">Optional</bridgehead>
+    <para><xref linkend="libpng"/> and <xref linkend="pcre"/></para>
+
   </sect2>
 
   <sect2 role="installation">
-    <title>Installation of Slang</title>
+    <title>Installation of S-Lang</title>
 
-    <para>Install <application>slang</application> by running the following
+    <para>Install <application>S-Lang</application> by running the following
     commands:</para>
 
-<screen><userinput>./configure --prefix=/usr &amp;&amp;
-make</userinput></screen>
+<screen><userinput>./configure --prefix=/usr --sysconfdir=/etc &amp;&amp;
+make &amp;&amp;
+make elf</userinput></screen>
 
-    <para>This package does not come with a test suite.</para>
+    <para>To test the results, issue: <command>make runtests</command>.</para>
 
     <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
 
-<screen role="root"><userinput>make install</userinput></screen>
-
-    <para>Now, as the unprivileged user:</para>
-
-<screen><userinput>make elf</userinput></screen>
-
-    <para>And finally, as the <systemitem class="username">root</systemitem> user:</para>
-
 <screen role='root'><userinput>make install-elf &amp;&amp;
-chmod 755 /usr/lib/libslang.so.&slang-version;</userinput></screen>
+chmod -v 755 /usr/lib/libslang.so.&slang-version;</userinput></screen>
   </sect2>
 
   <sect2 role="commands">
     <title>Command Explanations</title>
 
+    <para><option>--with-readline=gnu</option>: Use this parameter to use the
+    system-installed version of <application>Readline</application> instead of
+    the <application>S-Lang</application> internal version.</para>
+
     <para><command>make elf</command> and <command>make install-elf</command>: 
-    These commands create and install the dynamic shared library version of 
-    <application>slang</application>.</para>
+    These commands create and install the dynamic shared version of the
+    <application>S-Lang</application> library as well as an
+    <application>S-Lang</application> script interpreter and related
+    modules.</para>
 
   </sect2>
 
   <sect2 role="configuration">
-    <title>Configuring Slang</title>
+    <title>Configuring S-Lang</title>
+
+    <sect3 id="slang-config">
+      <title>Config Files</title>
+      <para><filename>~/.slshrc</filename> and
+      <filename>/etc/slsh.rc</filename></para>
+
+      <indexterm zone="slang slang-config">
+        <primary sortas="e-AA.slshrc">~/.slshrc</primary>
+      </indexterm>
+
+      <indexterm zone="slang slang-config">
+        <primary sortas="e-etc-slsh">/etc/slsh.rc</primary>
+      </indexterm>
+    </sect3>
 
     <sect3>
       <title>Configuration Information</title>
@@ -107,18 +125,38 @@ chmod 755 /usr/lib/libslang.so.&slang-version;</userinput></screen>
     <title>Contents</title>
 
     <segmentedlist>
-      <segtitle>Installed Programs</segtitle>
-      <segtitle>Installed Library</segtitle>
-      <segtitle>Installed Directory</segtitle>
+      <segtitle>Installed Program</segtitle>
+      <segtitle>Installed Libraries</segtitle>
+      <segtitle>Installed Directories</segtitle>
 
       <seglistitem>
-        <seg>None</seg>
-        <seg>libslang.[so,a]</seg>
-        <seg>/usr/share/doc/slang</seg>
+        <seg>slsh</seg>
+        <seg>libslang.[so,a] and numerous support modules</seg>
+        <seg>/usr/lib/slang, /usr/share/doc/slang and /usr/share/slsh</seg>
       </seglistitem>
     </segmentedlist>
 
+    <variablelist>
+      <bridgehead renderas="sect3">Short Descriptions</bridgehead>
+      <?dbfo list-presentation="list"?>
+      <?dbhtml list-presentation="table"?>
+
+      <varlistentry id="slsh">
+        <term><command>slsh</command></term>
+        <listitem>
+          <para>is a simple program for interpreting
+          <application>S-Lang</application> scripts. It supports dynamic loading
+          of <application>S-Lang</application> modules and includes a
+          <application>Readline</application> interface for interactive
+          use.</para>
+          <indexterm zone="slang slsh">
+            <primary sortas="b-slsh">slsh</primary>
+          </indexterm>
+        </listitem>
+      </varlistentry>
+
+    </variablelist>
+
   </sect2>
 
 </sect1>
-
diff --git a/introduction/welcome/changelog.xml b/introduction/welcome/changelog.xml
index 498790f347..2d15fcbca5 100644
--- a/introduction/welcome/changelog.xml
+++ b/introduction/welcome/changelog.xml
@@ -24,6 +24,10 @@
 
   <itemizedlist>
     
+    <listitem>
+      <para>August 6th, 2005 [randy]: Updated to S-Lang-2.0.4.</para>
+    </listitem>
+
     <listitem>
       <para>August 5th, 2005 [randy]: Updated to Wget-1.10 and PCRE-6.2.</para>
     </listitem>