# HG changeset patch
# User Juanma Barranquero <lekktu@gmail.com>
# Date 1116806740 0
# Node ID 59b6666e38f9fd96a46702353feb12788d6237f1
# Parent  27b53b1903b6fc46549ec141c8cdc32b2a135bb5
(acons, pairlis): Add docstring.

diff -r 27b53b1903b6 -r 59b6666e38f9 lisp/emacs-lisp/cl.el
--- a/lisp/emacs-lisp/cl.el	Mon May 23 00:03:59 2005 +0000
+++ b/lisp/emacs-lisp/cl.el	Mon May 23 00:05:40 2005 +0000
@@ -565,8 +565,17 @@
 	       cl-tree (cons a d))))
 	(t cl-tree)))
 
-(defun acons (a b c) (cons (cons a b) c))
-(defun pairlis (a b &optional c) (nconc (mapcar* 'cons a b) c))
+(defun acons (key value alist)
+  "Add KEY and VALUE to ALIST.
+Return a new list with (cons KEY VALUE) as car and ALIST as cdr."
+  (cons (cons key value) alist))
+
+(defun pairlis (keys values &optional alist)
+  "Make an alist from KEYS and VALUES.
+Return a new alist composed by associating KEYS to corresponding VALUES;
+the process stops as soon as KEYS or VALUES run out.
+If ALIST is non-nil, the new pairs are prepended to it."
+  (nconc (mapcar* 'cons keys values) alist))
 
 
 ;;; Miscellaneous.