Improve docstrings

* lisp/progmodes/xref.el (xref-collect-matches)
(xref-collect-references): Improve docstrings.

diff --git a/lisp/progmodes/xref.el b/lisp/progmodes/xref.el
index 5601cb32b4df7ba4830156ddf733ef58d214c8dd..9c806d70ce48325257e2114eff184bcf546dc6eb 100644 (file)
--- a/lisp/progmodes/xref.el
+++ b/lisp/progmodes/xref.el
@@ -1130,7 +1130,9 @@ and just use etags."
 (defvar ede-minor-mode) ;; ede.el
 
 (defun xref-collect-references (symbol dir)
-  "Collect references to SYMBOL inside DIR.
+  "Find all references to SYMBOL in directory DIR.
+Return a list of xref values.
+
 This function uses the Semantic Symbol Reference API, see
 `semantic-symref-tool-alist' for details on which tools are used,
 and when."
@@ -1160,7 +1162,8 @@ and when."
 
 ;;;###autoload
 (defun xref-collect-matches (regexp files dir ignores)
-  "Collect matches for REGEXP inside FILES in DIR.
+  "Find all matches for REGEXP in FILES in directory DIR.
+Return a list of xref values.
 FILES is a string with glob patterns separated by spaces.
 IGNORES is a list of glob patterns."
   ;; DIR can also be a regular file for now; let's not advertise that.