From: Juanma Barranquero Date: Mon, 25 Dec 2006 01:08:43 +0000 (+0000) Subject: (Sorting Sequences): In sort*, add a little cautionary note about the key X-Git-Tag: emacs-pretest-22.0.93~429 X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=92ad3e9f498c5c2adcc11503f46b09adf312227d;p=emacs.git (Sorting Sequences): In sort*, add a little cautionary note about the key procedure being used heavily. --- diff --git a/man/ChangeLog b/man/ChangeLog index 4284b99116a..a55f6aa7c4c 100644 --- a/man/ChangeLog +++ b/man/ChangeLog @@ -1,3 +1,8 @@ +2006-12-25 Kevin Ryde + + * cl.texi (Sorting Sequences): In sort*, add a little cautionary note + about the key procedure being used heavily. + 2006-12-24 Chong Yidong * pgg.texi (Caching passphrase): Default for pgg-gpg-use-agent changed diff --git a/man/cl.texi b/man/cl.texi index 56f81bb3947..2c357f5fec6 100644 --- a/man/cl.texi +++ b/man/cl.texi @@ -4092,7 +4092,9 @@ fed to the @var{predicate} function. For example, @noindent sorts @var{data}, a sequence of strings, into increasing alphabetical order without regard to case. A @code{:key} function of @code{car} -would be useful for sorting association lists. +would be useful for sorting association lists. It should only be a +simple accessor though, it's used heavily in the current +implementation. The @code{sort*} function is destructive; it sorts lists by actually rearranging the @code{cdr} pointers in suitable fashion.