From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Julian Graham Newsgroups: gmane.lisp.guile.devel Subject: Re: r6rs library documentation Date: Sun, 20 Jun 2010 17:23:07 -0400 Message-ID: References: <871vdq9hnq.fsf@gnu.org> NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=ISO-8859-1 X-Trace: dough.gmane.org 1277069093 12053 80.91.229.12 (20 Jun 2010 21:24:53 GMT) X-Complaints-To: usenet@dough.gmane.org NNTP-Posting-Date: Sun, 20 Jun 2010 21:24:53 +0000 (UTC) Cc: guile-devel@gnu.org To: Andy Wingo Original-X-From: guile-devel-bounces+guile-devel=m.gmane.org@gnu.org Sun Jun 20 23:24:52 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.69) (envelope-from ) id 1OQS0K-0006Jd-Dp for guile-devel@m.gmane.org; Sun, 20 Jun 2010 23:24:48 +0200 Original-Received: from localhost ([127.0.0.1]:56016 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1OQS08-0001OC-Kz for guile-devel@m.gmane.org; Sun, 20 Jun 2010 17:24:24 -0400 Original-Received: from [140.186.70.92] (port=44802 helo=eggs.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1OQRzx-0000w7-Do for guile-devel@gnu.org; Sun, 20 Jun 2010 17:24:21 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.69) (envelope-from ) id 1OQRyv-0001V8-4d for guile-devel@gnu.org; Sun, 20 Jun 2010 17:23:10 -0400 Original-Received: from mail-iw0-f169.google.com ([209.85.214.169]:53821) by eggs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1OQRyu-0001Uv-Vw for guile-devel@gnu.org; Sun, 20 Jun 2010 17:23:09 -0400 Original-Received: by iwn39 with SMTP id 39so1023423iwn.0 for ; Sun, 20 Jun 2010 14:23:07 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=gamma; h=domainkey-signature:mime-version:received:received:in-reply-to :references:date:message-id:subject:from:to:cc:content-type; bh=OAjNoGfu/KuS6g6dO7BdEgHAfOKC9xbpFak4IIANUeA=; b=ceY24IyzbVGBhAifDaL4owyMLl+LmEgzl2FIOWf8dhacWbXREA3kUeFLe4xgOZWf2f iAZ3Kaf3d/XvjlxxFb5uQ6TBho5FLrRmO3fkzRyO6/eVJ8jt0q708UqeJEjTHztyTPi+ W5KFirL7apeCRmSbH7bdG5XFDx4U0AtTp2nfg= DomainKey-Signature: a=rsa-sha1; c=nofws; d=gmail.com; s=gamma; h=mime-version:in-reply-to:references:date:message-id:subject:from:to :cc:content-type; b=h4Mgtx6DXntZikWid1wxwnoZzL1MS/5cEvZqrpiZ1LnPa2tT4IoHeBXyxyybczdb+G rA7eHN/hwelLLF2olfhDNFDKASKP0MzStkHPCYH5TIcRUc+M8p6YKthY5ehv6zN1yW6I 0UH/bjuTPJ3kGW4T9bstJyw6BZrHZ+r6X/b+Q= Original-Received: by 10.231.184.73 with SMTP id cj9mr4904424ibb.1.1277068987669; Sun, 20 Jun 2010 14:23:07 -0700 (PDT) Original-Received: by 10.231.172.137 with HTTP; Sun, 20 Jun 2010 14:23:07 -0700 (PDT) In-Reply-To: X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 2) 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:10527 Archived-At: Hey Andy, > I think that Neil would probably have the most useful feedback, as I > think he has the most global view of the manual. I am inclined to think > that the level of detail is appropriate, though I imagine that Neil and > Brian are cringing at the weight of the extra pages on the press ;-) It > is an ongoing tension and I'm not sure how to resolve it. Sure. I haven't heard any opposition from Neil or Brian, though, so I'm inclined to commit this sometime this week, possibly by adapting it into the `R6RS Standard Libraries' node you created. That sound okay? > One nit: idioms like "See (@pxref{Environments}) for documentation." are > probably better as "@xref{Environments}, for documentation." Or ", for > more information." Will do. Regards, Julian