Subject: bug#50390: Improve documentation of 'read-char-choice-use-read-key' and 'y-or-n-p-use-read-key'

From: Stefan Kangas <[email-masked]>
Date: Sun, 5 Sep 2021 04:56:18 +0200

Severity: wishlist
X-Debbugs-CC: Juri Linkov <[email-masked]>

I read in NEWS for Emacs 28:

    New variables 'read-char-choice-use-read-key' and 'y-or-n-p-use-read-key'.

When I look into the documentation of those variables, I do not get
any explanation of why I would want to use them.  I also can't find
any explanation in the manual.

Even just one or two sentences that indicates its typical use would be
very helpful here.