desktop.el (desktop-buffer-info): Write docstring.

diff --git a/lisp/ChangeLog b/lisp/ChangeLog
index 1f54617b4d4322091a8d91a7bd13102c87bf953b..d810ee8ce59f3c0de08e547310a6b0ec63d90793 100644 (file)
--- a/lisp/ChangeLog
+++ b/lisp/ChangeLog
@@ -1,5 +1,7 @@
 2015-03-05  Artur Malabarba  <bruce.connor.am@gmail.com>
 
+       * desktop.el (desktop-buffer-info): Write docstring.
+
        * emacs-lisp/package.el (package-refresh-contents): Update doc.
 
 2015-03-05  Dmitry Gutov  <dgutov@yandex.ru>

diff --git a/lisp/desktop.el b/lisp/desktop.el
index b85d8b257a5f624a4acb8758b10dcc5776c473d9..8d151a74698908e445be9afd5c687f2e3f26f191 100644 (file)
--- 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