From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: ludo@gnu.org (Ludovic =?iso-8859-1?Q?Court=E8s?=) Newsgroups: gmane.lisp.guile.devel Subject: Re: rfc: (ice-9 accumulate) Date: Mon, 11 Jan 2010 14:21:15 +0100 Message-ID: <87eilweq0k.fsf@gnu.org> References: <873a2fo8wc.fsf@ambire.localdomain> <8763799nwr.fsf@ambire.localdomain> NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Trace: ger.gmane.org 1263216396 25573 80.91.229.12 (11 Jan 2010 13:26:36 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Mon, 11 Jan 2010 13:26:36 +0000 (UTC) To: guile-devel@gnu.org Original-X-From: guile-devel-bounces+guile-devel=m.gmane.org@gnu.org Mon Jan 11 14:26:29 2010 Return-path: Envelope-to: guile-devel@m.gmane.org Original-Received: from lists.gnu.org ([199.232.76.165]) by lo.gmane.org with esmtp (Exim 4.50) id 1NUKFz-00088i-Nv for guile-devel@m.gmane.org; Mon, 11 Jan 2010 14:24:32 +0100 Original-Received: from localhost ([127.0.0.1]:41690 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1NUKG0-0006ln-AC for guile-devel@m.gmane.org; Mon, 11 Jan 2010 08:24:32 -0500 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1NUKFs-0006ib-3Z for guile-devel@gnu.org; Mon, 11 Jan 2010 08:24:24 -0500 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1NUKFn-0006Z7-8n for guile-devel@gnu.org; Mon, 11 Jan 2010 08:24:23 -0500 Original-Received: from [199.232.76.173] (port=51203 helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1NUKFn-0006Ys-5S for guile-devel@gnu.org; Mon, 11 Jan 2010 08:24:19 -0500 Original-Received: from lo.gmane.org ([80.91.229.12]:42195) by monty-python.gnu.org with esmtps (TLS-1.0:RSA_AES_256_CBC_SHA1:32) (Exim 4.60) (envelope-from ) id 1NUKFm-0003hp-72 for guile-devel@gnu.org; Mon, 11 Jan 2010 08:24:18 -0500 Original-Received: from list by lo.gmane.org with local (Exim 4.50) id 1NUKDs-0006UQ-3Y for guile-devel@gnu.org; Mon, 11 Jan 2010 14:22:20 +0100 Original-Received: from laptop-147-210-128-170.labri.fr ([147.210.128.170]) by main.gmane.org with esmtp (Gmexim 0.1 (Debian)) id 1AlnuQ-0007hv-00 for ; Mon, 11 Jan 2010 14:22:20 +0100 Original-Received: from ludo by laptop-147-210-128-170.labri.fr with local (Gmexim 0.1 (Debian)) id 1AlnuQ-0007hv-00 for ; Mon, 11 Jan 2010 14:22:20 +0100 X-Injected-Via-Gmane: http://gmane.org/ Original-Lines: 27 Original-X-Complaints-To: usenet@ger.gmane.org X-Gmane-NNTP-Posting-Host: laptop-147-210-128-170.labri.fr X-URL: http://www.fdn.fr/~lcourtes/ X-Revolutionary-Date: 22 =?iso-8859-1?Q?Niv=F4se?= an 218 de la =?iso-8859-1?Q?R=E9volution?= X-PGP-Key-ID: 0xEA52ECF4 X-PGP-Key: http://www.fdn.fr/~lcourtes/ludovic.asc X-PGP-Fingerprint: 83C4 F8E5 10A3 3B4C 5BEA D15D 77DD 95E2 EA52 ECF4 X-OS: x86_64-unknown-linux-gnu User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/23.1 (gnu/linux) Cancel-Lock: sha1:WbYcvStnz4KvsruZHO9JBiMv4GY= X-detected-operating-system: by monty-python.gnu.org: GNU/Linux 2.6 (newer, 3) 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:9852 Archived-At: Hello, Thien-Thi Nguyen writes: > There's lots of stuff in ice-9 that noone knows about, but I don't > think there's something like this. Hopefully we can document more of > it using the new (texinfo reflection) infrastructure. > > In reply to a similar comment from Ludovic, i offered to submit patches > for missing (ice-9 foo) documentation. I hereby revise that offer to > submit patches using this infrastructure, once i get around to playing > with it. I imagine it can't be much different from Guile 1.4.x's. I’d prefer if it were used only for non-ice-9 modules. I really sympathize with what the GCS says (info "(standards) Doc Strings and Manuals"): Some programming systems, such as Emacs, provide a documentation string for each function, command or variable. You may be tempted to write a reference manual by compiling the documentation strings and writing a little additional text to go around them--but you must not do it. That approach is a fundamental mistake. The text of well-written documentation strings will be entirely wrong for a manual. Thanks, Ludo’.