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: Tue, 15 May 2012 20:19:59 -0400 Message-ID: References: <87ehqxzke9.fsf@gnu.org> <87lil4vz9g.fsf@gnu.org> <87k40fszd5.fsf@gnu.org> <87likureni.fsf@gnu.org> <87ehqlkxa6.fsf@pobox.com> <8762bx2l24.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 1337127610 26776 80.91.229.3 (16 May 2012 00:20:10 GMT) X-Complaints-To: usenet@dough.gmane.org NNTP-Posting-Date: Wed, 16 May 2012 00:20:10 +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 Wed May 16 02:20:10 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 1SURyK-0007qV-4l for guile-devel@m.gmane.org; Wed, 16 May 2012 02:20:08 +0200 Original-Received: from localhost ([::1]:36048 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1SURyJ-0007Xr-F8 for guile-devel@m.gmane.org; Tue, 15 May 2012 20:20:07 -0400 Original-Received: from eggs.gnu.org ([208.118.235.92]:55778) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1SURyG-0007WI-Ra for guile-devel@gnu.org; Tue, 15 May 2012 20:20:06 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1SURyF-0004qt-0f for guile-devel@gnu.org; Tue, 15 May 2012 20:20:04 -0400 Original-Received: from mail-yx0-f169.google.com ([209.85.213.169]:43502) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1SURyE-0004m4-P2; Tue, 15 May 2012 20:20:02 -0400 Original-Received: by yenm7 with SMTP id m7so210566yen.0 for ; Tue, 15 May 2012 17:19:59 -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=xU1MZoriC2K/jkPHH4wxVQLd2f+DeUi6ujZ8AYJqsTI=; b=QFPu5Kwz20wGr1YlMnkbNjV04rHffSl3nvp1nd6DO2JUhL1KYmQVW2FpBfu9eCqfVX hjEM+ORhmWeY4jyC5wuVqn1hmGw+KVOx/FSS1RiQjDtGPSo9yE9C87vasT0ZnFUySMo7 3AfYqzYWWcCqRA/wbbG1QsQNZKcighOHdXubqIUIBGwWIU96d2mVBzH1lsLJJt3+uaMB CptbHsujGqrNM3/VXa7g2EvKjoh+o2fu7sLfK6sBFnDb52TFoDcNbq297FMU7J8+D8Hh ki2GzzWDRqdGXnZi867MJ2Olql8/6oQIKxoANoR1pAk7OGYwT4krumSFrNNWajtH6BO6 B+TA== Original-Received: by 10.42.88.135 with SMTP id c7mr398761icm.57.1337127599394; Tue, 15 May 2012 17:19:59 -0700 (PDT) Original-Received: by 10.42.29.200 with HTTP; Tue, 15 May 2012 17:19:59 -0700 (PDT) In-Reply-To: <8762bx2l24.fsf@gnu.org> X-Google-Sender-Auth: WLnbuQhSK2011ZbE5ObbCjoNBo0 X-detected-operating-system: by eggs.gnu.org: Genre and OS details not recognized. X-Received-From: 209.85.213.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:14457 Archived-At: Hi, On Tue, May 15, 2012 at 5:25 PM, Ludovic Court=E8s wrote: > Hi, > > Andy Wingo skribis: > >> What if we merge "Guile Modules" and "Standard Library" into one >> "Standard Library" node, and keep "API Reference" as it is? > > Sounds good to me. =A0Perhaps =93Standard Library=94 could have sub-secti= ons, > like =93Data Structures=94, =93Web=94, =93XML=94, =93Texinfo=94, etc. Yes, that sounds good to me too. However, On Tue, May 15, 2012 at 4:24 PM, Andy Wingo wrote: > For me the difference is that nodes of "API reference" describe > functionality that is often not segregated in modules, whereas "Guile > Modules" has nodes that describe modules. this distinction makes sense to me, but is not actually what is in place. For example, "LALR parsing", "Line Oriented and Delimited Text", "Block reading and writing", and "Local evaluation". How about having "API Reference" be the core module, and "Guile Modules" have everything else? I'm still not sure that's the right distinction though. Noah