From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Eli Zaretskii Newsgroups: gmane.emacs.bugs Subject: bug#69786: [PATCH] docs: mention the keymap to add keybindings to for term-mode Date: Thu, 14 Mar 2024 07:11:05 +0200 Message-ID: <86ttl9bdp2.fsf@gnu.org> References: <844975c2f1ed019fb6be836643e118ed850e0605.camel@yandex.ru> Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="22074"; mail-complaints-to="usenet@ciao.gmane.io" Cc: 69786@debbugs.gnu.org To: Konstantin Kharlamov Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Thu Mar 14 06:11:52 2024 Return-path: Envelope-to: geb-bug-gnu-emacs@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 ) id 1rkdNf-0005aI-RI for geb-bug-gnu-emacs@m.gmane-mx.org; Thu, 14 Mar 2024 06:11:52 +0100 Original-Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1rkdNK-0001Iu-5S; Thu, 14 Mar 2024 01:11:30 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1rkdNH-0001If-Ej for bug-gnu-emacs@gnu.org; Thu, 14 Mar 2024 01:11:27 -0400 Original-Received: from debbugs.gnu.org ([2001:470:142:5::43]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1rkdNG-0006VT-8j for bug-gnu-emacs@gnu.org; Thu, 14 Mar 2024 01:11:27 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1rkdNp-0007h9-L1 for bug-gnu-emacs@gnu.org; Thu, 14 Mar 2024 01:12:01 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Eli Zaretskii Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Thu, 14 Mar 2024 05:12:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 69786 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: patch Original-Received: via spool by 69786-submit@debbugs.gnu.org id=B69786.171039311429443 (code B ref 69786); Thu, 14 Mar 2024 05:12:01 +0000 Original-Received: (at 69786) by debbugs.gnu.org; 14 Mar 2024 05:11:54 +0000 Original-Received: from localhost ([127.0.0.1]:47739 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1rkdNi-0007ep-0m for submit@debbugs.gnu.org; Thu, 14 Mar 2024 01:11:54 -0400 Original-Received: from eggs.gnu.org ([209.51.188.92]:51988) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1rkdNf-0007eb-4q for 69786@debbugs.gnu.org; Thu, 14 Mar 2024 01:11:51 -0400 Original-Received: from fencepost.gnu.org ([2001:470:142:3::e]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1rkdMy-0006Ms-4M; Thu, 14 Mar 2024 01:11:10 -0400 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnu.org; s=fencepost-gnu-org; h=MIME-version:References:Subject:In-Reply-To:To:From: Date; bh=WW6RoPAAU8SUCsEut9jVpYjMSPEmz5wH77O1WA7Lye0=; b=kAmbXIOr3joDSjg4sGQa FN99rK3qvhIkZ0Sd9xO/EEg16SiQgH7QAxOrhZvTmSS3lZGuqosokaWMKPEoH0KfXVFgkKyAOmGon BOSRcYI+PKHH3+3P4X1YZeIMW04Z5G0CKDvJmvmCmq7oafuMBWDLangYf28tVsbpvr7JYN+tWaTGz DpIWlKGuXgKHK2pEr29k5Exq/vYtxr2JcjX9RZaz9My2Aa+a0F1KF41hY7vYAyAPuhwZuZ4Qo4PUU JJ+kXXrJIw1liG4051WhyCk3w2FRhFWsQ62wREhOFUUgrK0q694MJa1/v92T6KfLNbE7UiOLcq549 cBbvNkGSnXBjJA==; In-Reply-To: <844975c2f1ed019fb6be836643e118ed850e0605.camel@yandex.ru> (message from Konstantin Kharlamov on Thu, 14 Mar 2024 02:39:23 +0300) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-BeenThere: bug-gnu-emacs@gnu.org List-Id: "Bug reports for GNU Emacs, the Swiss army knife of text editors" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Original-Sender: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Xref: news.gmane.io gmane.emacs.bugs:281580 Archived-At: > From: Konstantin Kharlamov > Date: Thu, 14 Mar 2024 02:39:23 +0300 > > I've spent quite some time today trying to somehow override keybindings > for term-mode. While time was spent mostly due to some local mistakes, > one problem I also noticed is that term-mode has `term-mode-map` — > pretty much like any other major mode foo typically have `foo-mode- > map`. However, adding keybindings into it has no effect whatsoever. > Instead term-mode has an additional `term-raw-map`, which is the actual > location where one has to put custom bindings. > > It is completely non-intuitive (and I also for some reason didn't get > the answer on emacs.stackexchange for the same problem when I was > trying to google it), so let's document that nuisance. Thanks, but the Emacs user manual is not the right place for this kind of information. Instead, this should be mentioned in the doc string of term-mode. Btw, your understanding of this is at least inaccurate if not incorrect: whether custom key bindings should be added to term-mode-map or term-raw-map depends on whether you want them for the line mode or for the raw mode. The documentation should say so.