[Emacs-diffs] master 6065fbe: desktop.el (desktop-buffer-info): Write docstring.

[Artur Malabarba]

branch: master
commit 6065fbe0d212857ecfa58e8a64fc4af3913c24e9
Author: Artur Malabarba <address@hidden>
Commit: Artur Malabarba <address@hidden>

    desktop.el (desktop-buffer-info): Write docstring.
---
 lisp/ChangeLog  |    2 ++
 lisp/desktop.el |   18 ++++++++++++++++++
 2 files changed, 20 insertions(+), 0 deletions(-)

diff --git a/lisp/ChangeLog b/lisp/ChangeLog
index 1f54617..d810ee8 100644
--- a/lisp/ChangeLog
+++ b/lisp/ChangeLog
@@ -1,5 +1,7 @@
 2015-03-05  Artur Malabarba  <address@hidden>
 
+       * desktop.el (desktop-buffer-info): Write docstring.
+
        * emacs-lisp/package.el (package-refresh-contents): Update doc.
 
 2015-03-05  Dmitry Gutov  <address@hidden>
diff --git a/lisp/desktop.el b/lisp/desktop.el
index b85d8b2..8d151a7 100644
--- a/lisp/desktop.el
+++ b/lisp/desktop.el
@@ -756,6 +756,24 @@ is nil, ask the user where to save the desktop."
 
 ;; ----------------------------------------------------------------------------
 (defun desktop-buffer-info (buffer)
+  "Return information describing BUFFER.
+This function is not pure, as BUFFER is made current with
+`set-buffer'.
+
+Returns a list of all the necessary information to recreate the
+buffer, which is (in order):
+
+    `uniquify-buffer-base-name';
+    `buffer-file-name';
+    `buffer-name';
+    `major-mode';
+    list of minor-modes,;
+    `point';
+    `mark';
+    `buffer-read-only';
+    auxiliary information given by `desktop-save-buffer';
+    local variables;
+    auxiliary information given by `desktop-var-serdes-funs'."
   (set-buffer buffer)
   (list
    ;; base name of the buffer; replaces the buffer name if managed by uniquify