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 ec453baf724314d3225bf0aed92984f7bcf7bdde..6d062aa8fa4a851c8330b43bdafc9f0ab3f87320 100644 (file)
--- 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))