[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 |
|
---|
[a4a52f4] | 7 | <!ENTITY slib-download-http
|
---|
| 8 | "http://groups.csail.mit.edu/mac/ftpdir/scm/slib-&slib-version;.tar.gz">
|
---|
[197c184] | 9 | <!ENTITY slib-download-ftp " ">
|
---|
[f0c1bb8] | 10 | <!ENTITY slib-md5sum "dcada65c4df4209c8f71211095bcef8e">
|
---|
| 11 | <!ENTITY slib-size "956 KB">
|
---|
| 12 | <!ENTITY slib-buildsize "10 MB (includes building and installing docs)">
|
---|
| 13 | <!ENTITY slib-time "0.5 SBU">
|
---|
[52d29f7] | 14 | ]>
|
---|
| 15 |
|
---|
[4d4150b0] | 16 | <sect1 id="slib" xreflabel="SLIB-&slib-version;">
|
---|
[197c184] | 17 | <?dbhtml filename="slib.html"?>
|
---|
[8e75f8b9] | 18 |
|
---|
| 19 |
|
---|
[197c184] | 20 | <title>SLIB-&slib-version;</title>
|
---|
[8e75f8b9] | 21 |
|
---|
[197c184] | 22 | <indexterm zone="slib">
|
---|
| 23 | <primary sortas="a-SLIB">SLIB</primary>
|
---|
| 24 | </indexterm>
|
---|
| 25 |
|
---|
| 26 | <sect2 role="package">
|
---|
| 27 | <title>Introduction to SLIB</title>
|
---|
[8e75f8b9] | 28 |
|
---|
[74390482] | 29 | <para>The <application>SLIB</application> package is a portable library for
|
---|
[4a18013] | 30 | the <application>Scheme</application> programming language. It provides a
|
---|
[74390482] | 31 | platform independent framework for using <quote>packages</quote> of
|
---|
| 32 | <application>Scheme</application> procedures and syntax.
|
---|
[4fae3a22] | 33 | Its catalog can be transparently extended to accommodate packages specific
|
---|
| 34 | to a site, implementation, user or directory. SLIB provides compatibility
|
---|
| 35 | and utility functions for all standard Scheme implementations including
|
---|
| 36 | Bigloo, Chez, ELK 3.0, GAMBIT 3.0, Guile, JScheme, MacScheme, MITScheme,
|
---|
| 37 | PLT Scheme (DrScheme and MzScheme), Pocket Scheme, RScheme, scheme->C,
|
---|
| 38 | Scheme48, SCM, SCM Mac, scsh, Stk, T3.1, umb-scheme, and VSCM.</para>
|
---|
[8e75f8b9] | 39 |
|
---|
[8f29aa2] | 40 | &lfs74_checked;
|
---|
[a4a52f4] | 41 |
|
---|
[197c184] | 42 | <bridgehead renderas="sect3">Package Information</bridgehead>
|
---|
| 43 | <itemizedlist spacing="compact">
|
---|
| 44 | <listitem>
|
---|
| 45 | <para>Download (HTTP): <ulink url="&slib-download-http;"/></para>
|
---|
| 46 | </listitem>
|
---|
| 47 | <listitem>
|
---|
| 48 | <para>Download (FTP): <ulink url="&slib-download-ftp;"/></para>
|
---|
| 49 | </listitem>
|
---|
| 50 | <listitem>
|
---|
| 51 | <para>Download MD5 sum: &slib-md5sum;</para>
|
---|
| 52 | </listitem>
|
---|
| 53 | <listitem>
|
---|
| 54 | <para>Download size: &slib-size;</para>
|
---|
| 55 | </listitem>
|
---|
| 56 | <listitem>
|
---|
| 57 | <para>Estimated disk space required: &slib-buildsize;</para>
|
---|
| 58 | </listitem>
|
---|
| 59 | <listitem>
|
---|
| 60 | <para>Estimated build time: &slib-time;</para>
|
---|
| 61 | </listitem>
|
---|
| 62 | </itemizedlist>
|
---|
[8e75f8b9] | 63 |
|
---|
[197c184] | 64 | <bridgehead renderas="sect3">SLIB Dependencies</bridgehead>
|
---|
[8e75f8b9] | 65 |
|
---|
[a4a52f4] | 66 | <bridgehead renderas="sect4">Required</bridgehead>
|
---|
| 67 | <para role="required"><xref linkend="guile"/>.</para>
|
---|
[8e75f8b9] | 68 |
|
---|
[1039de3] | 69 | <para condition="html" role="usernotes">User Notes:
|
---|
| 70 | <ulink url="&blfs-wiki;/slib"/></para>
|
---|
[197c184] | 71 | </sect2>
|
---|
[8e75f8b9] | 72 |
|
---|
[197c184] | 73 | <sect2 role="installation">
|
---|
| 74 | <title>Installation of SLIB</title>
|
---|
| 75 |
|
---|
[74390482] | 76 | <para>Install <application>SLIB</application> by issuing the following
|
---|
[197c184] | 77 | commands:</para>
|
---|
| 78 |
|
---|
[79e6d17] | 79 | <screen><userinput>sed -i 's|usr/lib|usr/share|' RScheme.init &&
|
---|
| 80 | ./configure --prefix=/usr --libdir=/usr/share &&
|
---|
| 81 |
|
---|
[f0c1bb8] | 82 | sed -i -e 's# scm$# guile#;s#ginstall-info#install-info#' \
|
---|
| 83 | -e 's/no-split -o/no-split --force -o/' Makefile &&
|
---|
[79e6d17] | 84 |
|
---|
[f0c1bb8] | 85 | makeinfo -o slib.txt --plaintext --force slib.texi &&
|
---|
| 86 | makeinfo -o slib.html --html --no-split --force slib.texi</userinput></screen>
|
---|
[8e75f8b9] | 87 |
|
---|
[79e6d17] | 88 | <!-- Thee are errors in slib.texi
|
---|
[a4a52f4] | 89 | <para>If you have <xref linkend="texlive"/> installed and wish to build PDF
|
---|
| 90 | or Postscript documentation, issue any or all of the following
|
---|
| 91 | commands:</para>
|
---|
[4a18013] | 92 |
|
---|
[a4a52f4] | 93 | <screen><userinput>texi2pdf slib.texi &&
|
---|
| 94 | texi2dvi slib.texi &&
|
---|
| 95 | dvips -o slib.ps slib.dvi</userinput></screen>
|
---|
[79e6d17] | 96 | -->
|
---|
[e9dff9df] | 97 | <para>This package does not come with a functional test suite.</para>
|
---|
[4a18013] | 98 |
|
---|
[a4a52f4] | 99 | <para>Now, as the <systemitem class="username">root</systemitem>
|
---|
| 100 | user:</para>
|
---|
[0045775] | 101 |
|
---|
[79e6d17] | 102 | <screen role="root"><userinput>make install &&
|
---|
[f0c1bb8] | 103 | ln -v -sf ../slib /usr/share/guile &&
|
---|
| 104 | mkdir -pv /usr/share/guile/site/2.0 &&
|
---|
[8f29aa2] | 105 | guile -c "(use-modules (ice-9 slib)) (require 'printf)" &&
|
---|
[79e6d17] | 106 | install -v -m755 -d /usr/share/doc/slib-&slib-version; &&
|
---|
[a4a52f4] | 107 | install -v -m644 ANNOUNCE FAQ README slib.{txt,html} /usr/share/doc/slib-&slib-version;</userinput></screen>
|
---|
[0045775] | 108 |
|
---|
[79e6d17] | 109 | <!--
|
---|
[7dc7b56] | 110 | <para>If you built any of the optional documentation, install it using the
|
---|
| 111 | following command as the <systemitem class="username">root</systemitem>
|
---|
| 112 | user:</para>
|
---|
[4fae3a22] | 113 |
|
---|
[a4a52f4] | 114 | <screen role="root"><userinput>install -v -m644 slib.{pdf,dvi,ps} /usr/share/doc/slib-&slib-version;</userinput></screen>
|
---|
[0d7900a] | 115 | -->
|
---|
[79e6d17] | 116 | </sect2>
|
---|
[8e75f8b9] | 117 |
|
---|
[197c184] | 118 | <sect2 role="commands">
|
---|
| 119 | <title>Command Explanations</title>
|
---|
| 120 |
|
---|
[7dc7b56] | 121 | <para><command>sed -i 's|usr/lib|usr/share|' RScheme.init</command>:
|
---|
[4fae3a22] | 122 | This command is used to change the <envar>libdir</envar> variable embedded
|
---|
[a4a52f4] | 123 | in the script to match the installation.</para>
|
---|
[4fae3a22] | 124 |
|
---|
[a4a52f4] | 125 | <para><option>--libdir=/usr/share</option>: This option puts the installed
|
---|
| 126 | in files <filename class="directory">/usr/share/slib</filename> instead of
|
---|
| 127 | <filename class="directory">/usr/lib/slib</filename>.</para>
|
---|
[4fae3a22] | 128 |
|
---|
[f0c1bb8] | 129 | <para><command>makeinfo ... --force ... </command>: This command creates
|
---|
| 130 | needed documentation, but needs the <option>--force</option> option to
|
---|
| 131 | overcome warnings that are flagged as errors in recent versions of
|
---|
| 132 | <command>makeinfo</command>.</para>
|
---|
| 133 |
|
---|
| 134 | <para><command>ln -v -sf ../slib /usr/share/guile</command>: This command
|
---|
[a4a52f4] | 135 | puts a symbolic link to the <application>slib</application> files in
|
---|
| 136 | <application>Guile</application>'s default <quote>Implementation
|
---|
| 137 | Vicinity</quote>.</para>
|
---|
[8e75f8b9] | 138 |
|
---|
[a4a52f4] | 139 | <para><command>guile -c "(use-modules (ice-9 slib)) (require
|
---|
| 140 | 'printf)"</command>: This command creates a guile catalog of the
|
---|
| 141 | <application>slib</application> files.</para>
|
---|
[8e75f8b9] | 142 |
|
---|
[197c184] | 143 | </sect2>
|
---|
[8e75f8b9] | 144 |
|
---|
[197c184] | 145 | <sect2 role="content">
|
---|
| 146 | <title>Contents</title>
|
---|
| 147 |
|
---|
| 148 | <segmentedlist>
|
---|
| 149 | <segtitle>Installed Program</segtitle>
|
---|
| 150 | <segtitle>Installed Libraries</segtitle>
|
---|
| 151 | <segtitle>Installed Directory</segtitle>
|
---|
[8e75f8b9] | 152 |
|
---|
[197c184] | 153 | <seglistitem>
|
---|
| 154 | <seg>slib</seg>
|
---|
[4a18013] | 155 | <seg>a <application>Scheme</application> library system</seg>
|
---|
[f3429309] | 156 | <seg>/usr/share/slib,
|
---|
| 157 | /usr/share/guile/site/2.0, and
|
---|
[f0c1bb8] | 158 | /usr/share/doc/slib-&slib-version;</seg>
|
---|
[197c184] | 159 | </seglistitem>
|
---|
| 160 | </segmentedlist>
|
---|
[8e75f8b9] | 161 |
|
---|
[197c184] | 162 | <variablelist>
|
---|
| 163 | <bridgehead renderas="sect3">Short Descriptions</bridgehead>
|
---|
| 164 | <?dbfo list-presentation="list"?>
|
---|
| 165 | <?dbhtml list-presentation="table"?>
|
---|
[8e75f8b9] | 166 |
|
---|
[197c184] | 167 | <varlistentry id="slib-prog">
|
---|
| 168 | <term><command>slib</command></term>
|
---|
| 169 | <listitem>
|
---|
[74390482] | 170 | <para>is a shell script used to initialize
|
---|
[87f108a] | 171 | <application>SLIB</application> in a named
|
---|
| 172 | <application>Scheme</application> implementation. It can also be
|
---|
| 173 | used to initialize an <application>SLIB</application> session using
|
---|
| 174 | a given executable.</para>
|
---|
[197c184] | 175 | <indexterm zone="slib slib-prog">
|
---|
| 176 | <primary sortas="b-slib">slib</primary>
|
---|
| 177 | </indexterm>
|
---|
| 178 | </listitem>
|
---|
| 179 | </varlistentry>
|
---|
| 180 | </variablelist>
|
---|
| 181 | </sect2>
|
---|
[b866b9f7] | 182 | </sect1>
|
---|