Improve doc strings for completion styles.

 lisp/minibuffer.el (completion-styles)
 (completion-category-overrides): Cross reference each other in doc
 strings.

diff --git a/lisp/ChangeLog b/lisp/ChangeLog
index b258f1081b0aa678fe7e75894aadbbec507d9599..bdf4522c4f5b2426662d1f806a7df75eaeba7e1f 100644 (file)
--- a/lisp/ChangeLog
+++ b/lisp/ChangeLog
@@ -1,3 +1,9 @@
+2011-09-27  Eli Zaretskii  <eliz@gnu.org>
+
+       * minibuffer.el (completion-styles)
+       (completion-category-overrides): Cross reference each other in doc
+       strings.
+
 2011-09-27  Glenn Morris  <rgm@gnu.org>
 
        * pcmpl-cvs.el (pcmpl-cvs-entries): Update for Emacs 22.1 changes

diff --git a/lisp/minibuffer.el b/lisp/minibuffer.el
index c6f28b14415874b89ae98337a44f5691ef4c8641..021e46d5053e38574ca433399f0814a68801145e 100644 (file)
--- a/lisp/minibuffer.el
+++ b/lisp/minibuffer.el
@@ -482,7 +482,10 @@ and DOC describes the way this style of completion works.")
     ;; and simply add "bar" to the end of the result.
     emacs22)
   "List of completion styles to use.
-The available styles are listed in `completion-styles-alist'."
+The available styles are listed in `completion-styles-alist'.
+
+Note that `completion-category-overrides' may override these
+styles for specific categories, such as files, buffers, etc."
   :type `(repeat (choice ,@(mapcar (lambda (x) (list 'const (car x)))
                                    completion-styles-alist)))
   :group 'minibuffer
@@ -490,7 +493,7 @@ The available styles are listed in `completion-styles-alist'."
 
 (defcustom completion-category-overrides
   '((buffer (styles . (basic substring))))
-  "List of overrides for specific categories.
+  "List of `completion-styles' overrides for specific categories.
 Each override has the shape (CATEGORY . ALIST) where ALIST is
 an association list that can specify properties such as:
 - `styles': the list of `completion-styles' to use for that category.