[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
RE: Guile Impressions
RE: Guile Impressions
Thu, 10 May 2001 16:39:30 +1200
From: Martin Grabmueller [SMTP:address@hidden
Sent: May 10, 2001 02:36
Subject: Re: Guile Impressions
> Over the last two or so years (since I joined the mailing list),
> several times people have suggested to write some Introductory
> User's Guide, Cook Book or however you will call it.
Good introductory material is important, but the Guide I was
goes far beyond that. It is a repository for expert user's shared
> But the problem is: Writing documentation is a hard task, requires
> much time and is not as rewarding as implementing some nifty new
> feature to show off with.
That depends on the individual, but Open Source software tends to
programmers in preference to technical writers.
> I think that the Guile Tutorial and the current Reference Manual
> a good start for using, embedding and extending Guile. The real
> problem (for me) seems to be the lack of documentation for the
> bits when embedding/extending Guile.
I have now had a quick look at the Guile 1.5 HTML manual which thi
at and it seems much improved over the Guile 1.4 Info one.
> There is a IMHO nice description in the Reference Manual
> about closures.
I agree that what is now present is much by far the most
I have read.
> I never have heard about ``Fluids'' in other languages, but I
> that they are not much more than global variables. In Guile, they
> thread-local variables.
I still have some queries about them, though, which the manual
> So I encourage all Guile users to look at the documentation, see
> is missing, send suggestions, fixes, etc. to address@hidden or
> create tutorial material we can either point people to or include
> the documentation.
I'd agree with the first, but Guile seems to suffer enough from
already without proliferating and duplicating it. One central
is a better idea in my opinion.
NOTICE: The information contained in this electronic mail message and any
attachments is confidential to Pavilion Technologies, Inc. or one of its
subsidiaries and may contain proprietary information or be legally
privileged. This message and any attachments are intended only for the
personal and confidential use of the designated recipient(s). If you are not
the intended recipient or an agent responsible for delivering it to the
intended recipient, you are hereby notified that you have recieved this
message in error, and that any review, dissemination, distribution or
copying of this message and any attachments is unauthorized and strictly
prohibited. If you have received this message in error, please notify me
immediately by telephone and electronic mail, and delete this message, any
attachments, and all copies thereof. Thank you very much
RE: Guile Impressions,
John Fitzgerald <=
RE: Guile Impressions, John Fitzgerald, 2001/05/11
Re: Guile Impressions, Neil Jerram, 2001/05/11
Re: Guile Impressions, Eric Moore, 2001/05/11
Re: Guile Impressions, Alejandro Forero Cuervo, 2001/05/11
- Re: Guile Impressions, (continued)