source: general/prog/guile.xml@ 2e542e2

11.0 ken/refactor-virt lazarus qt5new trunk
Last change on this file since 2e542e2 was 2e542e2, checked in by Bruce Dubbs <bdubbs@…>, 5 months ago

Update to guile-3.0.6

  • Property mode set to 100644
File size: 7.4 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 guile-download-http "&gnu-http;/guile/guile-&guile-version;.tar.xz">
8 <!ENTITY guile-download-ftp "&gnu-ftp;/guile/guile-&guile-version;.tar.xz">
9 <!ENTITY guile-md5sum "0efa89c2cda4bb0132ded28bbeb86794">
10 <!ENTITY guile-size "13 MB">
11 <!ENTITY guile-buildsize "202 MB (add 4 MB for tests)">
12 <!ENTITY guile-time "1.7 SBU (Using parallelism=4; add 0.4 SBU for tests)">
13]>
14
15<sect1 id="guile" xreflabel="Guile-&guile-version;">
16<?dbhtml filename="guile.html"?>
17
18 <sect1info>
19 <date>$Date$</date>
20 </sect1info>
21
22 <title>Guile-&guile-version;</title>
23
24 <indexterm zone="guile">
25 <primary sortas="a-Guile">Guile</primary>
26 </indexterm>
27
28 <sect2 role="package">
29 <title>Introduction to Guile</title>
30
31 <para>
32 The <application>Guile</application> package contains the GNU Project's
33 extension language library. <application>Guile</application> also
34 contains a stand alone <application>Scheme</application> interpreter.
35 </para>
36
37 &lfs101_checked;
38
39 <bridgehead renderas="sect3">Package Information</bridgehead>
40 <itemizedlist spacing="compact">
41 <listitem>
42 <para>
43 Download (HTTP): <ulink url="&guile-download-http;"/>
44 </para>
45 </listitem>
46 <listitem>
47 <para>
48 Download (FTP): <ulink url="&guile-download-ftp;"/>
49 </para>
50 </listitem>
51 <listitem>
52 <para>
53 Download MD5 sum: &guile-md5sum;
54 </para>
55 </listitem>
56 <listitem>
57 <para>
58 Download size: &guile-size;
59 </para>
60 </listitem>
61 <listitem>
62 <para>
63 Estimated disk space required: &guile-buildsize;
64 </para>
65 </listitem>
66 <listitem>
67 <para>
68 Estimated build time: &guile-time;
69 </para>
70 </listitem>
71 </itemizedlist>
72
73 <bridgehead renderas="sect3">Guile Dependencies</bridgehead>
74
75 <bridgehead renderas="sect4">Required</bridgehead>
76 <para role="required">
77 <xref linkend="gc"/> and
78 <xref linkend="libunistring"/>
79 </para>
80
81 <bridgehead renderas="sect4">Optional</bridgehead>
82 <para role="optional">
83 <xref linkend="emacs"/> and
84 <xref linkend="gdb"/> (run-time only dependencies).
85 </para>
86
87 <para condition="html" role="usernotes">
88 User Notes: <ulink url="&blfs-wiki;/guile"/>
89 </para>
90 </sect2>
91
92 <sect2 role="installation">
93 <title>Installation of Guile</title>
94
95 <para>
96 Install <application>Guile</application> by running the following
97 commands:
98 </para>
99
100<screen><userinput>./configure --prefix=/usr \
101 --disable-static \
102 --docdir=/usr/share/doc/guile-&guile-version; &amp;&amp;
103make &amp;&amp;
104make html &amp;&amp;
105
106makeinfo --plaintext -o doc/r5rs/r5rs.txt doc/r5rs/r5rs.texi &amp;&amp;
107makeinfo --plaintext -o doc/ref/guile.txt doc/ref/guile.texi</userinput></screen>
108
109 <para>
110 To test the results, issue: <command>./check-guile</command>.
111 </para>
112 <!-- 10 of the numbers tests fail on i686. This should probably be looked
113 into at a later point in time. -renodr -->
114
115 <para>
116 Now, as the <systemitem class="username">root</systemitem> user:
117 </para>
118
119<screen role="root"><userinput>make install &amp;&amp;
120make install-html &amp;&amp;
121
122mkdir -p /usr/share/gdb/auto-load/usr/lib &amp;&amp;
123mv /usr/lib/libguile-*-gdb.scm /usr/share/gdb/auto-load/usr/lib &amp;&amp;
124mv /usr/share/doc/guile-&guile-version;/{guile.html,ref} &amp;&amp;
125mv /usr/share/doc/guile-&guile-version;/r5rs{.html,} &amp;&amp;
126
127find examples -name "Makefile*" -delete &amp;&amp;
128cp -vR examples /usr/share/doc/guile-&guile-version; &amp;&amp;
129
130for DIRNAME in r5rs ref; do
131 install -v -m644 doc/${DIRNAME}/*.txt \
132 /usr/share/doc/guile-&guile-version;/${DIRNAME}
133done &amp;&amp;
134unset DIRNAME</userinput></screen>
135
136 </sect2>
137
138 <sect2 role="commands">
139 <title>Command Explanations</title>
140
141 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
142 href="../../xincludes/static-libraries.xml"/>
143
144 </sect2>
145
146 <sect2 role="content">
147 <title>Contents</title>
148
149 <segmentedlist>
150 <segtitle>Installed Programs</segtitle>
151 <segtitle>Installed Libraries</segtitle>
152 <segtitle>Installed Directories</segtitle>
153
154 <seglistitem>
155 <seg>
156 guild, guile, guile-config, guile-snarf and guile-tools
157 </seg>
158 <seg>
159 libguile-3.0.so and guile-readline.so
160 </seg>
161 <seg>
162 /usr/include/guile,
163 /usr/lib/guile,
164 /usr/share/doc/guile-&guile-version; and
165 /usr/share/guile
166 </seg>
167 </seglistitem>
168 </segmentedlist>
169
170 <variablelist>
171 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
172 <?dbfo list-presentation="list"?>
173 <?dbhtml list-presentation="table"?>
174
175 <varlistentry id="guile-prog">
176 <term><command>guile</command></term>
177 <listitem>
178 <para>
179 is a stand-alone Scheme interpreter for
180 <application>Guile</application>
181 </para>
182 <indexterm zone="guile guile-prog">
183 <primary sortas="b-guile">guile</primary>
184 </indexterm>
185 </listitem>
186 </varlistentry>
187
188 <varlistentry id="guile-config">
189 <term><command>guile-config</command></term>
190 <listitem>
191 <para>
192 is a <application>Guile</application> script which provides the
193 information necessary to link your programs against the
194 <application>Guile</application> library, in much the same way
195 PkgConfig does
196 </para>
197 <indexterm zone="guile guile-config">
198 <primary sortas="b-guile-config">guile-config</primary>
199 </indexterm>
200 </listitem>
201 </varlistentry>
202
203 <varlistentry id="guile-snarf">
204 <term><command>guile-snarf</command></term>
205 <listitem>
206 <para>
207 is a script to parse declarations in your
208 <application>C</application> code for
209 <application>Scheme</application> visible
210 <application>C</application> functions
211 </para>
212 <indexterm zone="guile guile-snarf">
213 <primary sortas="b-guile-snarf">guile-snarf</primary>
214 </indexterm>
215 </listitem>
216 </varlistentry>
217
218 <varlistentry id="guild">
219 <term><command>guild</command></term>
220 <listitem>
221 <para>
222 is a wrapper program installed along with <command>guile</command>,
223 which knows where a particular module is installed and calls it,
224 passing its arguments to the program
225 </para>
226 <indexterm zone="guile guild">
227 <primary sortas="b-guild">guild</primary>
228 </indexterm>
229 </listitem>
230 </varlistentry>
231
232 <varlistentry id="guile-tools">
233 <term><command>guile-tools</command></term>
234 <listitem>
235 <para>
236 is a symlink to <command>guild</command>
237 </para>
238 <indexterm zone="guile guile-tools">
239 <primary sortas="b-guile-tools">guile-tools</primary>
240 </indexterm>
241 </listitem>
242 </varlistentry>
243
244 </variablelist>
245
246 </sect2>
247
248</sect1>
Note: See TracBrowser for help on using the repository browser.