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,gmane.lisp.guile.devel Subject: Re: Around again, and docs lead role Date: 30 Apr 2003 23:47:39 +0100 Sender: guile-user-bounces+guile-user=m.gmane.org@gnu.org Message-ID: References: <3E92E1B40021F4D7@pop3.tiscalinet.es> <3E92E1B4002B0632@pop3.tiscalinet.es> NNTP-Posting-Host: main.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Trace: main.gmane.org 1051743100 4681 80.91.224.249 (30 Apr 2003 22:51:40 GMT) X-Complaints-To: usenet@main.gmane.org NNTP-Posting-Date: Wed, 30 Apr 2003 22:51:40 +0000 (UTC) Cc: guile-devel@gnu.org Original-X-From: guile-user-bounces+guile-user=m.gmane.org@gnu.org Thu May 01 00:51:36 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 19B0QJ-0001Cu-00 for ; Thu, 01 May 2003 00:51:35 +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 19B0Oo-0004kv-03 for guile-user@m.gmane.org; Wed, 30 Apr 2003 18:50:02 -0400 Original-Received: from list by monty-python.gnu.org with tmda-scanned (Exim 4.10.13) id 19B0OB-0003qZ-00 for guile-user@gnu.org; Wed, 30 Apr 2003 18:49:23 -0400 Original-Received: from mail by monty-python.gnu.org with spam-scanned (Exim 4.10.13) id 19B0Np-0002wj-00 for guile-user@gnu.org; Wed, 30 Apr 2003 18:49:03 -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 19B0Nl-0002on-00; Wed, 30 Apr 2003 18:48:58 -0400 Original-Received: from laruns.ossau.uklinux.net (bts-0176.dialup.zetnet.co.uk [194.247.48.176]) by s1.uklinux.net (8.11.6p2/8.11.6) with ESMTP id h3UMmrU23715; Wed, 30 Apr 2003 23:48:53 +0100 Original-Received: from laruns.ossau.uklinux.net.ossau.uklinux.net (localhost [127.0.0.1])ESMTP id 72275DC4D4; Wed, 30 Apr 2003 23:47:39 +0100 (BST) Original-To: ricardmm@tiscali.es In-Reply-To: <3E92E1B4002B0632@pop3.tiscalinet.es> (added by postmaster@netmail.tiscalinet.es) Original-Lines: 39 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:1887 gmane.lisp.guile.devel:2237 X-Report-Spam: http://spam.gmane.org/gmane.lisp.guile.user:1887 >>>>> "Ricard" == Ricard Mira writes: Ricard> Neil Jerram wrote: >> Thanks Ricard; please see also my reply to Thamer. What are your >> views so far about the existing docs? (I'm finishing for >> a cold hard assessment here, not compliments.) Ricard> IMHO, the overall organization of the documentation isn't Ricard> clear. But I know that documenting Guile is difficult, Ricard> because there are many different things to consider (C and Ricard> Scheme, Scheme and translated languages, applications and Ricard> Guile, etc.). Indeed. This also makes it difficult to assess the overall status of the docs, and in particular how close we are to being "finished". Ricard> I am thinking about these issues. That's great. I've been thinking about these over the last couple of days as well, but I'll save my half-formed thoughts for the moment so as not to prejudice yours. Ricard> Also, I believe that "Part V: Guile Modules" should Ricard> disappear, because features should be documented according Ricard> to their functionality, not according to their origin or Ricard> implementation (SLIB, SRFIs, etc.). Possibly yes. I think it might be useful to keep a dividing line between core Guile and available add-ons (e.g. SLIB and JACAL), but it may well be that the dividing line we have now is not in the right place. Bear in mind that in some mythical future there will be lots of Guile-using applications - already there are e.g. Gnucash, Lilypond, TeXmacs - that might provide useful library functions. I think it will be desirable at least to include pointers in the Guile manual to those applications' documentation, so we need somewhere to put those pointers. Best regards, Neil _______________________________________________ Guile-user mailing list Guile-user@gnu.org http://mail.gnu.org/mailman/listinfo/guile-user