Re: [patch] SRFI-69 support

[Stephen Compall]

On Wed, 2007-12-05 at 23:26 +0100, Andy Wingo wrote:
> I know this is committed already (great work!), but perhaps you might be
> interested in some doc criticism:

Definitely!  Patch inline below.

> > +By @dfn{coarser} than @code{equal?}, I mean that for all @var{x} and

I changed this to "we" instead to avoid a passive or more awkward form
such as "Coarser than equal? means that..."


--- doc/ref/srfi-modules.texi   3 Dec 2007 12:36:12 -0000       1.75
+++ doc/ref/srfi-modules.texi   6 Dec 2007 04:19:22 -0000
@@ -3091,11 +3091,11 @@
 
 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.
+approximate starting size for the hash table, which will be rounded to
+an algorithmically-sounder number.
 @end deffn
 
-By @dfn{coarser} than @code{equal?}, I mean that for all @var{x} and
+By @dfn{coarser} than @code{equal?}, we mean that for all @var{x} and
 @var{y} values where @code{(@var{equal-proc} @var{x} @var{y})},
 @code{(equal? @var{x} @var{y})} as well.  If that does not hold for
 your @var{equal-proc}, you must provide a @var{hash-proc}.


-- 
Our last-ditch plan is to change the forums into a podcast, then send
RSS feeds into the blogosphere so our users can further debate the
legality of mashups amongst this month's 20 'sexiest' gadgets.
        --Richard "Lowtax" Kyanka

signature.asc
Description: This is a digitally signed message part