GNU bug report logs - #54479
27.2; Doc string of `read-char-from-minibuffer-insert-other'

Previous Next

To add a comment to this bug, you must first unarchive it, by sending
a message to control AT debbugs.gnu.org, with unarchive 54479 in the body.
You can then email your comments to 54479 AT debbugs.gnu.org in the normal way.

Toggle the display of automated, internal messages from the tracker.

Message #5 received at submit <at> debbugs.gnu.org (full text, mbox):

From: Drew Adams <drew.adams <at> oracle.com>
To: "bug-gnu-emacs <at> gnu.org" <bug-gnu-emacs <at> gnu.org>
Subject: 27.2; Doc string of `read-char-from-minibuffer-insert-other'
Date: Sun, 20 Mar 2022 15:35:09 +0000

The doc string of this command is less than comprehensible, IMO.

  Handle inserting of a character other than allowed.
  Display an error on trying to insert a disallowed character.
  Also discard all previous input in the minibuffer.

To me, this doesn't say anything about what this command does.  After
all, it's a _command_, not just a function that reads a char
(presumably).  What does it do - what do you use it for?

What does "handle" mean here?  What are the "allowed" chars, and in what
way are they "allowed"?  What's meant by "previous input" here?
___

A guess is that by discarding "previous input" is meant first clear the
minibuffer - remove its content.  ("Previous input" suggests minibuffer
history.)

In GNU Emacs 27.2 (build 1, x86_64-w64-mingw32)
 of 2021-03-26 built on CIRROCUMULUS
Repository revision: deef5efafb70f4b171265b896505b92b6eef24e6
Repository branch: HEAD
Windowing system distributor 'Microsoft Corp.', version 10.0.19043
System Description: Microsoft Windows 10 Pro (v10.0.2009.19043.1526)

Message #10 received at 54479-done <at> debbugs.gnu.org (full text, mbox):

From: Eli Zaretskii <eliz <at> gnu.org>
To: Drew Adams <drew.adams <at> oracle.com>
Cc: 54479-done <at> debbugs.gnu.org
Subject: Re: bug#54479: 27.2;
 Doc string of `read-char-from-minibuffer-insert-other'
Date: Sun, 20 Mar 2022 18:23:50 +0200

> From: Drew Adams <drew.adams <at> oracle.com>
> Date: Sun, 20 Mar 2022 15:35:09 +0000
> 
> The doc string of this command is less than comprehensible, IMO.
> 
>   Handle inserting of a character other than allowed.
>   Display an error on trying to insert a disallowed character.
>   Also discard all previous input in the minibuffer.
> 
> To me, this doesn't say anything about what this command does.

Thanks, I fixed that.

Previous Next

GNU bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997,2003 nCipher Corporation Ltd, 1994-97 Ian Jackson.