From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Stephen Berman Newsgroups: gmane.emacs.devel Subject: Re: "Command Discovery In Emacs " Date: Mon, 16 Aug 2021 16:58:57 +0200 Message-ID: <87k0kl307i.fsf@rub.de> References: <35ED7127-E9B2-4725-A8CE-F40EA09202C0@traduction-libre.org> <87k0klfwl4.fsf@gnus.org> Mime-Version: 1.0 Content-Type: multipart/mixed; boundary="=-=-=" Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="8870"; mail-complaints-to="usenet@ciao.gmane.io" User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/28.0.50 (gnu/linux) Cc: Emacs Devel To: Lars Ingebrigtsen Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Mon Aug 16 17:03:00 2021 Return-path: 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 ) id 1mFe8i-00026V-LY for ged-emacs-devel@m.gmane-mx.org; Mon, 16 Aug 2021 17:03:00 +0200 Original-Received: from localhost ([::1]:34694 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1mFe8h-0005zj-B7 for ged-emacs-devel@m.gmane-mx.org; Mon, 16 Aug 2021 11:02:59 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:39948) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1mFe4u-0007QK-13 for emacs-devel@gnu.org; Mon, 16 Aug 2021 10:59:04 -0400 Original-Received: from mout.gmx.net ([212.227.17.22]:55341) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1mFe4r-0004Of-1U for emacs-devel@gnu.org; Mon, 16 Aug 2021 10:59:03 -0400 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=gmx.net; s=badeba3b8450; t=1629125939; bh=xZ7k46PNgd/iEx9cFXzJk5tMU5lecojdJXpEVGoxn9U=; h=X-UI-Sender-Class:From:To:Cc:Subject:References:Date:In-Reply-To; b=ZZRJj1xcVqBPFSaew4WeFTlever/WLJi38+Wrb3KM9E78KP/2n5kVNE0CDz4+HLG4 ExtEXSw9vllIhp7jutulHi7f4Ji71mGLXHSEIlOtQIk5CdDhAkBBqrjkh5JGlGa/EC 5DBee6wiifF6VbmqjPyP8g2t2+S1gJBRgWqGn5Sk= X-UI-Sender-Class: 01bb95c1-4bf8-414a-932a-4f6e2808ef9c Original-Received: from strobelfs ([188.109.153.245]) by mail.gmx.net (mrgmx105 [212.227.17.168]) with ESMTPSA (Nemesis) id 1N17YY-1nCWJk3Yte-012cO8; Mon, 16 Aug 2021 16:58:58 +0200 In-Reply-To: <87k0klfwl4.fsf@gnus.org> (Lars Ingebrigtsen's message of "Mon, 16 Aug 2021 13:38:47 +0200") X-Provags-ID: V03:K1:js5PXk7FIZWbq5FFPoi61+QOykqzQHEfm1E7jaFgZTNw2BufsHm fuMzJkUUE4QH87ULXH+TZ9aDodkafG5RjPF9pM/BuwON9qkZJPh2c1QRAB2kZjZgvm6GMtj tTeZAsEnq1h1rr9hIIVGv4Cua7+wDCOYXsRyVjlc/yIGIa2xHfQ0VPKYCgcolrjUVL8O5Gi MQ6MXVXK1OhuwlqA24UKg== X-UI-Out-Filterresults: notjunk:1;V03:K0:EMObkgV+Ryc=:OOUeFsHmQ/YUNjMgRJy9EB tEv+qZV59pzbjI4YfMpcz77PvgxhrxxUcxWsEydWzCzfK/+IyQJHoJ5JbEn8SsTzw8JhraaQ0 MUWYGVEEVCQkE3i9lleWBHweQ8WKniN8plwep+NH8QR9sFHWH5CrnFBVlqgxQoBGaO/p3d6gL B4mLab63MO718ok4ms7WjBRt/AaYD1SRpc9wpPq0c6jNw7jJM9YX+Hmr77zpShx02Rxrt4HbE guYTo1jEYftsaUZdNLMWpKPIQD9j78l2vn8NAhqdC3ig8PSB0pB7tnUNJa9Vgcp88n0jEHiFm HGqscNfkRijwkaO0ckX47yW5HTLLST4tSsi+8fuej7W3WRlJ+/zq1ub7JJ4lvp60nQY2NhH8f OU2awETlPL5G21qtAJuqN5lu9V2o+Kan1QTRBhjuChETU5xcG3jdQeRkkDk8a89E5Wmet2N0d /Mn7BUPydgfjuX/jjhyeyefHqJlD1N3bnreSfidMMtiLg6jm0bz8x2JWbjrUcr2k5yE4lpXvh 5hruu8Z8HxNWVTaLbmuY/oXiZRF482gazykWuLQqi1onHoiR3It/YJzCG+wHXo4pMa3bXHtcO PKN+/Y2zSSexerdFb4dBktVZIrwIiDtedOc+IRWZTb4AgFYFCD81wAGbiZWSxsAbFpBtOoyqY nEaSNLK78vvD1Le6nIYh8O+hwoWjuGzvT+msYFf7wTKM7U7PJ+gX1gzzwRJJH3yc+ELG+FLP+ M1SZ2VfHZDriTfCIXYwFpcP5uB+ozCuW9tGY31nGZz4eBXrfKvChIHyFQc3FvCtwPMLW9TFU Received-SPF: pass client-ip=212.227.17.22; envelope-from=stephen.berman@gmx.net; helo=mout.gmx.net X-Spam_score_int: -20 X-Spam_score: -2.1 X-Spam_bar: -- X-Spam_report: (-2.1 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, FREEMAIL_FROM=0.001, SPF_HELO_NONE=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." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Original-Sender: "Emacs-devel" Xref: news.gmane.io gmane.emacs.devel:272445 Archived-At: --=-=-= Content-Type: text/plain On Mon, 16 Aug 2021 13:38:47 +0200 Lars Ingebrigtsen wrote: > Jean-Christophe Helary writes: > >> That command discovery is really nice and I was wondering how to find >> the proper way to annotate the various functions. How do we know what >> modes are the functions are to be used in ? Is there an easy way to >> find out ? > > See the "Command Modes" section in the Emacs Lisp manual. This section is not listed in the Detailed Node Listing in the top node of the manual, and it's also not indexed. I'm not well-versed in texinfo; is the following patch sufficient? Steve Berman --=-=-= Content-Type: text/x-patch Content-Disposition: inline Content-Description: List and index Command Modes node in Elisp manual Content-Transfer-Encoding: quoted-printable diff --git a/doc/lispref/commands.texi b/doc/lispref/commands.texi index b4a8b733a0..6d45099867 100644 =2D-- a/doc/lispref/commands.texi +++ b/doc/lispref/commands.texi @@ -601,6 +601,9 @@ Interactive Examples @node Command Modes @subsection Specifying Modes For Commands +@cindex commands, mode-specific +@cindex commands, specify as mode-specific +@cindex mode-specific commands Many commands in Emacs are general, and not tied to any specific mode. For instance, @kbd{M-x kill-region} can be used in pretty much any diff --git a/doc/lispref/elisp.texi b/doc/lispref/elisp.texi index 8b440c7977..337c71c295 100644 =2D-- a/doc/lispref/elisp.texi +++ b/doc/lispref/elisp.texi @@ -788,6 +788,7 @@ Top * Interactive Codes:: The standard letter-codes for reading argumen= ts in various ways. * Interactive Examples:: Examples of how to read interactive arguments= . +* Command Modes:: Specifying that commands are for a specific = mode. * Generic Commands:: Select among command alternatives. --=-=-=--