From: Eli Zaretskii Date: Tue, 27 Sep 2011 18:51:05 +0000 (+0300) Subject: Improve doc strings for completion styles. X-Git-Tag: emacs-pretest-24.0.91~260^2 X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=693fbdb629c8cd41253519cf6c68a9b7b7bde493;p=emacs.git 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 b258f1081b0..bdf4522c4f5 100644 --- a/lisp/ChangeLog +++ b/lisp/ChangeLog @@ -1,3 +1,9 @@ +2011-09-27 Eli Zaretskii + + * minibuffer.el (completion-styles) + (completion-category-overrides): Cross reference each other in doc + strings. + 2011-09-27 Glenn Morris * pcmpl-cvs.el (pcmpl-cvs-entries): Update for Emacs 22.1 changes diff --git a/lisp/minibuffer.el b/lisp/minibuffer.el index c6f28b14415..021e46d5053 100644 --- 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.