1 | <?xml version="1.0" encoding="ISO-8859-1"?>
|
---|
2 | <!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
|
---|
3 | "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
|
---|
4 | <!ENTITY % general-entities SYSTEM "../../general.ent">
|
---|
5 | %general-entities;
|
---|
6 |
|
---|
7 | <!ENTITY slib-download-http
|
---|
8 | "http://groups.csail.mit.edu/mac/ftpdir/scm/slib-&slib-version;.tar.gz">
|
---|
9 | <!ENTITY slib-download-ftp " ">
|
---|
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">
|
---|
14 | ]>
|
---|
15 |
|
---|
16 | <sect1 id="slib" xreflabel="SLIB-&slib-version;">
|
---|
17 | <?dbhtml filename="slib.html"?>
|
---|
18 |
|
---|
19 |
|
---|
20 | <title>SLIB-&slib-version;</title>
|
---|
21 |
|
---|
22 | <indexterm zone="slib">
|
---|
23 | <primary sortas="a-SLIB">SLIB</primary>
|
---|
24 | </indexterm>
|
---|
25 |
|
---|
26 | <sect2 role="package">
|
---|
27 | <title>Introduction to SLIB</title>
|
---|
28 |
|
---|
29 | <para>The <application>SLIB</application> package is a portable library for
|
---|
30 | the <application>Scheme</application> programming language. It provides a
|
---|
31 | platform independent framework for using <quote>packages</quote> of
|
---|
32 | <application>Scheme</application> procedures and syntax.
|
---|
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>
|
---|
39 |
|
---|
40 | &lfs74_checked;
|
---|
41 |
|
---|
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>
|
---|
63 |
|
---|
64 | <bridgehead renderas="sect3">SLIB Dependencies</bridgehead>
|
---|
65 |
|
---|
66 | <bridgehead renderas="sect4">Required</bridgehead>
|
---|
67 | <para role="required"><xref linkend="guile"/>.</para>
|
---|
68 |
|
---|
69 | <para condition="html" role="usernotes">User Notes:
|
---|
70 | <ulink url="&blfs-wiki;/slib"/></para>
|
---|
71 | </sect2>
|
---|
72 |
|
---|
73 | <sect2 role="installation">
|
---|
74 | <title>Installation of SLIB</title>
|
---|
75 |
|
---|
76 | <para>Install <application>SLIB</application> by issuing the following
|
---|
77 | commands:</para>
|
---|
78 |
|
---|
79 | <screen><userinput>sed -i 's|usr/lib|usr/share|' RScheme.init &&
|
---|
80 | ./configure --prefix=/usr --libdir=/usr/share &&
|
---|
81 |
|
---|
82 | sed -i -e 's# scm$# guile#;s#ginstall-info#install-info#' \
|
---|
83 | -e 's/no-split -o/no-split --force -o/' Makefile &&
|
---|
84 |
|
---|
85 | makeinfo -o slib.txt --plaintext --force slib.texi &&
|
---|
86 | makeinfo -o slib.html --html --no-split --force slib.texi</userinput></screen>
|
---|
87 |
|
---|
88 | <!-- Thee are errors in slib.texi
|
---|
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>
|
---|
92 |
|
---|
93 | <screen><userinput>texi2pdf slib.texi &&
|
---|
94 | texi2dvi slib.texi &&
|
---|
95 | dvips -o slib.ps slib.dvi</userinput></screen>
|
---|
96 | -->
|
---|
97 | <para>This package does not come with a functional test suite.</para>
|
---|
98 |
|
---|
99 | <para>Now, as the <systemitem class="username">root</systemitem>
|
---|
100 | user:</para>
|
---|
101 |
|
---|
102 | <screen role="root"><userinput>make install &&
|
---|
103 | ln -v -sf ../slib /usr/share/guile &&
|
---|
104 | mkdir -pv /usr/share/guile/site/2.0 &&
|
---|
105 | guile -c "(use-modules (ice-9 slib)) (require 'printf)" &&
|
---|
106 | install -v -m755 -d /usr/share/doc/slib-&slib-version; &&
|
---|
107 | install -v -m644 ANNOUNCE FAQ README slib.{txt,html} /usr/share/doc/slib-&slib-version;</userinput></screen>
|
---|
108 |
|
---|
109 | <!--
|
---|
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>
|
---|
113 |
|
---|
114 | <screen role="root"><userinput>install -v -m644 slib.{pdf,dvi,ps} /usr/share/doc/slib-&slib-version;</userinput></screen>
|
---|
115 | -->
|
---|
116 | </sect2>
|
---|
117 |
|
---|
118 | <sect2 role="commands">
|
---|
119 | <title>Command Explanations</title>
|
---|
120 |
|
---|
121 | <para><command>sed -i 's|usr/lib|usr/share|' RScheme.init</command>:
|
---|
122 | This command is used to change the <envar>libdir</envar> variable embedded
|
---|
123 | in the script to match the installation.</para>
|
---|
124 |
|
---|
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>
|
---|
128 |
|
---|
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
|
---|
135 | puts a symbolic link to the <application>slib</application> files in
|
---|
136 | <application>Guile</application>'s default <quote>Implementation
|
---|
137 | Vicinity</quote>.</para>
|
---|
138 |
|
---|
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>
|
---|
142 |
|
---|
143 | </sect2>
|
---|
144 |
|
---|
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>
|
---|
152 |
|
---|
153 | <seglistitem>
|
---|
154 | <seg>slib</seg>
|
---|
155 | <seg>a <application>Scheme</application> library system</seg>
|
---|
156 | <seg>/usr/share/slib,
|
---|
157 | /usr/share/guile/site/2.0, and
|
---|
158 | /usr/share/doc/slib-&slib-version;</seg>
|
---|
159 | </seglistitem>
|
---|
160 | </segmentedlist>
|
---|
161 |
|
---|
162 | <variablelist>
|
---|
163 | <bridgehead renderas="sect3">Short Descriptions</bridgehead>
|
---|
164 | <?dbfo list-presentation="list"?>
|
---|
165 | <?dbhtml list-presentation="table"?>
|
---|
166 |
|
---|
167 | <varlistentry id="slib-prog">
|
---|
168 | <term><command>slib</command></term>
|
---|
169 | <listitem>
|
---|
170 | <para>is a shell script used to initialize
|
---|
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>
|
---|
175 | <indexterm zone="slib slib-prog">
|
---|
176 | <primary sortas="b-slib">slib</primary>
|
---|
177 | </indexterm>
|
---|
178 | </listitem>
|
---|
179 | </varlistentry>
|
---|
180 | </variablelist>
|
---|
181 | </sect2>
|
---|
182 | </sect1>
|
---|