From mboxrd@z Thu Jan  1 00:00:00 1970
Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail
From: Drew Adams <drew.adams@oracle.com>
Newsgroups: gmane.emacs.devel
Subject: RE: keysee.el
Date: Tue, 8 Sep 2020 14:18:06 -0700 (PDT)
Message-ID: <c26b45ec-d1ed-4763-be92-109b127888cd@default>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Transfer-Encoding: quoted-printable
Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214";
	logging-data="14034"; mail-complaints-to="usenet@ciao.gmane.io"
Cc: eliz@gnu.org, stefan@marxist.se, justin@burkett.cc, drew.adams@oracle.com,
 emacs-devel@gnu.org
To: "Alfred M. Szmidt" <ams@gnu.org>, Drew Adams <drew.adams@oracle.com>
Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Tue Sep 08 23:19:16 2020
Return-path: <emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org>
Envelope-to: ged-emacs-devel@m.gmane-mx.org
Original-Received: from lists.gnu.org ([209.51.188.17])
	by ciao.gmane.io with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256)
	(Exim 4.92)
	(envelope-from <emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org>)
	id 1kFl1I-0003Xp-Jb
	for ged-emacs-devel@m.gmane-mx.org; Tue, 08 Sep 2020 23:19:16 +0200
Original-Received: from localhost ([::1]:58860 helo=lists1p.gnu.org)
	by lists.gnu.org with esmtp (Exim 4.90_1)
	(envelope-from <emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org>)
	id 1kFl1H-0006cZ-Kd
	for ged-emacs-devel@m.gmane-mx.org; Tue, 08 Sep 2020 17:19:15 -0400
Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:59838)
 by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256)
 (Exim 4.90_1) (envelope-from <drew.adams@oracle.com>)
 id 1kFl0L-0005vU-M2
 for emacs-devel@gnu.org; Tue, 08 Sep 2020 17:18:17 -0400
Original-Received: from userp2120.oracle.com ([156.151.31.85]:37004)
 by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256)
 (Exim 4.90_1) (envelope-from <drew.adams@oracle.com>)
 id 1kFl0J-0005Qr-MF; Tue, 08 Sep 2020 17:18:17 -0400
Original-Received: from pps.filterd (userp2120.oracle.com [127.0.0.1])
 by userp2120.oracle.com (8.16.0.42/8.16.0.42) with SMTP id 088LDumA073192;
 Tue, 8 Sep 2020 21:18:09 GMT
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=oracle.com;
 h=mime-version :
 message-id : date : from : sender : to : cc : subject : content-type :
 content-transfer-encoding; s=corp-2020-01-29;
 bh=QgD0j/e69UlP2g51eRmj1sxiVy6+8lYg4Y0lCW5rGto=;
 b=Pv6kxsAVX7LtMq2XGVXr8kd751FIWsH9PTx9cS3lFEZI9IcBjbMDnnDTTOO5iyf7eK1z
 pqA08ABDQ4siK5l3Pzz4CkDoV4JqqwEJRxScXOKmsyDeGa6IwzFClvfuGq4IyIJOetwB
 Q6TbwQJ3ytcYx+sSJsSKO7YXIlp2QZAIFk+S4CTN/t1V7fhEufABHB3tZc3PRL6ehUs9
 YhYlLGHrw5MIav9ebU4VZtFwjoVH+k14GXlAPlP6kOew2aQDKW9UNDuOD3y4+NupX4xb
 1ftWYm9gy+WqevW1aSmL1JEEFsdD0X9/26LCLwzGa/64Niz7PuqaFtk6EwlnvUgecT85 tA== 
Original-Received: from userp3030.oracle.com (userp3030.oracle.com [156.151.31.80])
 by userp2120.oracle.com with ESMTP id 33c3amx1wr-1
 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=FAIL);
 Tue, 08 Sep 2020 21:18:09 +0000
Original-Received: from pps.filterd (userp3030.oracle.com [127.0.0.1])
 by userp3030.oracle.com (8.16.0.42/8.16.0.42) with SMTP id 088LALJl163755;
 Tue, 8 Sep 2020 21:18:08 GMT
Original-Received: from aserv0121.oracle.com (aserv0121.oracle.com [141.146.126.235])
 by userp3030.oracle.com with ESMTP id 33cmkwge68-1
 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK);
 Tue, 08 Sep 2020 21:18:08 +0000
Original-Received: from abhmp0009.oracle.com (abhmp0009.oracle.com [141.146.116.15])
 by aserv0121.oracle.com (8.14.4/8.13.8) with ESMTP id 088LI7E2016364;
 Tue, 8 Sep 2020 21:18:07 GMT
X-Priority: 3
X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.9.1  (1003210) [OL
 16.0.5044.0 (x86)]
X-Proofpoint-Virus-Version: vendor=nai engine=6000 definitions=9738
 signatures=668679
X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 mlxscore=0
 phishscore=0 suspectscore=0
 spamscore=0 mlxlogscore=999 adultscore=0 malwarescore=0 bulkscore=0
 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.12.0-2006250000
 definitions=main-2009080191
X-Proofpoint-Virus-Version: vendor=nai engine=6000 definitions=9738
 signatures=668679
X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 phishscore=0
 priorityscore=1501
 clxscore=1015 bulkscore=0 malwarescore=0 lowpriorityscore=0
 mlxlogscore=999 suspectscore=0 adultscore=0 mlxscore=0 impostorscore=0
 spamscore=0 classifier=spam adjust=0 reason=mlx scancount=1
 engine=8.12.0-2006250000 definitions=main-2009080191
Received-SPF: pass client-ip=156.151.31.85; envelope-from=drew.adams@oracle.com;
 helo=userp2120.oracle.com
X-detected-operating-system: by eggs.gnu.org: First seen = 2020/09/08 17:18:11
X-ACL-Warn: Detected OS   = Linux 3.1-3.10 [fuzzy]
X-Spam_score_int: -43
X-Spam_score: -4.4
X-Spam_bar: ----
X-Spam_report: (-4.4 / 5.0 requ) BAYES_00=-1.9, DKIMWL_WL_HIGH=-0.001,
 DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1,
 RCVD_IN_DNSWL_MED=-2.3, RCVD_IN_MSPIKE_H2=-0.001, SPF_HELO_PASS=-0.001,
 SPF_PASS=-0.001 autolearn=ham autolearn_force=no
X-Spam_action: no action
X-BeenThere: emacs-devel@gnu.org
X-Mailman-Version: 2.1.23
Precedence: list
List-Id: "Emacs development discussions." <emacs-devel.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/emacs-devel>,
 <mailto:emacs-devel-request@gnu.org?subject=unsubscribe>
List-Archive: <https://lists.gnu.org/archive/html/emacs-devel>
List-Post: <mailto:emacs-devel@gnu.org>
List-Help: <mailto:emacs-devel-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/emacs-devel>,
 <mailto:emacs-devel-request@gnu.org?subject=subscribe>
Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org
Original-Sender: "Emacs-devel"
 <emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org>
Xref: news.gmane.io gmane.emacs.devel:254818
Archived-At: <http://permalink.gmane.org/gmane.emacs.devel/254818>

>> Please read the description.
>=20
> That is sorta the point -- one shouldn't need to read a description to
> open a file for a mode that tries to add completion.

How did you know there was such a mode and what
it does and how?  Either you read about it
somewhere or someone told you about it.  Or
perhaps you dreamt it.

You have preconceptions.  They didn't come from
reading the doc, right?

It's possible there's something confusing,
incorrect, or misleading in the doc.  Please
point that out, if so, and I'll try to fix it.

> The pop up shows keys that one would think are
> possible to just input so it is easy to expect
> that those will just work.

Why would you think completion candidates in
*Completions* are not something to be matched
by typing text in the minibuffer?

That's the usual Emacs behavior.  I'd think that
would be the default expectation for an Emacs
user.

You have different expectations, presumably from
your experience with which-key.  This isn't that.

> If I press C-x and go for a coffee in the middle of opening a file, it
> also becomes confusing since the behaviour of Emacs will magically
> change.

If you do `M-x fi TAB' and go for coffee, same
thing.  Same thing for `C-x C-f fo TAB'.

This is no different, except here you initiate
completion with S-TAB, not TAB (by default).

Or it's initiated automatically after a delay
(no key), if you use `kc-auto-mode' instead of
`kc-mode'.

> This is specially important when inputting keyboard macros. if you
> start a keyboard macro, wait for a bit ... then you're now recording
> the input to keysee.  Very confusing, since if you're quick on the
> fingers you'll get the expected behaviour but if you pause you get
> something totally different.

As the doc tells you (it's quite short!), you
can use `kc-mode' to get completion on demand.
Or you can use `kc-auto-mode' to get automatic
completion.

You can use automatic completion while recording
a keyboard macro, if you like.  You just need to
type minibuffer text to match `key  =3D  command'
completions.

But complete automatically when recording a
keyboard macro?  If you had auto-completion
for `find-file', that too might be confusing
while trying to record a macro.

For key completion while recording, you might
be better off with `kc-mode'.  Or with no key
completion at all.

> I get why it becomes that -- but consider it
> from a random user.

I guess I kinda expect a user, random or not,
to look at a doc string or the doc - or the
code.  YMMV.