(SRFI-1 Association Lists): In alist-cons, clarify

a bit and cross reference core acons.

diff --git a/doc/ref/srfi-modules.texi b/doc/ref/srfi-modules.texi
index 1c0bc02..dd86e9d 100644 (file)
--- a/doc/ref/srfi-modules.texi
+++ b/doc/ref/srfi-modules.texi
@@ -943,14 +943,15 @@ predicate.  (@pxref{Association Lists})
 @end deffn
 
 @deffn {Scheme Procedure} alist-cons key datum alist
-Equivalent to
+Cons a new association @var{key} and @var{datum} onto @var{alist} and
+return the result.  This is equivalent to
 
 @lisp
 (cons (cons @var{key} @var{datum}) @var{alist})
 @end lisp
 
-This procedure is used to cons a new pair onto an existing
-association list.
+@code{acons} (@pxref{Adding or Setting Alist Entries}) in the Guile
+core does the same thing.
 @end deffn
 
 @deffn {Scheme Procedure} alist-copy alist