[52d29f7] | 1 | <?xml version="1.0" encoding="ISO-8859-1"?>
|
---|
[6732c094] | 2 | <!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
|
---|
| 3 | "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
|
---|
[52d29f7] | 4 | <!ENTITY % general-entities SYSTEM "../../general.ent">
|
---|
| 5 | %general-entities;
|
---|
| 6 |
|
---|
[0fb3692] | 7 | <!ENTITY slib-download-http "http://swiss.csail.mit.edu/ftpdir/scm/OLD/slib&slib-version;.tar.gz">
|
---|
[197c184] | 8 | <!ENTITY slib-download-ftp " ">
|
---|
[4fae3a22] | 9 | <!ENTITY slib-md5sum "87bc0b62370c0bf8a510a2acf6868eb9">
|
---|
| 10 | <!ENTITY slib-size "877 KB">
|
---|
| 11 | <!ENTITY slib-buildsize "21 MB (includes building and installing docs)">
|
---|
[0fb3692] | 12 | <!ENTITY slib-time "0.1 SBU">
|
---|
[52d29f7] | 13 | ]>
|
---|
| 14 |
|
---|
[4d4150b0] | 15 | <sect1 id="slib" xreflabel="SLIB-&slib-version;">
|
---|
[197c184] | 16 | <?dbhtml filename="slib.html"?>
|
---|
[8e75f8b9] | 17 |
|
---|
[197c184] | 18 | <sect1info>
|
---|
| 19 | <othername>$LastChangedBy$</othername>
|
---|
| 20 | <date>$Date$</date>
|
---|
| 21 | </sect1info>
|
---|
[8e75f8b9] | 22 |
|
---|
[197c184] | 23 | <title>SLIB-&slib-version;</title>
|
---|
[8e75f8b9] | 24 |
|
---|
[197c184] | 25 | <indexterm zone="slib">
|
---|
| 26 | <primary sortas="a-SLIB">SLIB</primary>
|
---|
| 27 | </indexterm>
|
---|
| 28 |
|
---|
| 29 | <sect2 role="package">
|
---|
| 30 | <title>Introduction to SLIB</title>
|
---|
[8e75f8b9] | 31 |
|
---|
[74390482] | 32 | <para>The <application>SLIB</application> package is a portable library for
|
---|
[4a18013] | 33 | the <application>Scheme</application> programming language. It provides a
|
---|
[74390482] | 34 | platform independent framework for using <quote>packages</quote> of
|
---|
| 35 | <application>Scheme</application> procedures and syntax.
|
---|
[4fae3a22] | 36 | Its catalog can be transparently extended to accommodate packages specific
|
---|
| 37 | to a site, implementation, user or directory. SLIB provides compatibility
|
---|
| 38 | and utility functions for all standard Scheme implementations including
|
---|
| 39 | Bigloo, Chez, ELK 3.0, GAMBIT 3.0, Guile, JScheme, MacScheme, MITScheme,
|
---|
| 40 | PLT Scheme (DrScheme and MzScheme), Pocket Scheme, RScheme, scheme->C,
|
---|
| 41 | Scheme48, SCM, SCM Mac, scsh, Stk, T3.1, umb-scheme, and VSCM.</para>
|
---|
[8e75f8b9] | 42 |
|
---|
[197c184] | 43 | <bridgehead renderas="sect3">Package Information</bridgehead>
|
---|
| 44 | <itemizedlist spacing="compact">
|
---|
| 45 | <listitem>
|
---|
| 46 | <para>Download (HTTP): <ulink url="&slib-download-http;"/></para>
|
---|
| 47 | </listitem>
|
---|
| 48 | <listitem>
|
---|
| 49 | <para>Download (FTP): <ulink url="&slib-download-ftp;"/></para>
|
---|
| 50 | </listitem>
|
---|
| 51 | <listitem>
|
---|
| 52 | <para>Download MD5 sum: &slib-md5sum;</para>
|
---|
| 53 | </listitem>
|
---|
| 54 | <listitem>
|
---|
| 55 | <para>Download size: &slib-size;</para>
|
---|
| 56 | </listitem>
|
---|
| 57 | <listitem>
|
---|
| 58 | <para>Estimated disk space required: &slib-buildsize;</para>
|
---|
| 59 | </listitem>
|
---|
| 60 | <listitem>
|
---|
| 61 | <para>Estimated build time: &slib-time;</para>
|
---|
| 62 | </listitem>
|
---|
| 63 | </itemizedlist>
|
---|
[8e75f8b9] | 64 |
|
---|
[197c184] | 65 | <bridgehead renderas="sect3">Additional Downloads</bridgehead>
|
---|
| 66 | <itemizedlist spacing='compact'>
|
---|
| 67 | <listitem>
|
---|
| 68 | <para>Required Patch: <ulink
|
---|
[4fae3a22] | 69 | url="&patch-root;/slib-&slib-version;-guile_fixes-1.patch"/></para>
|
---|
[197c184] | 70 | </listitem>
|
---|
| 71 | </itemizedlist>
|
---|
[8e75f8b9] | 72 |
|
---|
[197c184] | 73 | <bridgehead renderas="sect3">SLIB Dependencies</bridgehead>
|
---|
[8e75f8b9] | 74 |
|
---|
[4fae3a22] | 75 | <para>There are no build dependencies as this package is nothing but many
|
---|
| 76 | text script files which are copied to the system. If you are installing
|
---|
| 77 | this package to support a <application>GnuCash</application> installation,
|
---|
| 78 | you should ensure that <xref linkend="guile"/> is installed so the
|
---|
| 79 | <application>SLIB</application> catalog for <application>Guile</application>
|
---|
| 80 | can be created.</para>
|
---|
[8e75f8b9] | 81 |
|
---|
[1039de3] | 82 | <para condition="html" role="usernotes">User Notes:
|
---|
| 83 | <ulink url="&blfs-wiki;/slib"/></para>
|
---|
| 84 |
|
---|
[197c184] | 85 | </sect2>
|
---|
[8e75f8b9] | 86 |
|
---|
[197c184] | 87 | <sect2 role="installation">
|
---|
| 88 | <title>Installation of SLIB</title>
|
---|
| 89 |
|
---|
[74390482] | 90 | <para>Install <application>SLIB</application> by issuing the following
|
---|
[197c184] | 91 | commands:</para>
|
---|
| 92 |
|
---|
[4fae3a22] | 93 | <screen><userinput>patch -Np1 -i ../slib-&slib-version;-guile_fixes-1.patch &&
|
---|
| 94 | sed -i 's|usr/lib|usr/share|' {RScheme,guile}.init</userinput></screen>
|
---|
[8e75f8b9] | 95 |
|
---|
[4fae3a22] | 96 | <para>If you have <xref linkend="tetex"/> installed and wish to
|
---|
| 97 | build PDF, Postscript, HTML or text documentation, issue any or all of
|
---|
[9d227199] | 98 | the following commands:</para>
|
---|
[4a18013] | 99 |
|
---|
[4fae3a22] | 100 | <screen><userinput>texi2pdf slib.texi &&
|
---|
| 101 | texi2html slib.texi &&
|
---|
| 102 | texi2dvi slib.texi &&
|
---|
| 103 | dvips -o slib.ps slib.dvi &&
|
---|
| 104 | makeinfo -o slib.txt --plaintext slib.texi</userinput></screen>
|
---|
[4a18013] | 105 |
|
---|
[e9dff9df] | 106 | <para>This package does not come with a functional test suite.</para>
|
---|
[4a18013] | 107 |
|
---|
[197c184] | 108 | <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
|
---|
[8e75f8b9] | 109 |
|
---|
[4fae3a22] | 110 | <screen role="root"><userinput>make prefix=/usr/ \
|
---|
| 111 | libdir=/usr/share/ \
|
---|
| 112 | mandir=/usr/share/man/ \
|
---|
| 113 | infodir=/usr/share/info/ \
|
---|
| 114 | install installinfo &&
|
---|
[0045775] | 115 |
|
---|
[4fae3a22] | 116 | install -v -m755 -d /usr/share/doc/slib-&slib-version; &&
|
---|
| 117 | install -v -m644 ANNOUNCE FAQ README /usr/share/doc/slib-&slib-version;</userinput></screen>
|
---|
[0045775] | 118 |
|
---|
[4fae3a22] | 119 | <para>If you have <xref linkend="guile"/> installed, create the following
|
---|
| 120 | symbolic link as the <systemitem class="username">root</systemitem> user to
|
---|
| 121 | satisfy <application>Guile</application>'s default
|
---|
| 122 | <quote>Implementation Vicinity</quote> directory.</para>
|
---|
[0045775] | 123 |
|
---|
[4fae3a22] | 124 | <screen role="root"><userinput>ln -v -s ../slib /usr/share/guile</userinput></screen>
|
---|
[0045775] | 125 |
|
---|
[4fae3a22] | 126 | <para>If you built any of the documentation, install it using the following
|
---|
| 127 | command as the <systemitem class="username">root</systemitem> user:</para>
|
---|
| 128 |
|
---|
| 129 | <screen role="root"><userinput>install -v -m644 slib.{pdf,html,dvi,ps,txt,texi} \
|
---|
| 130 | /usr/share/doc/slib-&slib-version;</userinput></screen>
|
---|
[8e75f8b9] | 131 |
|
---|
[197c184] | 132 | </sect2>
|
---|
[8e75f8b9] | 133 |
|
---|
[197c184] | 134 | <sect2 role="commands">
|
---|
| 135 | <title>Command Explanations</title>
|
---|
| 136 |
|
---|
[4fae3a22] | 137 | <para><command>sed -i 's|usr/lib|usr/share|' {RScheme,guile}.init</command>:
|
---|
| 138 | This command is used to change the <envar>libdir</envar> variable embedded
|
---|
| 139 | in the two scripts to match the installation variable.</para>
|
---|
| 140 |
|
---|
| 141 | <para><command>make ... install installinfo</command>: This command
|
---|
| 142 | installs the package and the <command>info</command> documentation into the
|
---|
| 143 | indicated directories.</para>
|
---|
| 144 |
|
---|
| 145 | </sect2>
|
---|
| 146 |
|
---|
| 147 | <sect2 role="configuration" id="slib-config">
|
---|
| 148 | <title>Configuring SLIB</title>
|
---|
| 149 |
|
---|
| 150 | <para>For many of the Scheme implementations, an
|
---|
| 151 | <application>SLIB</application> Scheme implementation catalog must be
|
---|
| 152 | created. If you have <xref linkend="guile"/> installed to support a
|
---|
| 153 | <application>GnuCash</application> installation, you must create a
|
---|
| 154 | catalog. You can use the <command>make catalogs</command> command, but
|
---|
| 155 | there will be many warnings and confusing messages as it tries to create
|
---|
| 156 | a catalog for many of the possible Scheme implementations which are
|
---|
| 157 | probably not installed on the system. To create a single catalog just
|
---|
| 158 | for the <application>Guile</application> installation, issue the following
|
---|
| 159 | command as the <systemitem class="username">root</systemitem> user:</para>
|
---|
| 160 |
|
---|
| 161 | <screen role="root"><userinput>guile -l guile.init \
|
---|
| 162 | -c "(use-modules (ice-9 slib)) (require 'new-catalog)"</userinput></screen>
|
---|
[8e75f8b9] | 163 |
|
---|
[4fae3a22] | 164 | <para>If there was no output from the previous command, and the file
|
---|
| 165 | <filename>/usr/share/guile/slibcat</filename> now exists, the catalog
|
---|
| 166 | was properly created.</para>
|
---|
[8e75f8b9] | 167 |
|
---|
[197c184] | 168 | </sect2>
|
---|
[8e75f8b9] | 169 |
|
---|
[197c184] | 170 | <sect2 role="content">
|
---|
| 171 | <title>Contents</title>
|
---|
| 172 |
|
---|
| 173 | <segmentedlist>
|
---|
| 174 | <segtitle>Installed Program</segtitle>
|
---|
| 175 | <segtitle>Installed Libraries</segtitle>
|
---|
| 176 | <segtitle>Installed Directory</segtitle>
|
---|
[8e75f8b9] | 177 |
|
---|
[197c184] | 178 | <seglistitem>
|
---|
| 179 | <seg>slib</seg>
|
---|
[4a18013] | 180 | <seg>a <application>Scheme</application> library system</seg>
|
---|
[4fae3a22] | 181 | <seg>/usr/share/slib and /usr/share/doc/slib-&slib-version;</seg>
|
---|
[197c184] | 182 | </seglistitem>
|
---|
| 183 | </segmentedlist>
|
---|
[8e75f8b9] | 184 |
|
---|
[197c184] | 185 | <variablelist>
|
---|
| 186 | <bridgehead renderas="sect3">Short Descriptions</bridgehead>
|
---|
| 187 | <?dbfo list-presentation="list"?>
|
---|
| 188 | <?dbhtml list-presentation="table"?>
|
---|
[8e75f8b9] | 189 |
|
---|
[197c184] | 190 | <varlistentry id="slib-prog">
|
---|
| 191 | <term><command>slib</command></term>
|
---|
| 192 | <listitem>
|
---|
[74390482] | 193 | <para>is a shell script used to initialize
|
---|
[87f108a] | 194 | <application>SLIB</application> in a named
|
---|
| 195 | <application>Scheme</application> implementation. It can also be
|
---|
| 196 | used to initialize an <application>SLIB</application> session using
|
---|
| 197 | a given executable.</para>
|
---|
[197c184] | 198 | <indexterm zone="slib slib-prog">
|
---|
| 199 | <primary sortas="b-slib">slib</primary>
|
---|
| 200 | </indexterm>
|
---|
| 201 | </listitem>
|
---|
| 202 | </varlistentry>
|
---|
[8e75f8b9] | 203 |
|
---|
[197c184] | 204 | </variablelist>
|
---|
| 205 |
|
---|
| 206 | </sect2>
|
---|
[8e75f8b9] | 207 |
|
---|
[b866b9f7] | 208 | </sect1>
|
---|