source: general/genlib/slib.xml@ 7e702f9d

<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
   "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
  <!ENTITY % general-entities SYSTEM "../../general.ent">
  %general-entities;

  <!ENTITY slib-download-http "http://swiss.csail.mit.edu/ftpdir/scm/OLD/slib-&slib-version;.tar.gz">
  <!ENTITY slib-download-ftp  " ">
  <!ENTITY slib-md5sum        "850f48ad933e2fe8bb03b1e994ed4407">
  <!ENTITY slib-size          "948 KB">
  <!ENTITY slib-buildsize     "31 MB (includes building and installing docs)">
  <!ENTITY slib-time          "less than 0.1 SBU">
]>

<sect1 id="slib" xreflabel="SLIB-&slib-version;">
  <?dbhtml filename="slib.html"?>

  <sect1info>
    <othername>$LastChangedBy$</othername>
    <date>$Date$</date>
  </sect1info>

  <title>SLIB-&slib-version;</title>

  <indexterm zone="slib">
    <primary sortas="a-SLIB">SLIB</primary>
  </indexterm>

  <sect2 role="package">
    <title>Introduction to SLIB</title>

    <para>The <application>SLIB</application> package is a portable library for
    the <application>Scheme</application> programming language. It provides a
    platform independent framework for using <quote>packages</quote> of
    <application>Scheme</application> procedures and syntax.
    Its catalog can be transparently extended to accommodate packages specific
    to a site, implementation, user or directory. SLIB provides compatibility
    and utility functions for all standard Scheme implementations including
    Bigloo, Chez, ELK 3.0, GAMBIT 3.0, Guile, JScheme, MacScheme, MITScheme,
    PLT Scheme (DrScheme and MzScheme), Pocket Scheme, RScheme, scheme->C,
    Scheme48, SCM, SCM Mac, scsh, Stk, T3.1, umb-scheme, and VSCM.</para>

    <bridgehead renderas="sect3">Package Information</bridgehead>
    <itemizedlist spacing="compact">
      <listitem>
        <para>Download (HTTP): <ulink url="&slib-download-http;"/></para>
      </listitem>
      <listitem>
        <para>Download (FTP): <ulink url="&slib-download-ftp;"/></para>
      </listitem>
      <listitem>
        <para>Download MD5 sum: &slib-md5sum;</para>
      </listitem>
      <listitem>
        <para>Download size: &slib-size;</para>
      </listitem>
      <listitem>
        <para>Estimated disk space required: &slib-buildsize;</para>
      </listitem>
      <listitem>
        <para>Estimated build time: &slib-time;</para>
      </listitem>
    </itemizedlist>

    <!-- <bridgehead renderas="sect3">Additional Downloads</bridgehead>
    <itemizedlist spacing='compact'>
      <listitem>
        <para>Required Patch: <ulink
        url="&patch-root;/slib-&slib-version;-guile_fixes-1.patch"/></para>
      </listitem>
    </itemizedlist> -->

    <bridgehead renderas="sect3">SLIB Dependencies</bridgehead>

    <para>There are no build dependencies as this package is nothing but many
    text script files which are copied to the system. If you are installing
    this package to support a <application>GnuCash</application> installation,
    you should ensure that <xref linkend="guile"/> is installed so the
    <application>SLIB</application> catalog for <application>Guile</application>
    can be created.</para>

    <para condition="html" role="usernotes">User Notes:
    <ulink url="&blfs-wiki;/slib"/></para>

  </sect2>

  <sect2 role="installation">
    <title>Installation of SLIB</title>

    <para>Install <application>SLIB</application> by issuing the following
    commands:</para>

<screen><userinput>sed -i 's|usr/lib|usr/share|' RScheme.init        &amp;&amp;
makeinfo -o slib.txt  --plaintext       slib.texi &amp;&amp;
makeinfo -o slib.html --html --no-split slib.texi</userinput></screen>

    <para>If you have <!--<xref linkend="tetex"/> or--> <xref linkend="texlive"/>
    installed and wish to build PDF or Postscript documentation, issue any or
    all of the following commands:</para>

<screen><userinput>texi2pdf  slib.texi &amp;&amp;
texi2dvi  slib.texi &amp;&amp;
dvips  -o slib.ps   slib.dvi</userinput></screen>

    <para>This package does not come with a functional test suite.</para>

    <para>Now, as the <systemitem class="username">root</systemitem> user:</para>

<screen role="root"><userinput>make prefix=/usr/ \
     libdir=/usr/share/ \
     man1dir=/usr/share/man/man1 \
     infodir=/usr/share/info/ \
  install installinfo &amp;&amp;

install -v -m755 -d /usr/share/doc/slib-&slib-version;  &amp;&amp;
install -v -m644    ANNOUNCE FAQ README slib.{txt,html} \
                    /usr/share/doc/slib-&slib-version;</userinput></screen>

    <para>If you have <xref linkend="guile"/> installed, create the following
    symbolic link as the <systemitem class="username">root</systemitem> user to
    satisfy <application>Guile</application>'s default
    <quote>Implementation Vicinity</quote> directory.</para>

<screen role="root"><userinput>ln -v -s ../slib /usr/share/guile</userinput></screen>

    <para>If you built any of the optional documentation, install it using the
    following command as the <systemitem class="username">root</systemitem>
    user:</para>

<screen role="root"><userinput>install -v -m644 slib.{pdf,dvi,ps} \
                 /usr/share/doc/slib-&slib-version;</userinput></screen>

  </sect2>

  <sect2 role="commands">
    <title>Command Explanations</title>

    <para><command>sed -i 's|usr/lib|usr/share|' RScheme.init</command>:
    This command is used to change the <envar>libdir</envar> variable embedded
    in the script to match the installation variable.</para>

    <para><command>make ... install installinfo</command>: This command
    installs the package and the <command>info</command> documentation into the
    indicated directories.</para>

  </sect2>

  <sect2 role="configuration" id="slib-config">
    <title>Configuring SLIB</title>

    <para>For many of the Scheme implementations, an
    <application>SLIB</application> Scheme implementation catalog  must be
    created. If you have <xref linkend="guile"/> installed to support a
    <application>GnuCash</application> installation, you must create a
    catalog. You can use the <command>make catalogs</command> command, but
    there will be many warnings and confusing messages as it tries to create
    a catalog for many of the possible Scheme implementations which are
    probably not installed on the system. To create a single catalog just
    for the <application>Guile</application> installation, issue the following
    command as the <systemitem class="username">root</systemitem> user:</para>

<screen role="root"><userinput>guile -l guile.init \
      -c "(use-modules (ice-9 slib)) (require 'new-catalog)"</userinput></screen>

    <para>If there was no output from the previous command, and the file
    <filename>/usr/share/guile/1.8/slibcat</filename> now exists, the catalog
    was properly created.</para>

  </sect2>

  <sect2 role="content">
    <title>Contents</title>

    <segmentedlist>
      <segtitle>Installed Program</segtitle>
      <segtitle>Installed Libraries</segtitle>
      <segtitle>Installed Directory</segtitle>

      <seglistitem>
        <seg>slib</seg>
        <seg>a <application>Scheme</application> library system</seg>
        <seg>/usr/share/slib and /usr/share/doc/slib-&slib-version;</seg>
      </seglistitem>
    </segmentedlist>

    <variablelist>
      <bridgehead renderas="sect3">Short Descriptions</bridgehead>
      <?dbfo list-presentation="list"?>
      <?dbhtml list-presentation="table"?>

      <varlistentry id="slib-prog">
        <term><command>slib</command></term>
        <listitem>
          <para>is a shell script used to initialize
          <application>SLIB</application> in a named
          <application>Scheme</application> implementation. It can also be
          used to initialize an <application>SLIB</application> session using
          a given executable.</para>
          <indexterm zone="slib slib-prog">
            <primary sortas="b-slib">slib</primary>
          </indexterm>
        </listitem>
      </varlistentry>

    </variablelist>

  </sect2>

</sect1>