Re: association list bug? -- version 1.6.4

[Jon Wilson]

Hi Ludovic,

> This is clearly not possible because `assq' et al. are part of R5RS and
> `assoc-ref' has been part of Guile for a very, very long time.

Fair enough.

> One just has to be very careful when reading the manual.  ;-)

The manual says

"Like assq, assv and assoc, except that only the value associated with 
key in alist is returned."

which seems to suggest (incorrectly, obviously) that the arguments to 
both assoc and assoc-ref should be the same.  Perhaps, given that it 
seems that a fairly large number of people have misread the manual and 
gotten confused about this, it would be helpful to add a phrase 
explicitly pointing out that the argument order is reversed.  For example,

"Like assq, assv, and assoc (with argument order reversed), except 
that only the value associated with key in alist is returned."

One shouldn't have to be quite so very careful when reading the manual.
Regards,
Jon