From debbugs-submit-bounces@debbugs.gnu.org Thu Jul 28 15:30:58 2022 Received: (at submit) by debbugs.gnu.org; 28 Jul 2022 19:30:58 +0000 Received: from localhost ([127.0.0.1]:59419 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1oH9Dm-0007v2-2T for submit@debbugs.gnu.org; Thu, 28 Jul 2022 15:30:58 -0400 Received: from lists.gnu.org ([209.51.188.17]:36284) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1oH9Di-0007ut-LW for submit@debbugs.gnu.org; Thu, 28 Jul 2022 15:30:57 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]:47740) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1oH9Di-00038V-EQ for bug-gnu-emacs@gnu.org; Thu, 28 Jul 2022 15:30:54 -0400 Received: from colin.muc.de ([193.149.48.1]:54976 helo=mail.muc.de) by eggs.gnu.org with smtp (Exim 4.90_1) (envelope-from ) id 1oH9Dg-0002mG-CT for bug-gnu-emacs@gnu.org; Thu, 28 Jul 2022 15:30:54 -0400 Received: (qmail 83330 invoked by uid 3782); 28 Jul 2022 19:30:37 -0000 Received: from acm.muc.de (p2e5d5f61.dip0.t-ipconnect.de [46.93.95.97]) (using STARTTLS) by colin.muc.de (tmda-ofmipd) with ESMTP; Thu, 28 Jul 2022 21:30:37 +0200 Received: (qmail 8528 invoked by uid 1000); 28 Jul 2022 19:30:37 -0000 Date: Thu, 28 Jul 2022 19:30:36 +0000 To: bug-gnu-emacs@gnu.org Subject: Missing documentation of function-key-map Message-ID: MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline X-Submission-Agent: TMDA/1.3.x (Ph3nix) From: Alan Mackenzie X-Primary-Address: acm@muc.de Received-SPF: pass client-ip=193.149.48.1; envelope-from=acm@muc.de; helo=mail.muc.de X-Spam_score_int: -18 X-Spam_score: -1.9 X-Spam_bar: - X-Spam_report: (-1.9 / 5.0 requ) BAYES_00=-1.9, SPF_HELO_NONE=0.001, SPF_PASS=-0.001, T_SCC_BODY_TEXT_LINE=-0.01 autolearn=ham autolearn_force=no X-Spam_action: no action X-Spam-Score: -1.6 (-) X-Debbugs-Envelope-To: submit X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -2.6 (--) Hello, Emacs. function-key-map is not defined in the Elisp manual. It is mentioned, in passing, on the page "Translation Keymaps" thusly: `local-function-key-map' inherits from `function-key-map'. The latter should only be altered if you want the binding to apply in all terminals, so using the former is almost always preferred. So, all we know about function-key-map is when to alter it (and even here, it is unclear what the "all" in "all terminals" means). Not what it's for, not when it's looked up and used, not what its contents are. ######################################################################### The doc string for function-key-map is a little better. It, at least, attempts to give a context for the variable ("The parent keymap of all `local-function-key-map' instances."). The doc string gives an example of what belongs in the variable ("Function key definitions that apply to all terminal devices should go here."), but this doesn't define its contents. It contains more than function key definitions - for example, function keys with modifier keys, and modifier keys on their own (for example, a binding for event-apply-control-modifier). These are all documentation bugs. -- Alan Mackenzie (Nuremberg, Germany). From debbugs-submit-bounces@debbugs.gnu.org Fri Jul 29 03:19:56 2022 Received: (at 56816) by debbugs.gnu.org; 29 Jul 2022 07:19:56 +0000 Received: from localhost ([127.0.0.1]:59820 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1oHKHr-0001zl-LO for submit@debbugs.gnu.org; Fri, 29 Jul 2022 03:19:55 -0400 Received: from eggs.gnu.org ([209.51.188.92]:36192) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1oHKHq-0001zY-41 for 56816@debbugs.gnu.org; Fri, 29 Jul 2022 03:19:54 -0400 Received: from fencepost.gnu.org ([2001:470:142:3::e]:35046) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1oHKHk-0008IS-CY; Fri, 29 Jul 2022 03:19:48 -0400 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnu.org; s=fencepost-gnu-org; h=References:Subject:In-Reply-To:To:From:Date: mime-version; bh=VTgEPEmFA8MiGzsivvU4s4vx6+kcULfLeR5zGnkvLMU=; b=Vrt8d8PwKk3b 1WPFuzJ/X/9evo0wPb5hQbylEz0NQyZY6wDGHkoa4MwMlTfRHb1K/YC1KUMLxqB0F7tGawrbKNA/d yUneTfEy7wSR0KVdyAfKnJldlboaiTB9ClfgoOprxSHYxQc4p9GOcvzoyB4R1VaEBYDjKFIgaar1K W54AHdO2LDOQ+RFasuvLH8ycJps9kjkQpe+dg5lD14gt3vZ4RiJRAx7owQ9bOQ2iBswV8UJkfh+Lt uKvSeZ3zYFFadXeN7a0LTb2YeWiyCpjqmnb1XFGM64LpgYl9d53if9CYHD0F1NfPBJvJG0pSQF/jT qHcZy39KScxRb5gTNbTIfQ==; Received: from [87.69.77.57] (port=1503 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1oHKHj-0000fm-Kd; Fri, 29 Jul 2022 03:19:48 -0400 Date: Fri, 29 Jul 2022 10:19:59 +0300 Message-Id: <837d3w8jxc.fsf@gnu.org> From: Eli Zaretskii To: Alan Mackenzie In-Reply-To: (message from Alan Mackenzie on Thu, 28 Jul 2022 19:30:36 +0000) Subject: Re: bug#56816: Missing documentation of function-key-map References: X-Spam-Score: -2.3 (--) X-Debbugs-Envelope-To: 56816 Cc: 56816@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -3.3 (---) > Date: Thu, 28 Jul 2022 19:30:36 +0000 > From: Alan Mackenzie > > function-key-map is not defined in the Elisp manual. > > It is mentioned, in passing, on the page "Translation Keymaps" thusly: > > `local-function-key-map' inherits from `function-key-map'. The > latter should only be altered if you want the binding to apply in > all terminals, so using the former is almost always preferred. > > So, all we know about function-key-map is when to alter it (and even > here, it is unclear what the "all" in "all terminals" means). Not what > it's for, not when it's looked up and used, not what its contents are. > > ######################################################################### > > The doc string for function-key-map is a little better. It, at least, > attempts to give a context for the variable ("The parent keymap of all > `local-function-key-map' instances."). > > The doc string gives an example of what belongs in the variable > ("Function key definitions that apply to all terminal devices should go > here."), but this doesn't define its contents. It contains more than > function key definitions - for example, function keys with modifier keys, > and modifier keys on their own (for example, a binding for > event-apply-control-modifier). > > These are all documentation bugs. Would you please state clearly what exactly is a bug here? Specifically, what is missing from the doc string of this variable? Would saying something like "Keymap for bindings of function keys." be enough, or is some other information missing in your opinion, and if so, what? Once we are done with the doc string, we can discuss whether the manual needs any changes in this respect; in general, not every variable must be in the manual, and as long as the doc string is sufficient, we are fine. Thanks. From debbugs-submit-bounces@debbugs.gnu.org Fri Jul 29 15:50:47 2022 Received: (at 56816) by debbugs.gnu.org; 29 Jul 2022 19:50:47 +0000 Received: from localhost ([127.0.0.1]:33508 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1oHW0U-0008UC-Rb for submit@debbugs.gnu.org; Fri, 29 Jul 2022 15:50:47 -0400 Received: from colin.muc.de ([193.149.48.1]:37045 helo=mail.muc.de) by debbugs.gnu.org with smtp (Exim 4.84_2) (envelope-from ) id 1oHW0R-0008Tu-1P for 56816@debbugs.gnu.org; Fri, 29 Jul 2022 15:50:45 -0400 Received: (qmail 78368 invoked by uid 3782); 29 Jul 2022 19:50:36 -0000 Received: from acm.muc.de (p4fe1596f.dip0.t-ipconnect.de [79.225.89.111]) (using STARTTLS) by colin.muc.de (tmda-ofmipd) with ESMTP; Fri, 29 Jul 2022 21:50:36 +0200 Received: (qmail 9227 invoked by uid 1000); 29 Jul 2022 19:50:35 -0000 Date: Fri, 29 Jul 2022 19:50:35 +0000 To: Eli Zaretskii Subject: Re: bug#56816: Missing documentation of function-key-map Message-ID: References: <837d3w8jxc.fsf@gnu.org> MIME-Version: 1.0 Content-Type: text/plain; charset=iso-8859-1 Content-Disposition: inline Content-Transfer-Encoding: 8bit In-Reply-To: <837d3w8jxc.fsf@gnu.org> X-Submission-Agent: TMDA/1.3.x (Ph3nix) From: Alan Mackenzie X-Primary-Address: acm@muc.de X-Spam-Score: 0.0 (/) X-Debbugs-Envelope-To: 56816 Cc: 56816@debbugs.gnu.org, acm@muc.de X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -1.0 (-) Hello, Eli. On Fri, Jul 29, 2022 at 10:19:59 +0300, Eli Zaretskii wrote: > > Date: Thu, 28 Jul 2022 19:30:36 +0000 > > From: Alan Mackenzie > > function-key-map is not defined in the Elisp manual. > > It is mentioned, in passing, on the page "Translation Keymaps" thusly: > > `local-function-key-map' inherits from `function-key-map'. The > > latter should only be altered if you want the binding to apply in > > all terminals, so using the former is almost always preferred. > > So, all we know about function-key-map is when to alter it (and even > > here, it is unclear what the "all" in "all terminals" means). Not what > > it's for, not when it's looked up and used, not what its contents are. > > ######################################################################### > > The doc string for function-key-map is a little better. It, at least, > > attempts to give a context for the variable ("The parent keymap of all > > `local-function-key-map' instances."). > > The doc string gives an example of what belongs in the variable > > ("Function key definitions that apply to all terminal devices should go > > here."), but this doesn't define its contents. It contains more than > > function key definitions - for example, function keys with modifier keys, > > and modifier keys on their own (for example, a binding for > > event-apply-control-modifier). > > These are all documentation bugs. > Would you please state clearly what exactly is a bug here? That there is a reference to function-key-map in that manual page, but there is no description of function-key-map whatsoever in the manual. If things are to stay that way, perhaps we could add something like "(not documented in this manual. See the variable's doc string for details.)" as a footnote. > Specifically, what is missing from the doc string of this variable? > Would saying something like "Keymap for bindings of function keys." be > enough, or is some other information missing in your opinion, and if > so, what? That description would be a big improvement. Perhaps it could also say "including modifiers for some keys" or something like that; The modifiers, all 7 combinations, are included for each keypad key, but not for the other function keys. > Once we are done with the doc string, we can discuss whether the > manual needs any changes in this respect; in general, not every > variable must be in the manual, and as long as the doc string is > sufficient, we are fine. I'll tell you what gave rise to this. On a proprietary system in my day job, typing C-M-a is giving the result M-á, and similarly for the other four vowels with C-M-. This should be relatively straightforward to remedy, but I've been struggling with that manual page for two evenings, now. The manual page ("Translation Keymaps") seems to have most of the information, but there is little clarity and little redundancy. I think I need to add a binding for M-á to convert it to C-M-a, but in which keymap? There are three keymaps described on the page, but their purposes are not entirely clear. One of them is the one I need, I think. It surely shouldn't take several hours to digest the information on a single moderately sized info page. > Thanks. -- Alan Mackenzie (Nuremberg, Germany). From debbugs-submit-bounces@debbugs.gnu.org Fri Jul 29 15:55:46 2022 Received: (at 56816) by debbugs.gnu.org; 29 Jul 2022 19:55:46 +0000 Received: from localhost ([127.0.0.1]:33516 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1oHW5J-0000At-V9 for submit@debbugs.gnu.org; Fri, 29 Jul 2022 15:55:46 -0400 Received: from heytings.org ([95.142.160.155]:58174) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1oHW5I-0000Am-JW for 56816@debbugs.gnu.org; Fri, 29 Jul 2022 15:55:45 -0400 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=heytings.org; s=20220101; t=1659124543; bh=vikAsyIrnOmJ4s/B0tsRAbJSakhTPD5R9KmRgqA9DPA=; h=Date:From:To:cc:Subject:In-Reply-To:Message-ID:References:From; b=qKfvgag92qsWxYpHteoiey9gf1O/irbnUSfv6h4AMFHjXVp+6kIFiDu2bg2Fl0vbU AQ1I/MOuhx8E+02nsoNMrBydezoXsBXgSEJzrEX8YX+j4xqtVn6XPKBids46nDtCqH O5GKyPuIa/Jw9o3o4uy1nhPUjJiDuvFtmIWiyIr5lVBzZzOLINjsBYbwRxgvNF4ucC DRQxVgCPVnI9AIA041IEgsh8FQdjsRA71BCpKykl/26iKHP48xKPVQKwrs8t5goA0L JcfVKACqTwhdnYy7WzdWJP3ZaZzwU/QjBhjoOZ91xUTqk41ejJ+5/yJl/mTmhlBc0W t2GBoaWkloK6Q== Date: Fri, 29 Jul 2022 19:55:43 +0000 From: Gregory Heytings To: Alan Mackenzie Subject: Re: bug#56816: Missing documentation of function-key-map In-Reply-To: Message-ID: References: <837d3w8jxc.fsf@gnu.org> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii; format=flowed X-Spam-Score: -0.0 (/) X-Debbugs-Envelope-To: 56816 Cc: 56816@debbugs.gnu.org, Eli Zaretskii X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -1.0 (-) > > there is no description of function-key-map whatsoever in the manual. > M-: (info "(elisp) Standard Keymaps") RET C-s fun RET From debbugs-submit-bounces@debbugs.gnu.org Fri Jul 29 16:44:30 2022 Received: (at 56816) by debbugs.gnu.org; 29 Jul 2022 20:44:30 +0000 Received: from localhost ([127.0.0.1]:33556 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1oHWqU-0001W4-32 for submit@debbugs.gnu.org; Fri, 29 Jul 2022 16:44:30 -0400 Received: from colin.muc.de ([193.149.48.1]:38423 helo=mail.muc.de) by debbugs.gnu.org with smtp (Exim 4.84_2) (envelope-from ) id 1oHWqP-0001Vh-Lz for 56816@debbugs.gnu.org; Fri, 29 Jul 2022 16:44:29 -0400 Received: (qmail 16124 invoked by uid 3782); 29 Jul 2022 20:44:18 -0000 Received: from acm.muc.de (p4fe1596f.dip0.t-ipconnect.de [79.225.89.111]) (using STARTTLS) by colin.muc.de (tmda-ofmipd) with ESMTP; Fri, 29 Jul 2022 22:44:18 +0200 Received: (qmail 24383 invoked by uid 1000); 29 Jul 2022 20:44:17 -0000 Date: Fri, 29 Jul 2022 20:44:17 +0000 To: Gregory Heytings Subject: Re: bug#56816: Missing documentation of function-key-map Message-ID: References: <837d3w8jxc.fsf@gnu.org> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: X-Submission-Agent: TMDA/1.3.x (Ph3nix) From: Alan Mackenzie X-Primary-Address: acm@muc.de X-Spam-Score: 0.0 (/) X-Debbugs-Envelope-To: 56816 Cc: 56816@debbugs.gnu.org, Eli Zaretskii X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -1.0 (-) Hello, Gregory. On Fri, Jul 29, 2022 at 19:55:43 +0000, Gregory Heytings wrote: > > there is no description of function-key-map whatsoever in the manual. > M-: (info "(elisp) Standard Keymaps") RET C-s fun RET Thanks! I ought to have just said there is no index entry for function-key-map. Even then, the description on "Standard Keymaps" is not good. Rather than saying what function-key-map _is_, it merely describes its relationship to some other keymaps. -- Alan Mackenzie (Nuremberg, Germany). From debbugs-submit-bounces@debbugs.gnu.org Sat Jul 30 02:42:29 2022 Received: (at 56816) by debbugs.gnu.org; 30 Jul 2022 06:42:29 +0000 Received: from localhost ([127.0.0.1]:33796 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1oHgBB-0002e1-AT for submit@debbugs.gnu.org; Sat, 30 Jul 2022 02:42:29 -0400 Received: from eggs.gnu.org ([209.51.188.92]:49566) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1oHgB6-0002dm-OA for 56816@debbugs.gnu.org; Sat, 30 Jul 2022 02:42:28 -0400 Received: from fencepost.gnu.org ([2001:470:142:3::e]:59956) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1oHgB0-0007qS-RV; Sat, 30 Jul 2022 02:42:18 -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=d/2ZeYTwtUyyOuoHqvke3Z06PVLunhSfPlMFY/abIU4=; b=XNaC0c9OvYoIYLE0UgUL GVaUSujtDS2DCyLo1zy8Wg2A/07Hg20TT6GCnhRghiF9jEDM07+qIdPXGEizmVM9ZWkj/lQ6cKFoD A21ZR9xlmlFjbvm3F+7NdW53M+FxOYImTm5dJkVIlerNJKh9HeUPLVRAfxG8VcDzUroecsEwFbJkU JGC0kvAWmW0DF/UZVWQtlJ+DZoo4AsSg/C42IryIT3KSIT9IKBMZq55IfXXUb77FR1zcHnNQLX/Ld KjhpVYVYz8Ub1Na5uHCXr7/2d/J/Sb0rnachPo3TYJQwHDREI+MEOyiVEds8AWLE+evzcbPfHtZaF HqNMUhJXfOBOoQ==; Received: from [87.69.77.57] (port=4146 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1oHgAz-0001Mo-D4; Sat, 30 Jul 2022 02:42:18 -0400 Date: Sat, 30 Jul 2022 09:42:14 +0300 Message-Id: <83zggr5cft.fsf@gnu.org> From: Eli Zaretskii To: Alan Mackenzie In-Reply-To: (message from Alan Mackenzie on Fri, 29 Jul 2022 19:50:35 +0000) Subject: Re: bug#56816: Missing documentation of function-key-map References: <837d3w8jxc.fsf@gnu.org> MIME-version: 1.0 Content-type: text/plain; charset=iso-8859-1 Content-Transfer-Encoding: 8bit X-Spam-Score: -2.3 (--) X-Debbugs-Envelope-To: 56816 Cc: 56816@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -3.3 (---) > Date: Fri, 29 Jul 2022 19:50:35 +0000 > Cc: 56816@debbugs.gnu.org, acm@muc.de > From: Alan Mackenzie > > > > These are all documentation bugs. > > > Would you please state clearly what exactly is a bug here? > > That there is a reference to function-key-map in that manual page, but > there is no description of function-key-map whatsoever in the manual. If > things are to stay that way, perhaps we could add something like "(not > documented in this manual. See the variable's doc string for details.)" > as a footnote. The real description is in "Translation Keymaps" (where you get by following the cross-reference near local-function-key-map, which itself is referenced from function-key-map). I've now added an index entry for function-key-map in "Translation Keymaps". > > Specifically, what is missing from the doc string of this variable? > > Would saying something like "Keymap for bindings of function keys." be > > enough, or is some other information missing in your opinion, and if > > so, what? > > That description would be a big improvement. Perhaps it could also say > "including modifiers for some keys" or something like that; The > modifiers, all 7 combinations, are included for each keypad key, but not > for the other function keys. The doc string includes a link top local-function-key-map, whose doc string describes some more. Given all of the above, what else is missing? Please be specific. > > Once we are done with the doc string, we can discuss whether the > > manual needs any changes in this respect; in general, not every > > variable must be in the manual, and as long as the doc string is > > sufficient, we are fine. > > I'll tell you what gave rise to this. On a proprietary system in my day > job, typing C-M-a is giving the result M-á, and similarly for the other > four vowels with C-M-. This should be relatively straightforward to > remedy, but I've been struggling with that manual page for two evenings, > now. The manual page ("Translation Keymaps") seems to have most of the > information, but there is little clarity and little redundancy. I think > I need to add a binding for M-á to convert it to C-M-a, but in which > keymap? There are three keymaps described on the page, but their > purposes are not entirely clear. One of them is the one I need, I think. This doesn't really help, because I don't see how what you describe is related to the stuff that is or isn't in the documentation. I'm not even sure I understand why you think function-key-map is what you need to investigate, and how are your needs related to what, if anything, is wrong with or missing from the material in "Translation Keymaps". "Little clarity and little redundancy" doesn't help me understand what needs to be done. From debbugs-submit-bounces@debbugs.gnu.org Sat Jul 30 02:43:42 2022 Received: (at 56816) by debbugs.gnu.org; 30 Jul 2022 06:43:42 +0000 Received: from localhost ([127.0.0.1]:33801 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1oHgCL-0002g2-RM for submit@debbugs.gnu.org; Sat, 30 Jul 2022 02:43:42 -0400 Received: from eggs.gnu.org ([209.51.188.92]:49666) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1oHgCI-0002fi-7f for 56816@debbugs.gnu.org; Sat, 30 Jul 2022 02:43:40 -0400 Received: from fencepost.gnu.org ([2001:470:142:3::e]:59964) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1oHgCC-00080E-8w; Sat, 30 Jul 2022 02:43:32 -0400 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnu.org; s=fencepost-gnu-org; h=References:Subject:In-Reply-To:To:From:Date: mime-version; bh=2fOm2z4xb7BTpgPp6jF50bG3udiBHW8uvJeGadF2XhI=; b=d/U6FEjiWy/u Y0GbNcEUbHkCwYSU2dwglDN3hGxiomd22868E6i4lTW4LsVYAyf95bMni4rt8Q6r2tGEz31GP3wUj 1/5BdR8r/EnYU2KEcHjryTJD70U7d38WWIMu625/K+XYAfVuHXPOMeRDvl+IY0qCaKP9xwwcT2kaN PUE6Vwx7aHwddakmHxeBbBDYYdXkA3HxkZHW28qnWhYk7+lXtvtOUtwTrW8r6WWazsUqu2kQYYW7R 9GZEcUWz39gtLqZWRinfySFHq2F2ldTYdCaUXu675FZcIwxbUwPZhi7CHl2VMitS8vWESqZ/FL8T1 Xfjqa4eEP8G+vPqHjEweQQ==; Received: from [87.69.77.57] (port=4219 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1oHgC9-00035Z-Pn; Sat, 30 Jul 2022 02:43:31 -0400 Date: Sat, 30 Jul 2022 09:43:26 +0300 Message-Id: <83y1wb5cdt.fsf@gnu.org> From: Eli Zaretskii To: Alan Mackenzie In-Reply-To: (message from Alan Mackenzie on Fri, 29 Jul 2022 20:44:17 +0000) Subject: Re: bug#56816: Missing documentation of function-key-map References: <837d3w8jxc.fsf@gnu.org> X-Spam-Score: -2.3 (--) X-Debbugs-Envelope-To: 56816 Cc: 56816@debbugs.gnu.org, gregory@heytings.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -3.3 (---) > Date: Fri, 29 Jul 2022 20:44:17 +0000 > Cc: Eli Zaretskii , 56816@debbugs.gnu.org > From: Alan Mackenzie > > > M-: (info "(elisp) Standard Keymaps") RET C-s fun RET > > Thanks! I ought to have just said there is no index entry for > function-key-map. That is now fixed. > Even then, the description on "Standard Keymaps" is not good. Rather > than saying what function-key-map _is_, it merely describes its > relationship to some other keymaps. That node is just a list, the real description is in the places to which you get by following the cross-references. From debbugs-submit-bounces@debbugs.gnu.org Sat Jul 30 11:29:49 2022 Received: (at 56816) by debbugs.gnu.org; 30 Jul 2022 15:29:49 +0000 Received: from localhost ([127.0.0.1]:35613 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1oHoPV-00018A-DG for submit@debbugs.gnu.org; Sat, 30 Jul 2022 11:29:49 -0400 Received: from mx0b-00069f02.pphosted.com ([205.220.177.32]:6982) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1oHoPP-00017z-Sj for 56816@debbugs.gnu.org; Sat, 30 Jul 2022 11:29:48 -0400 Received: from pps.filterd (m0246631.ppops.net [127.0.0.1]) by mx0b-00069f02.pphosted.com (8.17.1.5/8.17.1.5) with ESMTP id 26U5kIpb001592; Sat, 30 Jul 2022 15:29:43 GMT DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=oracle.com; h=from : to : cc : subject : date : message-id : references : in-reply-to : content-type : content-transfer-encoding : mime-version; s=corp-2022-7-12; bh=WGn8yo5H6JBYONN5yHWsaekpi8Qtz1EKid0q22bduPQ=; b=n3khZGE57qDF0kOICped0nZn7LULLS02KEe/iFXbGZaRhSt9X3TZDWSzwffQ2nkUnq11 WK4D42PLs9+BEjIb/tzv23DMyvPwW7Vod5y8iAr4gXVl78seXJYjzA+aZ4V/IFResSzo bK/NrhaQR4DhhZpM750pNOLPamlHauSJiL7du/xX1PbbuMAtad2f/BBrCtuz7+FdilEA Odzlz071uwpUDROxgfktKnDVrVVWi+XJnBr+eEFZtX43Bl+ZeIBE86xhIyJ4dKapdQwG KdZ/X73b/BiOTQTS8erxYG5SOUZ7fSh19tUaHLsSM5a7N2Sdw0nEihu/Cq2KSYfbjumv Pw== Received: from phxpaimrmta02.imrmtpd1.prodappphxaev1.oraclevcn.com (phxpaimrmta02.appoci.oracle.com [147.154.114.232]) by mx0b-00069f02.pphosted.com (PPS) with ESMTPS id 3hmue2ghth-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Sat, 30 Jul 2022 15:29:43 +0000 Received: from pps.filterd (phxpaimrmta02.imrmtpd1.prodappphxaev1.oraclevcn.com [127.0.0.1]) by phxpaimrmta02.imrmtpd1.prodappphxaev1.oraclevcn.com (8.17.1.5/8.17.1.5) with ESMTP id 26U9r90u007338; Sat, 30 Jul 2022 15:29:42 GMT Received: from nam11-dm6-obe.outbound.protection.outlook.com (mail-dm6nam11lp2175.outbound.protection.outlook.com [104.47.57.175]) by phxpaimrmta02.imrmtpd1.prodappphxaev1.oraclevcn.com (PPS) with ESMTPS id 3hmu300204-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Sat, 30 Jul 2022 15:29:42 +0000 ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=kfgwP7IYY1gpfOpHNs2xOs/77VgZ7URDSY5vGpuPICR7yI4x7Q7ys/4MDmKppmlvxHGYO3M+qQ6ZrMolOB4ValZ/zHXGQoUKjksxs32A2qPDBmKh4isAbhhShRjtzKpb52R7sdj+7igOX+ZqrIDEXzgg2GltVknXoqcPp+dqTdOr6Cn+2grMXDJ8XGfYWCCAY2cN9Y1Ys1eXTP77e5G8IHpP3NVKpRg1Ph/6dySovlyEIDUQJrErE57DnRqOaTpZwhdxA90TBMsfaAc5zu8Yz5nM8V4LSSJklvItB0goSXscIs3FNv2WIrUdaP7uox8GlJqJ852dtxTV10dpJVNT4w== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=microsoft.com; s=arcselector9901; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-AntiSpam-MessageData-ChunkCount:X-MS-Exchange-AntiSpam-MessageData-0:X-MS-Exchange-AntiSpam-MessageData-1; bh=WGn8yo5H6JBYONN5yHWsaekpi8Qtz1EKid0q22bduPQ=; b=IVGFgfev5hzE0Q8Rw7nrfSIAfVJ2rwF0BttiSQejLzAwZzK9nsokCnhunHbffovxc0ofXtINlkJRUs9RDHTn+WjuPB2klJGwkAGBQaljt6Ew+Jle0pjnQam4NKyLrce5KixnPRkkFPr1ZCFvo7MpRVhW5aYnNNA3CvPaWngJy+QMJ9EQDXuX7wUGXZ6ZFhCX6wxvcYT0xJnwxikd3oz93Sj9Su8XMbdj1gX4GrsyFsbc5e0CdIOl/NlsvV50RHOdPhaS5TKmfZ85xidoFCV+sx1xgm2fD+uhg/y8cDt83rJYIrRGtT5Vv5oe5qQGIjQbBlaFg+sgHLC+4HGV6prnOg== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass smtp.mailfrom=oracle.com; dmarc=pass action=none header.from=oracle.com; dkim=pass header.d=oracle.com; arc=none DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=oracle.onmicrosoft.com; s=selector2-oracle-onmicrosoft-com; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=WGn8yo5H6JBYONN5yHWsaekpi8Qtz1EKid0q22bduPQ=; b=HE1b/wDlpdXJcHmCi9fJ1/t057AD8BWcoZJK9TIO4vyLSj0NLK4cVUYuWMUIsUYqmrbEfHFw0YlCo5rEU2cHEPafovWnZtgytmhAVBqJ7Rf/VtN5hH40lCvKYOQQA9EhFe0NFlBtZ4noJNVipayRArfy4KUla5zTatd3jZUlcwA= Received: from SJ0PR10MB5488.namprd10.prod.outlook.com (2603:10b6:a03:37e::19) by MW4PR10MB6632.namprd10.prod.outlook.com (2603:10b6:303:227::19) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.5482.11; Sat, 30 Jul 2022 15:29:38 +0000 Received: from SJ0PR10MB5488.namprd10.prod.outlook.com ([fe80::8d65:31e6:cd0e:e95]) by SJ0PR10MB5488.namprd10.prod.outlook.com ([fe80::8d65:31e6:cd0e:e95%5]) with mapi id 15.20.5482.014; Sat, 30 Jul 2022 15:29:38 +0000 From: Drew Adams To: Eli Zaretskii , Alan Mackenzie Subject: RE: [External] : bug#56816: Missing documentation of function-key-map Thread-Topic: [External] : bug#56816: Missing documentation of function-key-map Thread-Index: AQHYo9+qCdV9zYusZkmFpTs5mjZ3/62XCmHg Date: Sat, 30 Jul 2022 15:29:38 +0000 Message-ID: References: <837d3w8jxc.fsf@gnu.org> <83zggr5cft.fsf@gnu.org> In-Reply-To: <83zggr5cft.fsf@gnu.org> Accept-Language: en-US Content-Language: en-US X-MS-Has-Attach: X-MS-TNEF-Correlator: x-ms-publictraffictype: Email x-ms-office365-filtering-correlation-id: ac04e9e5-8f19-4a25-a254-08da724050e9 x-ms-traffictypediagnostic: MW4PR10MB6632:EE_ x-ms-exchange-senderadcheck: 1 x-ms-exchange-antispam-relay: 0 x-microsoft-antispam: BCL:0; x-microsoft-antispam-message-info: Rrz1AuYiFDmt6bUhLocK6w2olvsbG4oyHaTVukDzpROoRB7Lu+T5d8vZ2g32wFAv0wrvj+05qs1q+OsMl/XqoKjHd9gMhkaKQF67Mptn97MoaKtRNEWxZeCZvJqpno7svK068KCmgx/Rz39jo9DK8B32OyKCBTEsIBy8Orzf/vPz4V8fwddtGzJwCCW69XATFpyRKPiaD43HCTdMGbVAC8q0B8gyV8iIQ8WwYwgxWTmvvJwFIDCleDxPG3KuiC3OGg+XuOnYdjo1q7zfxxpBdB0g3qyKGthvoevnEgd9oJyZiiTiKrhxLth24iZ7j4lYuJ28xHMye4o7ABpsUuUXgpx33L8/CUIyxzvDvO3BFOnbPWJiCE8U5uSH8u8YkzTlI+R+NSw1H1kn5cvAupkKB2AE13PJHAvONx7IrLoPb7VGruvMF6wMsa0K06PqYrn+UWoMbor4xAGEjAS0u83BpaWRRzrelocoH5xSprIzyZbTFqs60wIhMP6lfAe3rT1O4W5No60TS4VXKT5lGUTVVLzfip7fCohWK8z9+5YQIXZ+yuSdqT6tylh/87EX9L9YQXkZ4Y5wFA2xFPLC70f50NcehMwTUXc4pakJHmbHu2tnag80gXldQrpS0eYVoPF5ocQTsHi8B0xnucXnhBX31Kn97K026yFVDxowof8s+vFVjFYqeYMSFujFo9lZOKge0fEIhfqX/t8CwqUoYEaMDsZH26jigDuZraPdink/bT+NQLa31zvfCW/zueJDusxHakVY/mPBRg/s4BdZ2Pf2MthMi/FJYfCkcN5+tf+cvoqOuscus0XGOl2JvWTJpvn3 x-forefront-antispam-report: CIP:255.255.255.255; CTRY:; LANG:en; SCL:1; SRV:; IPV:NLI; SFV:NSPM; H:SJ0PR10MB5488.namprd10.prod.outlook.com; PTR:; CAT:NONE; SFS:(13230016)(136003)(366004)(396003)(346002)(376002)(39860400002)(316002)(110136005)(186003)(44832011)(558084003)(55016003)(122000001)(38100700002)(76116006)(71200400001)(66946007)(66476007)(38070700005)(66446008)(64756008)(8676002)(4326008)(66556008)(33656002)(478600001)(5660300002)(7696005)(6506007)(52536014)(8936002)(41300700001)(26005)(86362001)(9686003)(2906002); DIR:OUT; SFP:1101; x-ms-exchange-antispam-messagedata-chunkcount: 1 x-ms-exchange-antispam-messagedata-0: =?us-ascii?Q?eELBhJrtzg3/zFXwrThSMKMRN46+IsDXv/QQAFmvF6LXvvpTevkQQHskKSx/?= =?us-ascii?Q?VeQiT0rMmoVgSYLctfy58pVRSX1yY2vBCxtvnrL942OZyayU/NdhZNIyWNEN?= =?us-ascii?Q?jyR7Lz7+7cGe8Jqaltmf3iyfE/7y6zKjmfV6oNXorMzCtR2HsMZH/fBMNRwP?= =?us-ascii?Q?mpf9DdXdTH0jV8nKSNBNxxKPZSB02gO2wUnyFc1reQUpINt3O8PyEaRAkCIE?= =?us-ascii?Q?+WUXevuJbCgJdD+ne8/Vjbfl0k9lzb69xdund/fz8Odb90BUFgIJupEKAFJ8?= =?us-ascii?Q?bNeqe2KwPoMPfUkaSe1KHVeb6fgfiyTDvbbzpTKoF2Dy3i9sKbefwTkPIL0b?= =?us-ascii?Q?29Zad2ovARcesjYHKV5INPMiYIHnOVRqpsKZHHiVYA7qRoktGYm2QdGTysNt?= =?us-ascii?Q?cQ006YrNDcMSfsEoNhdLgufld/wDyx5fpkGMFnwQ4ZhFwt6WfDyhN3JTlNTu?= =?us-ascii?Q?0LIMRc/xBTHV9I5vE7yo2aMR33c8UfjvBOpNl47UgONB0s5w3AKRBw/d2v9X?= =?us-ascii?Q?LzFyCw3+SJ0J4/nYA28qQpkMlwCdofgWOB1j+b8prGTGfFW6naBs/u6y79Ay?= =?us-ascii?Q?4DNSd6Yf36EmrPyuLMHkr2n8XZN3VTQO1bK+nm0WEisqrnmWJLYjWsCgoqfn?= =?us-ascii?Q?jC/KQ2u5CUyYZIlhyQJiJtwX4gR2QpMTINNJ+cHmd/B2aE8wWXKTYkE2PKEN?= =?us-ascii?Q?jwz2nHiaA9po7Q1tXfSF98zQPzummVhLSuID3cOTlWJwJAoa8OC/u1ITqxNN?= =?us-ascii?Q?QdWEDK49lWnEhoJ1ABR88Eviewr1JDLfwYkudjlktsG7CJt2N+/o+Ja0KqQU?= =?us-ascii?Q?TYYouKrbDv1sFg8azWr32AZHX/8TUZscteyoqCvu0Pu8RsnaA7zsfJE7uZ3p?= =?us-ascii?Q?G4ZkZ4dubDlEivsZ/GcbUtaEFfG7/ZwRSNkT+7WSuUh5sggXsZf0npanF1PF?= =?us-ascii?Q?LfXYMgKxahRf8d7mBcs7S9dGIbDgyf3YUsqhyN3VPVWaduibcUH1qinjz/e1?= =?us-ascii?Q?nycaF0UJ/g3WZSbAwTCII/nzUoWrhsZYDfivB0njFww+yynfDjjnApyDNJFh?= =?us-ascii?Q?VyL7igKU4e0C1m9u3wZGlxANNzlLG3nQJHaDQb3kwwVSd2IMzxA7pAEVOGVN?= =?us-ascii?Q?hNBn/K98zo1PxrE4bT1C2VIxgtuQr/iDS3KWrPjNsf6PVSF7Q1qPneHnT/o7?= =?us-ascii?Q?S1dZRTh3MFZaqFp/CF030O3uZlBgkaUCZlef3/s1qHhT1Yodffi6sbeHXtBj?= =?us-ascii?Q?1DKXYrZcEMVef1xFi6ok2uE9/OEYv7L5uzfX84BKZNTXaUs1G1PCKNp2mxMu?= =?us-ascii?Q?uT4MH+sdHxVN4I4M2w2fLD13pAwXH4gg4XoejQB7zCeM8cBWwh4FaiftCEi9?= =?us-ascii?Q?8lj/L1oImqbDUTUKheYKn4GPX8MmarZdWv/UFkldwI0V6XridiGZB1vzarV5?= =?us-ascii?Q?Qkkb1yLzgth8IXxJQSO2uWnEAi46ubhcuS4NmonQu/tyVyVduAyn8azZcHRt?= =?us-ascii?Q?NsOzv3n6Dd2ZfYDG8z1SNOCPVlCjj94iJL7RzUOEaN6kD0kM5Yy7fcMa6hCL?= =?us-ascii?Q?u0yozg4L+yzw6OxM0wFAFxn1Xces9fUKxl2tCvOS?= Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: quoted-printable MIME-Version: 1.0 X-OriginatorOrg: oracle.com X-MS-Exchange-CrossTenant-AuthAs: Internal X-MS-Exchange-CrossTenant-AuthSource: SJ0PR10MB5488.namprd10.prod.outlook.com X-MS-Exchange-CrossTenant-Network-Message-Id: ac04e9e5-8f19-4a25-a254-08da724050e9 X-MS-Exchange-CrossTenant-originalarrivaltime: 30 Jul 2022 15:29:38.7151 (UTC) X-MS-Exchange-CrossTenant-fromentityheader: Hosted X-MS-Exchange-CrossTenant-id: 4e2c6054-71cb-48f1-bd6c-3a9705aca71b X-MS-Exchange-CrossTenant-mailboxtype: HOSTED X-MS-Exchange-CrossTenant-userprincipalname: SJx1NUWfGC11gzpVJZ7lJFEAq/h5HpwCE0wQoyvZWMQTCAq/U8aUvtvb7dTGtGdf8utBdL9w+e88G1GPh77TAQ== X-MS-Exchange-Transport-CrossTenantHeadersStamped: MW4PR10MB6632 X-Proofpoint-Virus-Version: vendor=baseguard engine=ICAP:2.0.205,Aquarius:18.0.883,Hydra:6.0.517,FMLib:17.11.122.1 definitions=2022-07-30_07,2022-07-28_02,2022-06-22_01 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 spamscore=0 mlxscore=0 suspectscore=0 adultscore=0 bulkscore=0 malwarescore=0 mlxlogscore=934 phishscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.12.0-2206140000 definitions=main-2207300077 X-Proofpoint-ORIG-GUID: X13U8vN9vlCqwEC4XjAxM6DYaAg_vhvq X-Proofpoint-GUID: X13U8vN9vlCqwEC4XjAxM6DYaAg_vhvq X-Spam-Score: -0.7 (/) X-Debbugs-Envelope-To: 56816 Cc: "56816@debbugs.gnu.org" <56816@debbugs.gnu.org> X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -1.7 (-) > I've now added an index entry for > function-key-map in "Translation Keymaps". +1