1 files changed, 3 insertions, 2 deletions

diff --git a/lisp/files.el b/lisp/files.el
index 1dc6e5454df..ce4d67d33e4 100644
--- a/lisp/files.el
+++ b/lisp/files.el
@@ -3727,8 +3727,9 @@ This command is used in the special Dired buffer created by
       (kill-buffer buffer))))
 
 (defun kill-some-buffers (&optional list)
-  "For each buffer in LIST, ask whether to kill it.
-LIST defaults to all existing live buffers."
+  "Kill some buffers.  Asks the user whether to kill each one of them.
+Non-interactively, if optional argument LIST is non-`nil', it
+specifies the list of buffers to kill, asking for approval for each one."
   (interactive)
   (if (null list)
       (setq list (buffer-list)))