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: [patch] SRFI-69 support Date: Wed, 05 Dec 2007 23:26:38 +0100 Message-ID: <871wa03hi9.fsf@pobox.com> References: <1196541025.25569.40.camel@nocandy.dyndns.org> NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Trace: ger.gmane.org 1196893636 19019 80.91.229.12 (5 Dec 2007 22:27:16 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Wed, 5 Dec 2007 22:27:16 +0000 (UTC) Cc: guile-devel@gnu.org To: Stephen Compall Original-X-From: guile-devel-bounces+guile-devel=m.gmane.org@gnu.org Wed Dec 05 23:27:26 2007 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.50) id 1J02iE-0002nt-9K for guile-devel@m.gmane.org; Wed, 05 Dec 2007 23:27:26 +0100 Original-Received: from localhost ([127.0.0.1] helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1J02hx-0005qf-7t for guile-devel@m.gmane.org; Wed, 05 Dec 2007 17:27:09 -0500 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1J02hZ-0005Of-U0 for guile-devel@gnu.org; Wed, 05 Dec 2007 17:26:45 -0500 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1J02hX-0005Mw-Sd for guile-devel@gnu.org; Wed, 05 Dec 2007 17:26:45 -0500 Original-Received: from [199.232.76.173] (helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1J02hX-0005MC-6z for guile-devel@gnu.org; Wed, 05 Dec 2007 17:26:43 -0500 Original-Received: from ambient.dashsystems.com ([216.27.85.7] helo=kettle.ambient-hosting.net) by monty-python.gnu.org with esmtp (Exim 4.60) (envelope-from ) id 1J02hW-0004vp-Ch for guile-devel@gnu.org; Wed, 05 Dec 2007 17:26:42 -0500 Original-Received: from localhost.localdomain (ambient-hosting.net [10.1.6.1]) by kettle.ambient-hosting.net (Postfix) with ESMTP id 68BC8880DB; Wed, 5 Dec 2007 17:26:39 -0500 (EST) Original-Received: by localhost.localdomain (Postfix, from userid 1000) id A768E118221; Wed, 5 Dec 2007 23:26:38 +0100 (CET) In-Reply-To: <1196541025.25569.40.camel@nocandy.dyndns.org> (Stephen Compall's message of "Sat\, 01 Dec 2007 20\:30\:25 +0000") User-Agent: Gnus/5.11 (Gnus v5.11) Emacs/22.1.50 (gnu/linux) X-detected-kernel: by monty-python.gnu.org: Linux 2.4-2.6 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:6916 Archived-At: Hey Stephen, I know this is committed already (great work!), but perhaps you might be interested in some doc criticism: On Sat 01 Dec 2007 21:30, Stephen Compall writes: > +As a legacy of the time when Guile couldn't grow hash tables, > +@var{start-size} is an optional integer argument that specifies the > +approximate starting size for the hash table. I will usually round > +this to an algorithmically-sounder number. This and other instances of the first person in the manual are I think out of place. Besides that, the "usually" is imprecise. Probably the right solution is to replace the last sentence with "don't use this argument" or the like. There are a couple of other instances of this: > +By @dfn{coarser} than @code{equal?}, I mean that for all @var{x} and etc. Anyway, comments for if you feel motivated ;) Andy -- http://wingolog.org/ _______________________________________________ Guile-devel mailing list Guile-devel@gnu.org http://lists.gnu.org/mailman/listinfo/guile-devel