From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: "Drew Adams" Newsgroups: gmane.emacs.bugs Subject: bug#11522: 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> NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit X-Trace: dough.gmane.org 1337461304 30187 80.91.229.3 (19 May 2012 21:01:44 GMT) X-Complaints-To: usenet@dough.gmane.org NNTP-Posting-Date: Sat, 19 May 2012 21:01:44 +0000 (UTC) To: 11522@debbugs.gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Sat May 19 23:01:43 2012 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by plane.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1SVqmS-0007KR-Tt for geb-bug-gnu-emacs@m.gmane.org; Sat, 19 May 2012 23:01:41 +0200 Original-Received: from localhost ([::1]:58599 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1SVqmS-0004oV-C2 for geb-bug-gnu-emacs@m.gmane.org; Sat, 19 May 2012 17:01:40 -0400 Original-Received: from eggs.gnu.org ([208.118.235.92]:34929) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1SVqmO-0004nv-QN for bug-gnu-emacs@gnu.org; Sat, 19 May 2012 17:01:38 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1SVqmN-0002QX-1N for bug-gnu-emacs@gnu.org; Sat, 19 May 2012 17:01:36 -0400 Original-Received: from debbugs.gnu.org ([140.186.70.43]:53415) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1SVqmM-0002QP-UP for bug-gnu-emacs@gnu.org; Sat, 19 May 2012 17:01:34 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.72) (envelope-from ) id 1SVqmo-00057Q-R7 for bug-gnu-emacs@gnu.org; Sat, 19 May 2012 17:02:02 -0400 X-Loop: help-debbugs@gnu.org 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: X-Debbugs-Original-To: Original-Received: via spool by submit@debbugs.gnu.org id=B.133746127619618 (code B ref -1); Sat, 19 May 2012 21:02:01 +0000 Original-Received: (at submit) by debbugs.gnu.org; 19 May 2012 21:01:16 +0000 Original-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 Original-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 Original-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 Original-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 Original-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 Original-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 Original-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 Original-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 Original-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 Original-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 Original-Received: from dradamslap1 (/10.159.216.57) by default (Oracle Beehive Gateway v4.0) with ESMTP ; Sat, 19 May 2012 14:00:26 -0700 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-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.13 Precedence: list X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 2) X-Received-From: 140.186.70.43 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.org@gnu.org Original-Sender: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.bugs:60225 Archived-At: 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'