source: archive/slib.xml

trunk
Last change on this file was 45ab6c7, checked in by Xi Ruoyao <xry111@…>, 3 months ago

more SVN prop clean up

Remove "$LastChanged$" everywhere, and also some unused $Date$

  • Property mode set to 100644
File size: 6.9 KB
Line 
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 <sect1info>
20 <date>$Date$</date>
21 </sect1info>
22
23 <title>SLIB-&slib-version;</title>
24
25 <indexterm zone="slib">
26 <primary sortas="a-SLIB">SLIB</primary>
27 </indexterm>
28
29 <sect2 role="package">
30 <title>Introduction to SLIB</title>
31
32 <para>The <application>SLIB</application> package is a portable library for
33 the <application>Scheme</application> programming language. It provides a
34 platform independent framework for using <quote>packages</quote> of
35 <application>Scheme</application> procedures and syntax.
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>
42
43 &lfs74_checked;
44
45 <bridgehead renderas="sect3">Package Information</bridgehead>
46 <itemizedlist spacing="compact">
47 <listitem>
48 <para>Download (HTTP): <ulink url="&slib-download-http;"/></para>
49 </listitem>
50 <listitem>
51 <para>Download (FTP): <ulink url="&slib-download-ftp;"/></para>
52 </listitem>
53 <listitem>
54 <para>Download MD5 sum: &slib-md5sum;</para>
55 </listitem>
56 <listitem>
57 <para>Download size: &slib-size;</para>
58 </listitem>
59 <listitem>
60 <para>Estimated disk space required: &slib-buildsize;</para>
61 </listitem>
62 <listitem>
63 <para>Estimated build time: &slib-time;</para>
64 </listitem>
65 </itemizedlist>
66
67 <bridgehead renderas="sect3">SLIB Dependencies</bridgehead>
68
69 <bridgehead renderas="sect4">Required</bridgehead>
70 <para role="required"><xref linkend="guile"/>.</para>
71
72 <para condition="html" role="usernotes">User Notes:
73 <ulink url="&blfs-wiki;/slib"/></para>
74 </sect2>
75
76 <sect2 role="installation">
77 <title>Installation of SLIB</title>
78
79 <para>Install <application>SLIB</application> by issuing the following
80 commands:</para>
81
82<screen><userinput>sed -i 's|usr/lib|usr/share|' RScheme.init &amp;&amp;
83./configure --prefix=/usr --libdir=/usr/share &amp;&amp;
84
85sed -i -e 's# scm$# guile#;s#ginstall-info#install-info#' \
86 -e 's/no-split -o/no-split --force -o/' Makefile &amp;&amp;
87
88makeinfo -o slib.txt --plaintext --force slib.texi &amp;&amp;
89makeinfo -o slib.html --html --no-split --force slib.texi</userinput></screen>
90
91<!-- Thee are errors in slib.texi
92 <para>If you have <xref linkend="texlive"/> installed and wish to build PDF
93 or Postscript documentation, issue any or all of the following
94 commands:</para>
95
96<screen><userinput>texi2pdf slib.texi &amp;&amp;
97texi2dvi slib.texi &amp;&amp;
98dvips -o slib.ps slib.dvi</userinput></screen>
99-->
100 <para>This package does not come with a functional test suite.</para>
101
102 <para>Now, as the <systemitem class="username">root</systemitem>
103 user:</para>
104
105<screen role="root"><userinput>make install &amp;&amp;
106ln -v -sf ../slib /usr/share/guile &amp;&amp;
107mkdir -pv /usr/share/guile/site/2.0 &amp;&amp;
108guile -c "(use-modules (ice-9 slib)) (require 'printf)" &amp;&amp;
109install -v -m755 -d /usr/share/doc/slib-&slib-version; &amp;&amp;
110install -v -m644 ANNOUNCE FAQ README slib.{txt,html} /usr/share/doc/slib-&slib-version;</userinput></screen>
111
112<!--
113 <para>If you built any of the optional documentation, install it using the
114 following command as the <systemitem class="username">root</systemitem>
115 user:</para>
116
117<screen role="root"><userinput>install -v -m644 slib.{pdf,dvi,ps} /usr/share/doc/slib-&slib-version;</userinput></screen>
118 -->
119 </sect2>
120
121 <sect2 role="commands">
122 <title>Command Explanations</title>
123
124 <para><command>sed -i 's|usr/lib|usr/share|' RScheme.init</command>:
125 This command is used to change the <envar>libdir</envar> variable embedded
126 in the script to match the installation.</para>
127
128 <para><option>--libdir=/usr/share</option>: This option puts the installed
129 in files <filename class="directory">/usr/share/slib</filename> instead of
130 <filename class="directory">/usr/lib/slib</filename>.</para>
131
132 <para><command>makeinfo ... --force ... </command>: This command creates
133 needed documentation, but needs the <option>--force</option> option to
134 overcome warnings that are flagged as errors in recent versions of
135 <command>makeinfo</command>.</para>
136
137 <para><command>ln -v -sf ../slib /usr/share/guile</command>: This command
138 puts a symbolic link to the <application>slib</application> files in
139 <application>Guile</application>'s default <quote>Implementation
140 Vicinity</quote>.</para>
141
142 <para><command>guile -c "(use-modules (ice-9 slib)) (require
143 'printf)"</command>: This command creates a guile catalog of the
144 <application>slib</application> files.</para>
145
146 </sect2>
147
148 <sect2 role="content">
149 <title>Contents</title>
150
151 <segmentedlist>
152 <segtitle>Installed Program</segtitle>
153 <segtitle>Installed Libraries</segtitle>
154 <segtitle>Installed Directory</segtitle>
155
156 <seglistitem>
157 <seg>slib</seg>
158 <seg>a <application>Scheme</application> library system</seg>
159 <seg>/usr/share/slib,
160 /usr/share/guile/site/2.0, and
161 /usr/share/doc/slib-&slib-version;</seg>
162 </seglistitem>
163 </segmentedlist>
164
165 <variablelist>
166 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
167 <?dbfo list-presentation="list"?>
168 <?dbhtml list-presentation="table"?>
169
170 <varlistentry id="slib-prog">
171 <term><command>slib</command></term>
172 <listitem>
173 <para>is a shell script used to initialize
174 <application>SLIB</application> in a named
175 <application>Scheme</application> implementation. It can also be
176 used to initialize an <application>SLIB</application> session using
177 a given executable.</para>
178 <indexterm zone="slib slib-prog">
179 <primary sortas="b-slib">slib</primary>
180 </indexterm>
181 </listitem>
182 </varlistentry>
183 </variablelist>
184 </sect2>
185</sect1>
Note: See TracBrowser for help on using the repository browser.