From: Dmitry Gutov <dgutov@yandex.ru>
Date: Fri, 4 Nov 2022 01:16:36 +0000 (+0200)
Subject: project-buffers: Describe the default implementation
X-Git-Tag: emacs-29.0.90~1616^2~325
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=7d47651d0168c863ad9e9b07921a42dc18029276;p=emacs.git

project-buffers: Describe the default implementation

* lisp/progmodes/project.el (project-buffers):
Describe what the default implementation is doing (bug#58784).
---

diff --git a/lisp/progmodes/project.el b/lisp/progmodes/project.el
index ec453baf724..6d062aa8fa4 100644
--- a/lisp/progmodes/project.el
+++ b/lisp/progmodes/project.el
@@ -353,7 +353,10 @@ Also quote LOCAL-FILES if `default-directory' is quoted."
               local-files))))
 
 (cl-defgeneric project-buffers (project)
-  "Return the list of all live buffers that belong to PROJECT."
+  "Return the list of all live buffers that belong to PROJECT.
+
+The default implementation matches the current open buffers to
+PROJECT root using the value of `default-directory' in each one."
   (let ((root (expand-file-name (file-name-as-directory (project-root project))))
         bufs)
     (dolist (buf (buffer-list))