From unknown Mon Sep 08 03:16:19 2025 X-Loop: help-debbugs@gnu.org Subject: bug#11522: 24.0.97; Bad doc about minor mode keys: (elisp) `Keymaps and Minor Modes' Resent-From: "Drew Adams" Original-Sender: debbugs-submit-bounces@debbugs.gnu.org Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sat, 19 May 2012 21:02:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 11522 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: 11522@debbugs.gnu.org X-Debbugs-Original-To: Received: via spool by submit@debbugs.gnu.org id=B.133746127619618 (code B ref -1); Sat, 19 May 2012 21:02:01 +0000 Received: (at submit) by debbugs.gnu.org; 19 May 2012 21:01:16 +0000 Received: from localhost ([127.0.0.1]:34728 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1SVqm2-00056M-Vv for submit@debbugs.gnu.org; Sat, 19 May 2012 17:01:15 -0400 Received: from eggs.gnu.org ([208.118.235.92]:48815) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1SVqlz-00056A-U4 for submit@debbugs.gnu.org; Sat, 19 May 2012 17:01:12 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1SVqlR-0002Ij-1L for submit@debbugs.gnu.org; Sat, 19 May 2012 17:00:38 -0400 X-Spam-Checker-Version: SpamAssassin 3.3.2 (2011-06-06) on eggs.gnu.org X-Spam-Level: X-Spam-Status: No, score=-6.9 required=5.0 tests=BAYES_00,RCVD_IN_DNSWL_HI, UNPARSEABLE_RELAY autolearn=unavailable version=3.3.2 Received: from lists.gnu.org ([208.118.235.17]:39931) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1SVqlQ-0002Ie-UC for submit@debbugs.gnu.org; Sat, 19 May 2012 17:00:36 -0400 Received: from eggs.gnu.org ([208.118.235.92]:34764) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1SVqlO-0004kv-TQ for bug-gnu-emacs@gnu.org; Sat, 19 May 2012 17:00:36 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1SVqlM-0002Hu-UF for bug-gnu-emacs@gnu.org; Sat, 19 May 2012 17:00:34 -0400 Received: from rcsinet15.oracle.com ([148.87.113.117]:34027) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1SVqlM-0002HL-Ma for bug-gnu-emacs@gnu.org; Sat, 19 May 2012 17:00:32 -0400 Received: from acsinet22.oracle.com (acsinet22.oracle.com [141.146.126.238]) by rcsinet15.oracle.com (Sentrion-MTA-4.2.2/Sentrion-MTA-4.2.2) with ESMTP id q4JL0RH2028010 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK) for ; Sat, 19 May 2012 21:00:28 GMT Received: from acsmt358.oracle.com (acsmt358.oracle.com [141.146.40.158]) by acsinet22.oracle.com (8.14.4+Sun/8.14.4) with ESMTP id q4JL0RLv013115 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO) for ; Sat, 19 May 2012 21:00:27 GMT Received: from abhmt108.oracle.com (abhmt108.oracle.com [141.146.116.60]) by acsmt358.oracle.com (8.12.11.20060308/8.12.11) with ESMTP id q4JL0RM8027392 for ; Sat, 19 May 2012 16:00:27 -0500 Received: from dradamslap1 (/10.159.216.57) by default (Oracle Beehive Gateway v4.0) with ESMTP ; Sat, 19 May 2012 14:00:26 -0700 From: "Drew Adams" Date: Sat, 19 May 2012 14:00:19 -0700 Message-ID: <81E97418F9F04B889D43F7D133F0356A@us.oracle.com> MIME-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit X-Mailer: Microsoft Office Outlook 11 Thread-Index: Ac02AmX8QYUn2uCkTmG8aHRu5kGr0Q== X-MimeOLE: Produced By Microsoft MimeOLE V6.00.2900.6157 X-Source-IP: acsinet22.oracle.com [141.146.126.238] X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 1) X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 3) X-Received-From: 208.118.235.17 X-Spam-Score: -6.1 (------) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.13 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: debbugs-submit-bounces@debbugs.gnu.org Errors-To: debbugs-submit-bounces@debbugs.gnu.org X-Spam-Score: -6.1 (------) What (elisp) `Keymaps and Minor Modes' says is horribly wrong: "The key sequences bound in a minor mode should consist of `C-c' followed by one of `.,/?`'"[]\|~!#$%^&*()-_+='. (The other punctuation characters are reserved for major modes.)" Absolutely not. The `C-c' minor-mode keys, yes. Minor-mode keys in general, no. What it is correct to say about minor-mode key bindings is said, carefully, in (elisp) `Key Binding Conventions'. Nothing more restrictive than that. And it is better to provide a link to that page than it is to try to repeat that information in `Keymaps and Minor Modes'. Regarding `C-c' key sequences: Few of them are reserved for major modes. The rest of them are allocated to minor modes or to users (`C-c' + letter). That's the way the C-c-plus-punctuation restriction should be presented: Minor modes get all C-c-plus-punctuation bindings not mentioned in the major-mode list, and those are the only `C-c' keys they get. But the real doc bug here is that it says that minor-mode keys are limited to `C-c' followed by a punctuation mark from the list shown. Not at all. Minor modes, like major modes, are by no means limited to keys on prefix `C-c'! In GNU Emacs 24.0.97.1 (i386-mingw-nt5.1.2600) of 2012-05-16 on MARVIN Windowing system distributor `Microsoft Corp.', version 5.1.2600 Configured using: `configure --with-gcc (4.6) --no-opt --enable-checking --cflags -ID:/devel/emacs/libs/libXpm-3.5.8/include -ID:/devel/emacs/libs/libXpm-3.5.8/src -ID:/devel/emacs/libs/libpng-dev_1.4.3-1/include -ID:/devel/emacs/libs/zlib-dev_1.2.5-2/include -ID:/devel/emacs/libs/giflib-4.1.4-1/include -ID:/devel/emacs/libs/jpeg-6b-4/include -ID:/devel/emacs/libs/tiff-3.8.2-1/include -ID:/devel/emacs/libs/gnutls-3.0.9/include' From unknown Mon Sep 08 03:16:19 2025 X-Loop: help-debbugs@gnu.org Subject: bug#11522: 24.0.97; Bad doc about minor mode keys: (elisp) `Keymaps and Minor Modes' Resent-From: "Drew Adams" Original-Sender: debbugs-submit-bounces@debbugs.gnu.org Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sun, 16 Sep 2012 23:56:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 11522 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: <11522@debbugs.gnu.org> Received: via spool by 11522-submit@debbugs.gnu.org id=B11522.134783972123107 (code B ref 11522); Sun, 16 Sep 2012 23:56:01 +0000 Received: (at 11522) by debbugs.gnu.org; 16 Sep 2012 23:55:21 +0000 Received: from localhost ([127.0.0.1]:37804 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1TDOgL-00060d-1I for submit@debbugs.gnu.org; Sun, 16 Sep 2012 19:55:21 -0400 Received: from rcsinet15.oracle.com ([148.87.113.117]:47640) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1TDOgI-00060W-Gm for 11522@debbugs.gnu.org; Sun, 16 Sep 2012 19:55:19 -0400 Received: from acsinet21.oracle.com (acsinet21.oracle.com [141.146.126.237]) by rcsinet15.oracle.com (Sentrion-MTA-4.2.2/Sentrion-MTA-4.2.2) with ESMTP id q8GNs6dw003067 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK) for <11522@debbugs.gnu.org>; Sun, 16 Sep 2012 23:54:07 GMT Received: from acsmt358.oracle.com (acsmt358.oracle.com [141.146.40.158]) by acsinet21.oracle.com (8.14.4+Sun/8.14.4) with ESMTP id q8GNs5K1020354 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO) for <11522@debbugs.gnu.org>; Sun, 16 Sep 2012 23:54:06 GMT Received: from abhmt117.oracle.com (abhmt117.oracle.com [141.146.116.69]) by acsmt358.oracle.com (8.12.11.20060308/8.12.11) with ESMTP id q8GNs5f5016914 for <11522@debbugs.gnu.org>; Sun, 16 Sep 2012 18:54:05 -0500 Received: from dradamslap1 (/10.159.170.142) by default (Oracle Beehive Gateway v4.0) with ESMTP ; Sun, 16 Sep 2012 16:54:05 -0700 From: "Drew Adams" References: <81E97418F9F04B889D43F7D133F0356A@us.oracle.com> Date: Sun, 16 Sep 2012 16:53:54 -0700 Message-ID: <80E4B45E178B494BA4BBA8D021D0B93B@us.oracle.com> MIME-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit X-Mailer: Microsoft Office Outlook 11 In-Reply-To: <81E97418F9F04B889D43F7D133F0356A@us.oracle.com> Thread-Index: Ac02AmX8QYUn2uCkTmG8aHRu5kGr0ReZB4VA X-MimeOLE: Produced By Microsoft MimeOLE V6.00.2900.6157 X-Source-IP: acsinet21.oracle.com [141.146.126.237] X-Spam-Score: -7.4 (-------) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.13 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: debbugs-submit-bounces@debbugs.gnu.org Errors-To: debbugs-submit-bounces@debbugs.gnu.org X-Spam-Score: -7.4 (-------) ping From unknown Mon Sep 08 03:16:19 2025 MIME-Version: 1.0 X-Mailer: MIME-tools 5.503 (Entity 5.503) X-Loop: help-debbugs@gnu.org From: help-debbugs@gnu.org (GNU bug Tracking System) To: "Drew Adams" Subject: bug#11522: closed (Re: bug#11522: 24.0.97; Bad doc about minor mode keys: (elisp) `Keymaps and Minor Modes') Message-ID: References: <87vbymvi6y.fsf@gnu.org> <81E97418F9F04B889D43F7D133F0356A@us.oracle.com> X-Gnu-PR-Message: they-closed 11522 X-Gnu-PR-Package: emacs Reply-To: 11522@debbugs.gnu.org Date: Wed, 18 Dec 2013 05:32:02 +0000 Content-Type: multipart/mixed; boundary="----------=_1387344722-22458-1" This is a multi-part message in MIME format... ------------=_1387344722-22458-1 Content-Disposition: inline Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset="utf-8" Your bug report #11522: 24.0.97; Bad doc about minor mode keys: (elisp) `Keymaps and Minor = Modes' which was filed against the emacs package, has been closed. The explanation is attached below, along with your original report. If you require more details, please reply to 11522@debbugs.gnu.org. --=20 11522: http://debbugs.gnu.org/cgi/bugreport.cgi?bug=3D11522 GNU Bug Tracking System Contact help-debbugs@gnu.org with problems ------------=_1387344722-22458-1 Content-Type: message/rfc822 Content-Disposition: inline Content-Transfer-Encoding: 7bit Received: (at 11522-done) by debbugs.gnu.org; 18 Dec 2013 05:31:25 +0000 Received: from localhost ([127.0.0.1]:56494 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1Vt9j9-0005pG-Tz for submit@debbugs.gnu.org; Wed, 18 Dec 2013 00:31:24 -0500 Received: from mail-pa0-f52.google.com ([209.85.220.52]:64138) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1Vt9j6-0005p2-Jv for 11522-done@debbugs.gnu.org; Wed, 18 Dec 2013 00:31:21 -0500 Received: by mail-pa0-f52.google.com with SMTP id ld10so5483146pab.39 for <11522-done@debbugs.gnu.org>; Tue, 17 Dec 2013 21:31:19 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=sender:from:to:cc:subject:references:date:in-reply-to:message-id :user-agent:mime-version:content-type; bh=1rmXnSonR7qsT2CwLGsV/iRdPEDbAv5Kk6VXKIlLk9M=; b=MopD6ZHNwxiWhr9EvjUu/i/V8Y31zXC81pvOxKjOycWPPQUMez7Iqxr331pg+yUpqA y/NfTctaFZEMVKvD27tVU7lftzogcecnfHVpE7i0AU75OT84Noq72GmYYT5V+Or3RoFu Drck9DX4KXMzo0iUz/KCDCI5qFDQwUzTGvbuhnrUDPsgH5Dp+RGW6SlJy3QyruJ+Yy8L Nyue6lxmbHvDtzR5FYTLnjf/wo3uMqbm8JC2iU8ScwyIye4pqCznKHtDYiV+ZV/yEjYA rfjqjip+RCxbfWSTtYOQh3sLe0UxLg6IWURE1845hNQK6CyTYu8O1HSym0My0m4n2A5Q Kwxw== X-Received: by 10.68.197.129 with SMTP id iu1mr31892445pbc.139.1387344679756; Tue, 17 Dec 2013 21:31:19 -0800 (PST) Received: from tsparkle ([155.69.19.37]) by mx.google.com with ESMTPSA id hu10sm38062345pbc.11.2013.12.17.21.31.17 for (version=TLSv1.2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Tue, 17 Dec 2013 21:31:18 -0800 (PST) From: Chong Yidong To: "Drew Adams" Subject: Re: bug#11522: 24.0.97; Bad doc about minor mode keys: (elisp) `Keymaps and Minor Modes' References: <81E97418F9F04B889D43F7D133F0356A@us.oracle.com> Date: Wed, 18 Dec 2013 13:31:17 +0800 In-Reply-To: <81E97418F9F04B889D43F7D133F0356A@us.oracle.com> (Drew Adams's message of "Sat, 19 May 2012 14:00:19 -0700") Message-ID: <87vbymvi6y.fsf@gnu.org> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/24.3.50 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain X-Spam-Score: -0.7 (/) X-Debbugs-Envelope-To: 11522-done Cc: 11522-done@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.15 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: -0.7 (/) "Drew Adams" writes: > "The key sequences bound in a minor mode should consist of `C-c' > followed by one of `.,/?`'"[]\|~!#$%^&*()-_+='. > (The other punctuation characters are reserved for major modes.)" > > Absolutely not. The `C-c' minor-mode keys, yes. Minor-mode keys in > general, no. Fixed, thanks. ------------=_1387344722-22458-1 Content-Type: message/rfc822 Content-Disposition: inline Content-Transfer-Encoding: 7bit Received: (at submit) by debbugs.gnu.org; 19 May 2012 21:01:16 +0000 Received: from localhost ([127.0.0.1]:34728 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1SVqm2-00056M-Vv for submit@debbugs.gnu.org; Sat, 19 May 2012 17:01:15 -0400 Received: from eggs.gnu.org ([208.118.235.92]:48815) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1SVqlz-00056A-U4 for submit@debbugs.gnu.org; Sat, 19 May 2012 17:01:12 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1SVqlR-0002Ij-1L for submit@debbugs.gnu.org; Sat, 19 May 2012 17:00:38 -0400 X-Spam-Checker-Version: SpamAssassin 3.3.2 (2011-06-06) on eggs.gnu.org X-Spam-Level: X-Spam-Status: No, score=-6.9 required=5.0 tests=BAYES_00,RCVD_IN_DNSWL_HI, UNPARSEABLE_RELAY autolearn=unavailable version=3.3.2 Received: from lists.gnu.org ([208.118.235.17]:39931) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1SVqlQ-0002Ie-UC for submit@debbugs.gnu.org; Sat, 19 May 2012 17:00:36 -0400 Received: from eggs.gnu.org ([208.118.235.92]:34764) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1SVqlO-0004kv-TQ for bug-gnu-emacs@gnu.org; Sat, 19 May 2012 17:00:36 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1SVqlM-0002Hu-UF for bug-gnu-emacs@gnu.org; Sat, 19 May 2012 17:00:34 -0400 Received: from rcsinet15.oracle.com ([148.87.113.117]:34027) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1SVqlM-0002HL-Ma for bug-gnu-emacs@gnu.org; Sat, 19 May 2012 17:00:32 -0400 Received: from acsinet22.oracle.com (acsinet22.oracle.com [141.146.126.238]) by rcsinet15.oracle.com (Sentrion-MTA-4.2.2/Sentrion-MTA-4.2.2) with ESMTP id q4JL0RH2028010 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK) for ; Sat, 19 May 2012 21:00:28 GMT Received: from acsmt358.oracle.com (acsmt358.oracle.com [141.146.40.158]) by acsinet22.oracle.com (8.14.4+Sun/8.14.4) with ESMTP id q4JL0RLv013115 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO) for ; Sat, 19 May 2012 21:00:27 GMT Received: from abhmt108.oracle.com (abhmt108.oracle.com [141.146.116.60]) by acsmt358.oracle.com (8.12.11.20060308/8.12.11) with ESMTP id q4JL0RM8027392 for ; Sat, 19 May 2012 16:00:27 -0500 Received: from dradamslap1 (/10.159.216.57) by default (Oracle Beehive Gateway v4.0) with ESMTP ; Sat, 19 May 2012 14:00:26 -0700 From: "Drew Adams" To: Subject: 24.0.97; Bad doc about minor mode keys: (elisp) `Keymaps and Minor Modes' Date: Sat, 19 May 2012 14:00:19 -0700 Message-ID: <81E97418F9F04B889D43F7D133F0356A@us.oracle.com> MIME-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit X-Mailer: Microsoft Office Outlook 11 Thread-Index: Ac02AmX8QYUn2uCkTmG8aHRu5kGr0Q== X-MimeOLE: Produced By Microsoft MimeOLE V6.00.2900.6157 X-Source-IP: acsinet22.oracle.com [141.146.126.238] X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 1) X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 3) X-Received-From: 208.118.235.17 X-Spam-Score: -6.1 (------) X-Debbugs-Envelope-To: submit X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.13 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: debbugs-submit-bounces@debbugs.gnu.org Errors-To: debbugs-submit-bounces@debbugs.gnu.org X-Spam-Score: -6.1 (------) What (elisp) `Keymaps and Minor Modes' says is horribly wrong: "The key sequences bound in a minor mode should consist of `C-c' followed by one of `.,/?`'"[]\|~!#$%^&*()-_+='. (The other punctuation characters are reserved for major modes.)" Absolutely not. The `C-c' minor-mode keys, yes. Minor-mode keys in general, no. What it is correct to say about minor-mode key bindings is said, carefully, in (elisp) `Key Binding Conventions'. Nothing more restrictive than that. And it is better to provide a link to that page than it is to try to repeat that information in `Keymaps and Minor Modes'. Regarding `C-c' key sequences: Few of them are reserved for major modes. The rest of them are allocated to minor modes or to users (`C-c' + letter). That's the way the C-c-plus-punctuation restriction should be presented: Minor modes get all C-c-plus-punctuation bindings not mentioned in the major-mode list, and those are the only `C-c' keys they get. But the real doc bug here is that it says that minor-mode keys are limited to `C-c' followed by a punctuation mark from the list shown. Not at all. Minor modes, like major modes, are by no means limited to keys on prefix `C-c'! In GNU Emacs 24.0.97.1 (i386-mingw-nt5.1.2600) of 2012-05-16 on MARVIN Windowing system distributor `Microsoft Corp.', version 5.1.2600 Configured using: `configure --with-gcc (4.6) --no-opt --enable-checking --cflags -ID:/devel/emacs/libs/libXpm-3.5.8/include -ID:/devel/emacs/libs/libXpm-3.5.8/src -ID:/devel/emacs/libs/libpng-dev_1.4.3-1/include -ID:/devel/emacs/libs/zlib-dev_1.2.5-2/include -ID:/devel/emacs/libs/giflib-4.1.4-1/include -ID:/devel/emacs/libs/jpeg-6b-4/include -ID:/devel/emacs/libs/tiff-3.8.2-1/include -ID:/devel/emacs/libs/gnutls-3.0.9/include' ------------=_1387344722-22458-1--