From mboxrd@z Thu Jan 1 00:00:00 1970 Path: main.gmane.org!not-for-mail From: Neil Jerram Newsgroups: gmane.lisp.guile.user Subject: Re: Around again, and docs lead role Date: 07 May 2003 23:52:46 +0100 Sender: guile-user-bounces+guile-user=m.gmane.org@gnu.org Message-ID: 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 1052374990 16794 80.91.224.249 (8 May 2003 06:23:10 GMT) X-Complaints-To: usenet@main.gmane.org NNTP-Posting-Date: Thu, 8 May 2003 06:23:10 +0000 (UTC) Cc: Robert Uhl Original-X-From: guile-user-bounces+guile-user=m.gmane.org@gnu.org Thu May 08 08:23:06 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 19Dene-0004Kv-00 for ; Thu, 08 May 2003 08:22:38 +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 19Deos-0007aC-06 for guile-user@m.gmane.org; Thu, 08 May 2003 02:23:55 -0400 Original-Received: from list by monty-python.gnu.org with tmda-scanned (Exim 4.10.13) id 19Denf-0006dV-00 for guile-user@gnu.org; Thu, 08 May 2003 02:22:39 -0400 Original-Received: from mail by monty-python.gnu.org with spam-scanned (Exim 4.10.13) id 19Den3-0006Is-00 for guile-user@gnu.org; Thu, 08 May 2003 02:22:02 -0400 Original-Received: from mail.uklinux.net ([80.84.72.21] helo=s1.uklinux.net) by monty-python.gnu.org with esmtp (Exim 4.10.13) id 19DemE-0005Xo-00 for guile-user@gnu.org; Thu, 08 May 2003 02:21:10 -0400 Original-Received: from laruns.ossau.uklinux.net (bts-0859.dialup.zetnet.co.uk [194.247.51.91]) by s1.uklinux.net (8.11.6p2/8.11.6) with ESMTP id h486Kot04031; Thu, 8 May 2003 07:20:54 +0100 Original-Received: from laruns.ossau.uklinux.net.ossau.uklinux.net (localhost [127.0.0.1])ESMTP id 36193DC4D5; Wed, 7 May 2003 23:52:46 +0100 (BST) Original-To: rm@fabula.de In-Reply-To: <20030503113403.GC5407@www> Original-Lines: 40 User-Agent: Gnus/5.0808 (Gnus v5.8.8) Emacs/20.7 Original-cc: guile-user@gnu.org 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:1915 X-Report-Spam: http://spam.gmane.org/gmane.lisp.guile.user:1915 >>>>> "rm" == rm writes: rm> I started writing up some info last night but i'm not shure rm> whether the lack of documentation actually manifests some rm> public vs. private API issue. Now, no, it just manifests lack of documentation, I'm afraid :-) In the future, though, I do think it would be nice to reach a situation where documented <=> public and supported API rm> Hmm, there a a handfull of pretty good Scheme intros rm> available, why bother duplicating these efforts (better: write rm> a Guile-specific addendum for one of these). Tricky one, but I think if we get the rest of the GUile docs right, and bring more users on board, the need (or not) for this will become clearer. rm> Yes. And it would be _very_ helpfull if the documentation rm> would mention what modules need to be "used" for certain rm> functions [(ice-9 regexp) for regular expressions ...). Completely agree; it's just a bug if the necessary use-module isn't documented. Patches welcome! rm> Another question: there's some very good information in the rm> guile-workbook CVS module. But sometimes it's hard to tell rm> whether a piece is documenting an existing fact of Guile or rm> rather proposing a new impementation. IMO the starting assumption should be that workbook stuff is not implemented and so not valid as documentation. If you can identify any text that is valid, then ideally, please convert it to a patch against the manual. Regards, Neil _______________________________________________ Guile-user mailing list Guile-user@gnu.org http://mail.gnu.org/mailman/listinfo/guile-user