[elpa] externals/consult 51ff36d4ec 1/2: Promote comment to docstring

[ELPA Syncer]

branch: externals/consult
commit 51ff36d4ecf617c63a41a1628a68f14c3d81273d
Author: Daniel Mendler <mail@daniel-mendler.de>
Commit: Daniel Mendler <mail@daniel-mendler.de>

    Promote comment to docstring
---
 consult.el | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/consult.el b/consult.el
index 4af759c15f..0452d4907c 100644
--- a/consult.el
+++ b/consult.el
@@ -4398,7 +4398,10 @@ to search and is passed to `consult--buffer-query'."
 
 (cl-defun consult--buffer-query (&key sort directory mode as predicate (filter 
t)
                                       include (exclude consult-buffer-filter))
-  "Buffer query function.
+  "Query for a list of matching buffers.
+The function supports filtering by various criteria which are
+used throughout Consult.  In particular it is the backbone of
+most `consult-buffer' sources.
 DIRECTORY can either be the symbol project or a file name.
 SORT can be visibility, alpha or nil.
 FILTER can be either t, nil or invert.
@@ -4407,9 +4410,6 @@ INCLUDE is a list of regexps.
 MODE can be a mode or a list of modes to restrict the returned buffers.
 PREDICATE is a predicate function.
 AS is a conversion function."
-  ;; This function is the backbone of most `consult-buffer' source.  The
-  ;; function supports filtering by various criteria which are used throughout
-  ;; Consult.
   (let ((root (consult--normalize-directory directory))
         (buffers (buffer-list)))
     (when sort