SLIB use: Documentation and ice-9/slib.scm

SLIB use: Documentation and ice-9/slib.scm

[Alan Grover]

Kevin Ryde wrote:
> Alan Grover <awgrover@msen.com> writes:
> 
>>Summary: The documentation on SLIB use is inadequate and/or out-of-date
>>Guile version 1.6.4, "edition 1.0 of the reference manual, corresponding
>>to Guile version 1.6.4"
> 
> 
> That stuff hasn't been kept up to date, and the slib manual is the
> best place to look for it, so I think I'll remove it, just leaving a
> pointer to slib.

The ice-9/slib.scm module should be removed. It appears to be broken.

The Guile documentation should refer to the SLIB README file (sections
on loading the initialization file, and implementation specific
instructions).


The documentation included with SLIB 3a2 appears to be correct for Guile
1.6.4. The SLIB Changelog indicates that the documentation was updated
for Guile 1.6.4 at 2005-04-15, for SLIB version 3a1.

These instructions could be repeated in the Guile manual since they seem
stable for a while:

To install SLIB:
* Unpack the SLIB distribution as appropriate to RPM/tar/etc.
* Move/link SLIB to one of the %load-path directories. For example,
/usr/share/guile/slib is common.
* Create the catalog ("slibcat"), it is created in the parent directory
of slib [verify behavior when slib is a link].
** With permissions to create slibcat:
% guile -l slib/guile.init
guile> (require 'new-catalog)
guile> quit
** You could verify that slibcat was created and is readable by "other":
% ls -l  /usr/share/guile/slibcat
* Provide ice-9/slib functionality:
** Locate the ice9 directory (see %load-path, typically
/usr/share/guile/ice-9)
** Create a ice-9/guile.scm file (e.g. site/ice-9/guile.scm) with these
contents, readable by other:
(define-module (ice-9 slib))
(load-from-path "slib/guile.init")


To use SLIB:

If the ice-9/slib was conveniently setup:
(use-modules (ice-9 slib))

If the ice-9/slib module was not provided:
(load-from-path "slib/guile.init")

If the slib package is not in the %load-path:
(load "/some/where/slib/guile.init")
; NB: in this case, 'require may not find SLIB modules, see the SLIB
documentation


-- 
Alan Grover
awgrover@mail.msen.com
+1.734.476.0969



_______________________________________________
Guile-devel mailing list
Guile-devel@gnu.org
http://lists.gnu.org/mailman/listinfo/guile-devel

Re: SLIB use: Documentation and ice-9/slib.scm

[Kevin Ryde]

Alan Grover <awgrover@mail.msen.com> writes:
>
> The ice-9/slib.scm module should be removed. It appears to be broken.

Bit rot :(.

> The Guile documentation should refer to the SLIB README file (sections
> on loading the initialization file, and implementation specific
> instructions).

Yep.

> These instructions could be repeated in the Guile manual since they seem
> stable for a while:

No thanks, I think slib install instructions should be in slib.

> (define-module (ice-9 slib))
> (load-from-path "slib/guile.init")

That's subtly different, normal "guile -lguile.init" goes into the
guile-user module.  But something like

	(define-module (ice-9 slib))
	(define-module (guile-user))
	(load "slib/guile.init")

might be close, assuming the guile.init can be found.  I forget what
it was that didn't work when I tried this though (maybe only with the
cvs head, not sure).

> (load "/some/where/slib/guile.init")
> ; NB: in this case, 'require may not find SLIB modules, see the SLIB
> documentation

I think it's sort of supposed to work.


_______________________________________________
Guile-devel mailing list
Guile-devel@gnu.org
http://lists.gnu.org/mailman/listinfo/guile-devel