[Emacs-diffs] master 8ab85ee: (package--append-to-alist): Updated docstring due to new name.

[Artur Malabarba]

branch: master
commit 8ab85ee7ce9ad101583620e7ba3bee39cf3491ae
Author: Artur Malabarba <address@hidden>
Commit: Artur Malabarba <address@hidden>

    (package--append-to-alist): Updated docstring due to new name.
---
 lisp/ChangeLog             |    1 +
 lisp/emacs-lisp/package.el |    8 +++++---
 2 files changed, 6 insertions(+), 3 deletions(-)

diff --git a/lisp/ChangeLog b/lisp/ChangeLog
index 07c873d..b7a1fb9 100644
--- a/lisp/ChangeLog
+++ b/lisp/ChangeLog
@@ -2,6 +2,7 @@
 
        * emacs-lisp/package.el (package--append-to-alist): Renamed from
        `package--add-to-alist'
+       Updated docstring due to new name.
 
 2015-01-18  Leo Liu  <address@hidden>
 
diff --git a/lisp/emacs-lisp/package.el b/lisp/emacs-lisp/package.el
index 07ddddd..0f094b5 100644
--- a/lisp/emacs-lisp/package.el
+++ b/lisp/emacs-lisp/package.el
@@ -1157,10 +1157,12 @@ Also, add the originating archive to the `package-desc' 
structure."
             (package--append-to-alist pkg-desc package-archive-contents)))))
 
 (defun package--append-to-alist (pkg-desc alist)
-  "Add PKG-DESC to ALIST.
+  "Append an entry for PKG-DESC to the start of ALIST and return it.
+This entry takes the form (`package-desc-name' PKG-DESC).
 
-Packages are grouped by name. The package descriptions are sorted
-by version number."
+If ALIST already has an entry with this name, destructively add
+PKG-DESC to the cdr of this entry instead, sorted by version
+number."
   (let* ((name (package-desc-name pkg-desc))
          (priority-version (package-desc-priority-version pkg-desc))
          (existing-packages (assq name alist)))