From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Andy Wingo Newsgroups: gmane.lisp.guile.devel Subject: Re: r6rs library documentation Date: Mon, 14 Jun 2010 23:34:32 +0200 Message-ID: References: <871vdq9hnq.fsf@gnu.org> NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Trace: dough.gmane.org 1276551450 6992 80.91.229.12 (14 Jun 2010 21:37:30 GMT) X-Complaints-To: usenet@dough.gmane.org NNTP-Posting-Date: Mon, 14 Jun 2010 21:37:30 +0000 (UTC) Cc: guile-devel@gnu.org To: Julian Graham Original-X-From: guile-devel-bounces+guile-devel=m.gmane.org@gnu.org Mon Jun 14 23:37:27 2010 connect(): No such file or directory 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 1OOHLQ-0005q0-74 for guile-devel@m.gmane.org; Mon, 14 Jun 2010 23:37:24 +0200 Original-Received: from localhost ([127.0.0.1]:48398 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1OOHLP-0001Pc-9r for guile-devel@m.gmane.org; Mon, 14 Jun 2010 17:37:23 -0400 Original-Received: from [140.186.70.92] (port=53394 helo=eggs.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1OOHLJ-0001Le-Ry for guile-devel@gnu.org; Mon, 14 Jun 2010 17:37:19 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.69) (envelope-from ) id 1OOHLI-0006tN-I1 for guile-devel@gnu.org; Mon, 14 Jun 2010 17:37:17 -0400 Original-Received: from a-pb-sasl-quonix.pobox.com ([208.72.237.25]:35897 helo=sasl.smtp.pobox.com) by eggs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1OOHLI-0006tI-GH for guile-devel@gnu.org; Mon, 14 Jun 2010 17:37:16 -0400 Original-Received: from sasl.smtp.pobox.com (unknown [127.0.0.1]) by a-pb-sasl-quonix.pobox.com (Postfix) with ESMTP id 4862CBB4BF; Mon, 14 Jun 2010 17:37:16 -0400 (EDT) DKIM-Signature: v=1; a=rsa-sha1; c=relaxed; d=pobox.com; h=from:to:cc :subject:references:date:in-reply-to:message-id:mime-version :content-type; s=sasl; bh=m1Ffbhn4+7gjOMCgKUHE2wxzgWw=; b=HVD/b+ HymNOABt1B006kDmVaJ90bx9B6LJ3Oo4T/c33WI1kq1QhXb86yp6lYeznZ1whjde 8Qx8c94P/j2jUXrV5wgRu0ksBE4gDffvVjee5o3WihZBXpvbXsrmQd/HcMWaW4Z5 QWYKxJkmnGhoq6Ydl3s3krER3wr6BBXfq9GmY= DomainKey-Signature: a=rsa-sha1; c=nofws; d=pobox.com; h=from:to:cc :subject:references:date:in-reply-to:message-id:mime-version :content-type; q=dns; s=sasl; b=I1Nc3gZCd4iE0jqyldRaX76S4jgwRInf reU1oa70EryQrUAjx3eBoEed9cyU7YhPoBM0v8xmfuSevaITO37ihjlQxUvSBqNI bgbBdI9rDWHr4+D8lPRd2klXJU/nnHOAa1hKrJ7vxucnnyF2W+bKoaUR8iXghG1L h6gs0VmvL4U= Original-Received: from a-pb-sasl-quonix. (unknown [127.0.0.1]) by a-pb-sasl-quonix.pobox.com (Postfix) with ESMTP id DD973BB4BB; Mon, 14 Jun 2010 17:37:14 -0400 (EDT) Original-Received: from unquote (unknown [81.39.158.44]) (using TLSv1 with cipher DHE-RSA-AES256-SHA (256/256 bits)) (No client certificate requested) by a-pb-sasl-quonix.pobox.com (Postfix) with ESMTPSA id 3A6EFBB4BA; Mon, 14 Jun 2010 17:37:12 -0400 (EDT) In-Reply-To: (Julian Graham's message of "Sat, 12 Jun 2010 15:32:44 -0400") User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/23.0.92 (gnu/linux) X-Pobox-Relay-ID: FFA24E46-77FC-11DF-A486-9056EE7EF46B-02397024!a-pb-sasl-quonix.pobox.com X-detected-operating-system: by eggs.gnu.org: Solaris 10 (beta) 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:10477 Archived-At: Hi Julian, On Sat 12 Jun 2010 21:32, Julian Graham writes: > As promised, I've got an initial draft of the standard libraries > documentation done. Very cool! > Although I tried to avoid reproducing the content > of `r6rs-lib', it's still a bit more verbose, I think, than what we > discussed earlier in this thread (the Texinfo file clocks in at ~83k), > so I could certainly use some editorial feedback -- and tips on how > best to integrate it into the rest of the manual. > > In lieu of spamming the list with an attachment, I've uploaded a copy > of the file to my web site [0]. 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. One nit: idioms like "See (@pxref{Environments}) for documentation." are probably better as "@xref{Environments}, for documentation." Or ", for more information." Cheers, Andy -- http://wingolog.org/