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: [PATCH] Turn on more documentation Date: Mon, 07 May 2012 16:31:23 +0200 Message-ID: <87lil4vz9g.fsf@gnu.org> References: <87ehqxzke9.fsf@gnu.org> NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable X-Trace: dough.gmane.org 1336401103 29029 80.91.229.3 (7 May 2012 14:31:43 GMT) X-Complaints-To: usenet@dough.gmane.org NNTP-Posting-Date: Mon, 7 May 2012 14:31:43 +0000 (UTC) Cc: guile-devel@gnu.org To: Noah Lavine Original-X-From: guile-devel-bounces+guile-devel=m.gmane.org@gnu.org Mon May 07 16:31:42 2012 Return-path: Envelope-to: guile-devel@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by plane.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1SROyQ-0003r6-DA for guile-devel@m.gmane.org; Mon, 07 May 2012 16:31:38 +0200 Original-Received: from localhost ([::1]:35508 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1SROyP-0007AM-Os for guile-devel@m.gmane.org; Mon, 07 May 2012 10:31:37 -0400 Original-Received: from eggs.gnu.org ([208.118.235.92]:42551) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1SROyI-00070V-R9 for guile-devel@gnu.org; Mon, 07 May 2012 10:31:36 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1SROyE-0002BW-N3 for guile-devel@gnu.org; Mon, 07 May 2012 10:31:30 -0400 Original-Received: from xanadu.aquilenet.fr ([88.191.123.111]:35611) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1SROyE-0002BH-Ge for guile-devel@gnu.org; Mon, 07 May 2012 10:31:26 -0400 Original-Received: from localhost (xanadu.aquilenet.fr [127.0.0.1]) by xanadu.aquilenet.fr (Postfix) with ESMTP id 9B333961E; Mon, 7 May 2012 16:31:24 +0200 (CEST) Original-Received: from xanadu.aquilenet.fr ([127.0.0.1]) by localhost (xanadu.aquilenet.fr [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id Di7quqwxvV8m; Mon, 7 May 2012 16:31:24 +0200 (CEST) Original-Received: from pluto (unknown [193.50.110.130]) by xanadu.aquilenet.fr (Postfix) with ESMTPSA id 4EE0C961D; Mon, 7 May 2012 16:31:24 +0200 (CEST) X-URL: http://www.fdn.fr/~lcourtes/ X-Revolutionary-Date: 19 =?iso-8859-1?Q?Flor=E9al?= an 220 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 In-Reply-To: (Noah Lavine's message of "Mon, 7 May 2012 08:30:20 -0400") User-Agent: Gnus/5.110018 (No Gnus v0.18) Emacs/24.0.93 (gnu/linux) X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 3) X-Received-From: 88.191.123.111 X-BeenThere: guile-devel@gnu.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: "Developers list for Guile, the GNU extensibility library" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: guile-devel-bounces+guile-devel=m.gmane.org@gnu.org Original-Sender: guile-devel-bounces+guile-devel=m.gmane.org@gnu.org Xref: news.gmane.org gmane.lisp.guile.devel:14368 Archived-At: Hi! Noah Lavine skribis: > Hello, > >> The problem is that the auto-generated =E2=80=9CStandard Library=E2=80= =9D section looks >> very poor in comparison to the rest of the manual. =C2=A0So we should re= ally >> try hard to write good doc by hands for these, and come up with a handy >> structure (instead of one node per module, all under =E2=80=9CStandard >> Library=E2=80=9D). > > I could do that pretty easily, but I'm afraid that documentation that > isn't in the same file as the code would tend to be updated less often > than documentation in the same file. All of our manual except =E2=80=9CStandard Library=E2=80=9D is maintained t= his way. It takes discipline to keep up-to-date, but it also leads to a better manual IMO. >> However, I believe Thien-Thi=E2=80=99s Guile 1.4 has good doc for at lea= st some >> of these modules, and it would be great if it could be incorporated. >> >> WDYT? > > That would be ideal, but I was concerned that the documentation wasn't > copyrighted by the FSF. Unless Thien-Thi is interested in contributing > it, of course. Yes, I was hoping he would be reading us, let=E2=80=99s see. ;-) Thanks, Ludo=E2=80=99.