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: Sat, 3 May 2003 13:34:03 +0200 Sender: guile-user-bounces+guile-user=m.gmane.org@gnu.org Message-ID: <20030503113403.GC5407@www> References: <3E92E1B40021F4D7@pop3.tiscalinet.es> NNTP-Posting-Host: main.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=iso-8859-1 Content-Transfer-Encoding: 8bit X-Trace: main.gmane.org 1051958625 2757 80.91.224.249 (3 May 2003 10:43:45 GMT) X-Complaints-To: usenet@main.gmane.org NNTP-Posting-Date: Sat, 3 May 2003 10:43:45 +0000 (UTC) Cc: guile-user@gnu.org Original-X-From: guile-user-bounces+guile-user=m.gmane.org@gnu.org Sat May 03 12:43:43 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 19BuUY-0000iH-00 for ; Sat, 03 May 2003 12:43:43 +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 19BuRe-0006wh-00 for guile-user@m.gmane.org; Sat, 03 May 2003 06:40:42 -0400 Original-Received: from list by monty-python.gnu.org with tmda-scanned (Exim 4.10.13) id 19BuQb-0006NA-00 for guile-user@gnu.org; Sat, 03 May 2003 06:39:37 -0400 Original-Received: from mail by monty-python.gnu.org with spam-scanned (Exim 4.10.13) id 19BuQK-0005yH-00 for guile-user@gnu.org; Sat, 03 May 2003 06:39:20 -0400 Original-Received: from [217.22.192.104] (helo=www.elogos.de) by monty-python.gnu.org with esmtp (Exim 4.10.13) id 19BuPs-0005CZ-00 for guile-user@gnu.org; Sat, 03 May 2003 06:38:52 -0400 Original-Received: by www.elogos.de (Postfix, from userid 5001) id 743E014580; Sat, 3 May 2003 13:34:03 +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:1892 X-Report-Spam: http://spam.gmane.org/gmane.lisp.guile.user:1892 On Fri, May 02, 2003 at 10:40:12PM -0600, Robert Uhl wrote: > Ricard Mira writes: > > > > IMHO, the overall organization of the documentation isn't clear. > > My own problem has been a feeling that it's not complete. At least, > trying to figure out the C bindings has been...interesting. I had similar experiences. The existing documentation *is* very good, but i was astonished to find a few undocumentes jewels (well, actually pretty neccessary stuff:) in the header files ... I started writing up some info last night but i'm not shure whether the lack of documentation actually manifests some public vs. private API issue. > 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). > > > Also, I believe that "Part V: Guile Modules" should disappear, because > > features should be documented according to their functionality, not > > according to their origin or implementation (SLIB, SRFIs, etc.). > > OTOH, it's nice to know what's part of guile itself and what's not, at > least to some of us. Could go either way, I guess. Yes. And it would be _very_ helpfull if the documentation would mention what modules need to be "used" for certain functions [(ice-9 regexp) for regular expressions ...). Another question: there's some very good information in the guile-workbook CVS module. But sometimes it's hard to tell whether a piece is documenting an existing fact of Guile or rather proposing a new impementation. Ralf Mattes > > -- > Robert Uhl > Xristus usstôþ! Sunjaba usstôþ! > > > _______________________________________________ > Guile-user mailing list > Guile-user@gnu.org > http://mail.gnu.org/mailman/listinfo/guile-user _______________________________________________ Guile-user mailing list Guile-user@gnu.org http://mail.gnu.org/mailman/listinfo/guile-user