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, 14 May 2012 17:00:33 +0200 Message-ID: <87likureni.fsf@gnu.org> References: <87ehqxzke9.fsf@gnu.org> <87lil4vz9g.fsf@gnu.org> <87k40fszd5.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 1337007668 23554 80.91.229.3 (14 May 2012 15:01:08 GMT) X-Complaints-To: usenet@dough.gmane.org NNTP-Posting-Date: Mon, 14 May 2012 15:01:08 +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 14 17:01:03 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 1STwlZ-0000Js-CC for guile-devel@m.gmane.org; Mon, 14 May 2012 17:00:53 +0200 Original-Received: from localhost ([::1]:49945 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1STwlY-0007FR-SV for guile-devel@m.gmane.org; Mon, 14 May 2012 11:00:52 -0400 Original-Received: from eggs.gnu.org ([208.118.235.92]:56020) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1STwlT-0007FM-CE for guile-devel@gnu.org; Mon, 14 May 2012 11:00:51 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1STwlK-00082D-Lb for guile-devel@gnu.org; Mon, 14 May 2012 11:00:46 -0400 Original-Received: from xanadu.aquilenet.fr ([88.191.123.111]:51119) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1STwlK-000827-Fs for guile-devel@gnu.org; Mon, 14 May 2012 11:00:38 -0400 Original-Received: from localhost (xanadu.aquilenet.fr [127.0.0.1]) by xanadu.aquilenet.fr (Postfix) with ESMTP id 035EB13936; Mon, 14 May 2012 17:00:35 +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 r22-Hp4X0cjA; Mon, 14 May 2012 17:00:34 +0200 (CEST) Original-Received: from pluto (unknown [193.50.110.130]) by xanadu.aquilenet.fr (Postfix) with ESMTPSA id A5C601392C; Mon, 14 May 2012 17:00:34 +0200 (CEST) X-URL: http://www.fdn.fr/~lcourtes/ X-Revolutionary-Date: 26 =?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, 14 May 2012 10:05:38 -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:14418 Archived-At: Hi! Noah Lavine skribis: > Unless there is going to be some other distinction between core and > extensions, it would seem more natural to me to document everything by > functionality, in the same part of the manual. Some sections would > correspond to modules, because modules are also supposed to group > things by functionality, but that would not be the rule for how the > manual worked. What do you think? I tend to agree, but then I=E2=80=99m not sure what a better sectioning wou= ld be in practice. Any ideas? Perhaps this could be worked out in =E2=80=98master=E2=80=99, so that node = names don=E2=80=99t change for 2.0.x. Thanks, Ludo=E2=80=99.