[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
master adda0df: completions-annotations doc string clarification
From: |
Lars Ingebrigtsen |
Subject: |
master adda0df: completions-annotations doc string clarification |
Date: |
Mon, 13 Sep 2021 06:21:11 -0400 (EDT) |
branch: master
commit adda0df193e648931f10034bc9bbe6d8fbca9d58
Author: Lars Ingebrigtsen <larsi@gnus.org>
Commit: Lars Ingebrigtsen <larsi@gnus.org>
completions-annotations doc string clarification
* lisp/minibuffer.el (completions-annotations): Mention that it's
not always used.
---
etc/NEWS | 7 ++++++-
lisp/minibuffer.el | 4 +++-
2 files changed, 9 insertions(+), 2 deletions(-)
diff --git a/etc/NEWS b/etc/NEWS
index 6a705de..a4d31a3 100644
--- a/etc/NEWS
+++ b/etc/NEWS
@@ -3120,8 +3120,10 @@ these cases.
These were actually rendered obsolete in Emacs 21 but were never
marked as such.
+---
** 'pcomplete-ignore-case' is now an obsolete alias of
'completion-ignore-case'.
++++
** 'completions-annotations' face is not used when the caller puts own face.
This affects the suffix specified by completion 'annotation-function'.
@@ -3130,7 +3132,8 @@ This affects the suffix specified by completion
'annotation-function'.
This is instead of the erroneous 'minibuffer-inactive-mode' it
formerly had.
-** 'make-text-button' no longer text properties of its first argument.
+---
+** 'make-text-button' no longer modifies text properties of its first argument.
When its first argument is a string, 'make-text-button' no longer
modifies the string's text properties; instead, it uses and returns
a copy of the string. This helps avoid trouble when strings are
@@ -3142,6 +3145,7 @@ If 'minibuffer-allow-text-properties' is non-nil, doing
completion
over a table of strings with properties will no longer remove all the
properties before returning. This affects things like 'completing-read'.
+---
** 'dns-query' now consistently uses Lisp integers to represent integers.
Formerly it made an exception for integer components of SOA records,
because SOA serial numbers can exceed fixnum ranges on 32-bit platforms.
@@ -3156,6 +3160,7 @@ the Emacs Lisp reference manual for background.
+++
** The error 'ftp-error' belongs also to category 'remote-file-error'.
++++
** The WHEN argument of 'make-obsolete' and related functions is mandatory.
The use of those functions without a WHEN argument was marked obsolete
back in Emacs 23.1. The affected functions are: 'make-obsolete',
diff --git a/lisp/minibuffer.el b/lisp/minibuffer.el
index 539a2c2..9668e7c 100644
--- a/lisp/minibuffer.el
+++ b/lisp/minibuffer.el
@@ -1807,7 +1807,9 @@ Return nil if there is no valid completion, else t."
(_ t)))
(defface completions-annotations '((t :inherit (italic shadow)))
- "Face to use for annotations in the *Completions* buffer.")
+ "Face to use for annotations in the *Completions* buffer.
+This face is only used if the strings used for completions
+doesn't already specify a face.")
(defcustom completions-format 'horizontal
"Define the appearance and sorting of completions.
[Prev in Thread] |
Current Thread |
[Next in Thread] |
- master adda0df: completions-annotations doc string clarification,
Lars Ingebrigtsen <=