[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
bug#62502: 29.0.60; Docstring of `read-char-choice'
From: |
Eli Zaretskii |
Subject: |
bug#62502: 29.0.60; Docstring of `read-char-choice' |
Date: |
Tue, 28 Mar 2023 20:29:11 +0300 |
> From: Arash Esbati <arash@gnu.org>
> Date: Tue, 28 Mar 2023 16:32:21 +0200
>
> docstring of `read-char-choice' lacks any information about
> INHIBIT-KEYBOARD-QUIT:
That's because by default that argument is ignored.
> INHIBIT-KEYBOARD-QUIT is passed to `read-char-choice-with-read-key'; I'd
> say it is sufficient to say something like:
>
> If ‘read-char-choice-use-read-key’ is non-nil, the modal ‘read-key’
> function is used instead (see ‘read-char-choice-with-read-key’) and
> the optional INHIBIT-KEYBOARD-QUIT is passed to it.
Is it really useful? I believe read-char-choice-with-read-key is kept
for possible backward compatibility; new Lisp programs that want to
use read-char-choice-with-read-key should just call it directly, and
in its doc string this argument is documented.
So I'm not sure we should do anything about this issue.