From mboxrd@z Thu Jan 1 00:00:00 1970 Path: main.gmane.org!not-for-mail From: rm@fabula.de Newsgroups: gmane.lisp.guile.user Subject: Re: Around again, and docs lead role Date: Sun, 4 May 2003 21:47:42 +0200 Sender: guile-user-bounces+guile-user=m.gmane.org@gnu.org Message-ID: <20030504194742.GB16222@www> References: <3E92E1B40021F4D7@pop3.tiscalinet.es> <20030503113403.GC5407@www> NNTP-Posting-Host: main.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Trace: main.gmane.org 1052074349 2088 80.91.224.249 (4 May 2003 18:52:29 GMT) X-Complaints-To: usenet@main.gmane.org NNTP-Posting-Date: Sun, 4 May 2003 18:52:29 +0000 (UTC) Cc: guile-user@gnu.org Original-X-From: guile-user-bounces+guile-user=m.gmane.org@gnu.org Sun May 04 20:52:27 2003 Return-path: Original-Received: from monty-python.gnu.org ([199.232.76.173]) by main.gmane.org with esmtp (Exim 3.35 #1 (Debian)) id 19COb4-0000XQ-00 for ; Sun, 04 May 2003 20:52:26 +0200 Original-Received: from localhost ([127.0.0.1] helo=monty-python.gnu.org) by monty-python.gnu.org with esmtp (Exim 4.10.13) id 19COc8-0006vc-04 for guile-user@m.gmane.org; Sun, 04 May 2003 14:53:32 -0400 Original-Received: from list by monty-python.gnu.org with tmda-scanned (Exim 4.10.13) id 19CObg-0006pW-00 for guile-user@gnu.org; Sun, 04 May 2003 14:53:04 -0400 Original-Received: from mail by monty-python.gnu.org with spam-scanned (Exim 4.10.13) id 19CObJ-0006Rp-00 for guile-user@gnu.org; Sun, 04 May 2003 14:52:45 -0400 Original-Received: from [217.22.192.104] (helo=www.elogos.de) by monty-python.gnu.org with esmtp (Exim 4.10.13) id 19COa8-0005cj-00 for guile-user@gnu.org; Sun, 04 May 2003 14:51:28 -0400 Original-Received: by www.elogos.de (Postfix, from userid 5001) id B8E2814580; Sun, 4 May 2003 21:47:42 +0200 (CEST) Original-To: Robert Uhl Content-Disposition: inline In-Reply-To: User-Agent: Mutt/1.5.3i X-BeenThere: guile-user@gnu.org X-Mailman-Version: 2.1b5 Precedence: list List-Id: General Guile related discussions List-Help: List-Post: List-Subscribe: , List-Archive: List-Unsubscribe: , Errors-To: guile-user-bounces+guile-user=m.gmane.org@gnu.org Xref: main.gmane.org gmane.lisp.guile.user:1899 X-Report-Spam: http://spam.gmane.org/gmane.lisp.guile.user:1899 On Sat, May 03, 2003 at 04:21:03PM -0600, Robert Uhl wrote: > rm@fabula.de writes: > > I had similar experiences. The existing documentation *is* very good, > > but i was astonished to find a few undocumented jewels (well, actually > > pretty neccessary stuff:) in the header files... > > Yup--exactly the problem I've had. There are a few things (which I > cannot recall anymore) In german we call it "Verdraengung" (repression) :-) > which have been right royal bears without docs. > Most of 'em I've solved by digging through headers, figuring them out > once, and then copy-pasting from then on. Not the most elegant way to > handle things, for certain:-} Well, it's a nice way to get comfortable living in the guts of guile, but scares application programmers who 'just' need guile as an embedded language. > > > But other than that it's been decent. Of course, I did have to > > > learn Scheme from SICP; it'd be nice were there an intro to Scheme > > > itself somewhere. > > > > Hmm, there a a handfull of pretty good Scheme intros available, why > > bother duplicating these efforts (better: write a Guile-specific > > addendum for one of these). > > Well, most of them seem to either be print books (which cost dough), or > written specifically for some incompatible dialect. ??? "Teach yourself Scheme in fixnum day" is free and takes greate care *not* to be dialect specific. SICP is available online as well ... > The bigger issue is > that I imagine most of us want Guile to become the extension package of > choice, even more popular than Perl or Python. To be successful at > that, it's useful to have a tutorial, particularly when the language is > as odd as a Lisp dialect can seem as first. Those unfamiliar with > Scheme who happen upon Guile are likely to skip past, scared away by the > parentheses and lack of a thorough introduction. I don't know. Somehow i have the feeling that a Scheme based scripting language will never be as popular as Perl or Python etc. (and i'm not even shure i want that). My first encounter with Scheme was ScruptFu (the Gimp's scripting language). There were a handfull of rather simple intros and close to no real documentation -- still i somehow managed to get my filter written (the anoying part where the missing features of the dialect -- anyone for a Guile/Gimp???). Ralf Mattes _______________________________________________ Guile-user mailing list Guile-user@gnu.org http://mail.gnu.org/mailman/listinfo/guile-user