From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Noah Lavine Newsgroups: gmane.lisp.guile.devel Subject: Re: [PATCH] Turn on more documentation Date: Mon, 14 May 2012 10:05:38 -0400 Message-ID: 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=windows-1252 Content-Transfer-Encoding: quoted-printable X-Trace: dough.gmane.org 1337004364 26906 80.91.229.3 (14 May 2012 14:06:04 GMT) X-Complaints-To: usenet@dough.gmane.org NNTP-Posting-Date: Mon, 14 May 2012 14:06:04 +0000 (UTC) Cc: guile-devel@gnu.org To: =?ISO-8859-1?Q?Ludovic_Court=E8s?= Original-X-From: guile-devel-bounces+guile-devel=m.gmane.org@gnu.org Mon May 14 16:06: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 1STvuR-0003QE-2l for guile-devel@m.gmane.org; Mon, 14 May 2012 16:05:59 +0200 Original-Received: from localhost ([::1]:52852 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1STvuQ-0007RL-Ec for guile-devel@m.gmane.org; Mon, 14 May 2012 10:05:58 -0400 Original-Received: from eggs.gnu.org ([208.118.235.92]:39721) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1STvuF-0007Or-Vo for guile-devel@gnu.org; Mon, 14 May 2012 10:05:56 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1STvu9-0004XP-62 for guile-devel@gnu.org; Mon, 14 May 2012 10:05:47 -0400 Original-Received: from mail-gg0-f169.google.com ([209.85.161.169]:34577) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1STvu8-0004Wd-LW; Mon, 14 May 2012 10:05:41 -0400 Original-Received: by ggm4 with SMTP id 4so2389435ggm.0 for ; Mon, 14 May 2012 07:05:38 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=mime-version:sender:in-reply-to:references:date :x-google-sender-auth:message-id:subject:from:to:cc:content-type :content-transfer-encoding; bh=kNLVpa9Wzkqc5/pcUdtll1/VpumQ9XkG7LFhfG0Q5n0=; b=x6+Kf5e8PvIIZRGR3XNevbJyVDrlNnoUaKCUUArDWiW43fyQYIU5JLJcrv1vdK2tC8 Z3n3em99+hI5T/C5ENg8j6AKB4BfHBqwNCR3Q8eHmv/vIorBDu2M/IXE6c3zmcDUBbDr 2B5f3HeXqMHEGcdE0db0qD2rVjgFH9W67QwKBxDVUIOZ+bcVnLrOeA5j5geHyhZ3aGR+ YYqyCBFv5rYefThf5HOS88oFHVg+5hGvatUf051KvpGv7d4LH3/+VY26QU/++LV4ow6F +Phrv3Dyvw5jKNNQggaP/xeWavOCm2Vczm0iXnUzfm1XKxLenp5OVFnOJArGM/S/3crN uXQA== Original-Received: by 10.42.88.135 with SMTP id c7mr3688343icm.57.1337004338310; Mon, 14 May 2012 07:05:38 -0700 (PDT) Original-Received: by 10.42.29.200 with HTTP; Mon, 14 May 2012 07:05:38 -0700 (PDT) In-Reply-To: <87k40fszd5.fsf@gnu.org> X-Google-Sender-Auth: RbnDGzx7HLVhLjh07hPZ11fQ6Mk X-detected-operating-system: by eggs.gnu.org: Genre and OS details not recognized. X-Received-From: 209.85.161.169 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:14415 Archived-At: Hello, > From =93Organisation of this Manual=94: > > =A0*Chapter 6: Guile API Reference* > =A0 =A0 =A0 This part of the manual documents the Guile API in > =A0 =A0 =A0 functionality-based groups with the Scheme and C interfaces > =A0 =A0 =A0 presented side by side. > > =A0*Chapter 7: Guile Modules* > =A0 =A0 =A0 Describes some important modules, distributed as part of the = Guile > =A0 =A0 =A0 distribution, that extend the functionality provided by the G= uile > =A0 =A0 =A0 Scheme core. > > So I think the idea is for core functionality to be in Chapter 6, and > =93peripheral things=94 to be in Chapter 7. =A0The modules you mention wo= uld > fall in the second category, I think. That's certainly enough for this project, but I think in general this distinction is not very clear. How would someone guess what functionality is considered "core" and what functionality is an extension? My first guess would be that things in the (guile) module are core and everything else is an extension, but that is not the case. Does this come from an earlier time when the Guile core was distributed separately from the Guile libraries? 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? Noah