From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Neil Jerram Newsgroups: gmane.lisp.guile.devel Subject: Re: [PATCH] Document pitfalls with `define-class' and `#:init-value' Date: Wed, 04 Oct 2006 23:19:38 +0100 Message-ID: <87vemz3erp.fsf@ossau.uklinux.net> References: <87oe0qt9vn.fsf@laas.fr> <87pskxke3a.fsf@zip.com.au> <87slptz4mv.fsf@laas.fr> <87acc0lm49.fsf@zip.com.au> <878xr4kyho.fsf@laas.fr> <87lkoalvk7.fsf@ossau.uklinux.net> <87d59k4ck3.fsf@laas.fr> <87psdh9p0d.fsf@ossau.uklinux.net> <87bqp0dezx.fsf@zip.com.au> <87ac4k8lvd.fsf@ossau.uklinux.net> <87hcyrh5eu.fsf@zip.com.au> <874purh3r0.fsf@zip.com.au> NNTP-Posting-Host: main.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Trace: sea.gmane.org 1160000420 19551 80.91.229.2 (4 Oct 2006 22:20:20 GMT) X-Complaints-To: usenet@sea.gmane.org NNTP-Posting-Date: Wed, 4 Oct 2006 22:20:20 +0000 (UTC) Original-X-From: guile-devel-bounces+guile-devel=m.gmane.org@gnu.org Thu Oct 05 00:20:18 2006 Return-path: Envelope-to: guile-devel@m.gmane.org Original-Received: from lists.gnu.org ([199.232.76.165]) by ciao.gmane.org with esmtp (Exim 4.43) id 1GVF5w-0004kI-1e for guile-devel@m.gmane.org; Thu, 05 Oct 2006 00:20:04 +0200 Original-Received: from localhost ([127.0.0.1] helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1GVF5v-00088y-JN for guile-devel@m.gmane.org; Wed, 04 Oct 2006 18:20:03 -0400 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1GVF5q-00088i-4q for guile-devel@gnu.org; Wed, 04 Oct 2006 18:19:58 -0400 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1GVF5o-00087C-HW for guile-devel@gnu.org; Wed, 04 Oct 2006 18:19:57 -0400 Original-Received: from [199.232.76.173] (helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1GVF5o-00086t-B2 for guile-devel@gnu.org; Wed, 04 Oct 2006 18:19:56 -0400 Original-Received: from [80.84.72.33] (helo=mail3.uklinux.net) by monty-python.gnu.org with esmtp (Exim 4.52) id 1GVFCK-0006pL-Gf for guile-devel@gnu.org; Wed, 04 Oct 2006 18:26:40 -0400 Original-Received: from laruns (host86-145-154-50.range86-145.btcentralplus.com [86.145.154.50]) by mail3.uklinux.net (Postfix) with ESMTP id C0C1F40A59B for ; Wed, 4 Oct 2006 22:19:54 +0000 (UTC) Original-Received: from laruns (laruns [127.0.0.1]) by laruns (Postfix) with ESMTP id 3949F6F6D4 for ; Wed, 4 Oct 2006 23:19:38 +0100 (BST) Original-To: Guile-Devel In-Reply-To: <874purh3r0.fsf@zip.com.au> (Kevin Ryde's message of "Fri, 29 Sep 2006 11:15:47 +1000") User-Agent: Gnus/5.1007 (Gnus v5.10.7) Emacs/21.4 (gnu/linux) X-BeenThere: guile-devel@gnu.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: "Developers list for Guile, the GNU extensibility library" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Original-Sender: guile-devel-bounces+guile-devel=m.gmane.org@gnu.org Errors-To: guile-devel-bounces+guile-devel=m.gmane.org@gnu.org Xref: news.gmane.org gmane.lisp.guile.devel:6134 Archived-At: Kevin Ryde writes: > I wrote: >> >> Yes. > > (Which is not to say I'm sure it'd look better, just an idea. Those > bits don't seem like they should be terribly difficult, a niceish or > typical example of each is probably plenty.) I'm inclined not to do this right now. We probably should do something like this in the future, when we come to do a fine detail "could this doc appear in a printed book" kind of review, because the node as it stands has no framing or context at all. Then I think we may find that when some of text is moved outside the deffn's, it will make sense to split up the deffn's as you've suggested. But I don't think it makes sense to make this kind of change now, and looking at just one node in isolation. (FYI I'm currently trying to do this level of review for the parts of the manual related to debugging, and making gradual progress on it. This isn't because I have secret book-publishing plans :-), it's just because I want to make sure that it's all correct, and I'd like to be able to say that these sections of the manual are in their final form (subject to future changes, of course).) Regards, Neil _______________________________________________ Guile-devel mailing list Guile-devel@gnu.org http://lists.gnu.org/mailman/listinfo/guile-devel