From unknown Sat Sep 13 17:05:30 2025 X-Loop: help-debbugs@gnu.org Subject: bug#9819: 24.0.50; Docstring of `define-minor-mode' and KEYMAP Resent-From: Deniz Dogan Original-Sender: debbugs-submit-bounces@debbugs.gnu.org Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Thu, 20 Oct 2011 23:00:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 9819 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: 9819@debbugs.gnu.org X-Debbugs-Original-To: bug-gnu-emacs@gnu.org Received: via spool by submit@debbugs.gnu.org id=B.13191515673812 (code B ref -1); Thu, 20 Oct 2011 23:00:01 +0000 Received: (at submit) by debbugs.gnu.org; 20 Oct 2011 22:59:27 +0000 Received: from localhost ([127.0.0.1] helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1RH1aA-0000zQ-Q7 for submit@debbugs.gnu.org; Thu, 20 Oct 2011 18:59:27 -0400 Received: from eggs.gnu.org ([140.186.70.92]) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1RH1a8-0000zC-PM for submit@debbugs.gnu.org; Thu, 20 Oct 2011 18:59:25 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1RH1Yt-00072J-VZ for submit@debbugs.gnu.org; Thu, 20 Oct 2011 18:58:08 -0400 X-Spam-Checker-Version: SpamAssassin 3.3.1 (2010-03-16) on eggs.gnu.org X-Spam-Level: X-Spam-Status: No, score=-2.6 required=5.0 tests=BAYES_00,RCVD_IN_DNSWL_LOW autolearn=unavailable version=3.3.1 Received: from lists.gnu.org ([140.186.70.17]:51753) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1RH1Yt-00072F-U6 for submit@debbugs.gnu.org; Thu, 20 Oct 2011 18:58:07 -0400 Received: from eggs.gnu.org ([140.186.70.92]:45155) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1RH1Ys-0000bZ-Ty for bug-gnu-emacs@gnu.org; Thu, 20 Oct 2011 18:58:07 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1RH1Yr-00071m-R8 for bug-gnu-emacs@gnu.org; Thu, 20 Oct 2011 18:58:06 -0400 Received: from ch-smtp05.sth.basefarm.net ([80.76.153.6]:48124) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1RH1Yr-00071e-Lx for bug-gnu-emacs@gnu.org; Thu, 20 Oct 2011 18:58:05 -0400 Received: from c80-216-107-103.bredband.comhem.se ([80.216.107.103]:58125 helo=EKATERINA) by ch-smtp05.sth.basefarm.net with esmtps (TLSv1:AES128-SHA:128) (Exim 4.76) (envelope-from ) id 1RH1Yn-0008HR-JD for bug-gnu-emacs@gnu.org; Fri, 21 Oct 2011 00:58:03 +0200 From: Deniz Dogan Date: Fri, 21 Oct 2011 00:57:49 +0200 Message-ID: <86sjmns236.fsf@dogan.se> MIME-Version: 1.0 Content-Type: text/plain X-Originating-IP: 80.216.107.103 X-Scan-Result: No virus found in message 1RH1Yn-0008HR-JD. X-Scan-Signature: ch-smtp05.sth.basefarm.net 1RH1Yn-0008HR-JD ad98d60cdedcb0d0e4f7b2d83efd49d5 X-detected-operating-system: by eggs.gnu.org: Genre and OS details not recognized. X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 3) X-Received-From: 140.186.70.17 X-Spam-Score: -5.5 (-----) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.11 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: -5.6 (-----) I read in the docstring of `define-minor-mode': Optional KEYMAP is the default keymap bound to the mode keymap. If non-nil, it should be a variable name (whose value is a keymap), or an expression that returns either a keymap or a list of arguments for `easy-mmode-define-keymap'. If KEYMAP is not a symbol, this also defines the variable MODE-map. [...] :keymap MAP Same as the KEYMAP argument. The way I interpret that is: if I don't pass a KEYMAP argument, it will define a variable named `MODE-map'. However, this doesn't happen when I use this code: (define-minor-mode helo-track-minor-mode "Global minor mode for tracking activity in helo buffers." :init-value nil :lighter "" :global t :group 'helo [...] Am I misunderstanding the docstring or is this a bug? Deniz From unknown Sat Sep 13 17:05:30 2025 X-Loop: help-debbugs@gnu.org Subject: bug#9819: 24.0.50; Docstring of `define-minor-mode' and KEYMAP Resent-From: Glenn Morris Original-Sender: debbugs-submit-bounces@debbugs.gnu.org Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Fri, 21 Oct 2011 07:16:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 9819 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: Deniz Dogan Cc: 9819@debbugs.gnu.org Received: via spool by 9819-submit@debbugs.gnu.org id=B9819.131918130614546 (code B ref 9819); Fri, 21 Oct 2011 07:16:02 +0000 Received: (at 9819) by debbugs.gnu.org; 21 Oct 2011 07:15:06 +0000 Received: from localhost ([127.0.0.1] helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1RH9Jn-0003mT-3n for submit@debbugs.gnu.org; Fri, 21 Oct 2011 03:15:05 -0400 Received: from fencepost.gnu.org ([140.186.70.10] ident=Debian-exim) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1RH9Jj-0003lq-EF for 9819@debbugs.gnu.org; Fri, 21 Oct 2011 03:15:00 -0400 Received: from rgm by fencepost.gnu.org with local (Exim 4.71) (envelope-from ) id 1RH9IW-0005dX-4N; Fri, 21 Oct 2011 03:13:44 -0400 From: Glenn Morris References: <86sjmns236.fsf@dogan.se> X-Spook: AMW Operation Iraqi Freedom NASA enemy of the state class X-Ran: 0CBgZ=9wI<*JD2a$F`8*aq:'1H$(5;Phe^rn0PL-ywHE:T}`fa)03a8=D06J59 (Deniz Dogan's message of "Fri, 21 Oct 2011 00:57:49 +0200") Message-ID: User-Agent: Gnus (www.gnus.org), GNU Emacs (www.gnu.org/software/emacs/) MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Spam-Score: -6.4 (------) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.11 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.4 (------) Deniz Dogan wrote: > If KEYMAP is not a symbol, this also defines the variable MODE-map. [...] > The way I interpret that is: if I don't pass a KEYMAP argument, it will > define a variable named `MODE-map'. nil is a symbol. :( If you pass a keymap argument that is not a symbol, eg: :keymap '(("\C-a" . foo-command) then a `foo-mode-map' variable will be defined and given that map as its value. From unknown Sat Sep 13 17:05:30 2025 X-Loop: help-debbugs@gnu.org Subject: bug#9819: 24.0.50; Docstring of `define-minor-mode' and KEYMAP Resent-From: "Drew Adams" Original-Sender: debbugs-submit-bounces@debbugs.gnu.org Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Fri, 21 Oct 2011 14:01:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 9819 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: "'Glenn Morris'" , "'Deniz Dogan'" Cc: 9819@debbugs.gnu.org Received: via spool by 9819-submit@debbugs.gnu.org id=B9819.131920562424047 (code B ref 9819); Fri, 21 Oct 2011 14:01:02 +0000 Received: (at 9819) by debbugs.gnu.org; 21 Oct 2011 14:00:24 +0000 Received: from localhost ([127.0.0.1] helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1RHFe2-0006Fl-ML for submit@debbugs.gnu.org; Fri, 21 Oct 2011 10:00:23 -0400 Received: from acsinet15.oracle.com ([141.146.126.227]) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1RHFdz-0006FW-C3 for 9819@debbugs.gnu.org; Fri, 21 Oct 2011 10:00:20 -0400 Received: from ucsinet21.oracle.com (ucsinet21.oracle.com [156.151.31.93]) by acsinet15.oracle.com (Switch-3.4.4/Switch-3.4.4) with ESMTP id p9LDwuGF020543 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK); Fri, 21 Oct 2011 13:58:58 GMT Received: from acsmt358.oracle.com (acsmt358.oracle.com [141.146.40.158]) by ucsinet21.oracle.com (8.14.4+Sun/8.14.4) with ESMTP id p9LDwtX1003558 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO); Fri, 21 Oct 2011 13:58:56 GMT Received: from abhmt109.oracle.com (abhmt109.oracle.com [141.146.116.61]) by acsmt358.oracle.com (8.12.11.20060308/8.12.11) with ESMTP id p9LDwonu031923; Fri, 21 Oct 2011 08:58:50 -0500 Received: from dradamslap1 (/10.159.63.178) by default (Oracle Beehive Gateway v4.0) with ESMTP ; Fri, 21 Oct 2011 06:58:49 -0700 From: "Drew Adams" References: <86sjmns236.fsf@dogan.se> Date: Fri, 21 Oct 2011 06:58:46 -0700 Message-ID: <6CD52D0A136242E89624EBD089EB6787@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: Thread-Index: AcyPwSgIFDMIAQY+Qq+1jHw7CC3YKwAN/Qzg X-MimeOLE: Produced By Microsoft MimeOLE V6.00.2900.6109 X-Source-IP: ucsinet21.oracle.com [156.151.31.93] X-CT-RefId: str=0001.0A090203.4EA17AA3.003F,ss=1,re=0.000,fgs=0 X-Spam-Score: -6.2 (------) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.11 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.2 (------) > > If KEYMAP is not a symbol, this also defines the > > variable MODE-map. > > nil is a symbol. :( > If you pass a keymap argument that is not a symbol, eg: > :keymap '(("\C-a" . foo-command) > then a `foo-mode-map' variable will be defined and given that > map as its value. It might be clearer to say just what you said, i.e., something like "If you pass a non-symbol KEYMAP argument..." or even more explicitly, "If KEYMAP is a cons that is a keymap..." From unknown Sat Sep 13 17:05:30 2025 MIME-Version: 1.0 X-Mailer: MIME-tools 5.427 (Entity 5.427) X-Loop: help-debbugs@gnu.org From: help-debbugs@gnu.org (GNU bug Tracking System) To: Deniz Dogan Subject: bug#9819: closed (Re: bug#9819: 24.0.50; Docstring of `define-minor-mode' and KEYMAP) Message-ID: References: <86sjmns236.fsf@dogan.se> X-Gnu-PR-Message: they-closed 9819 X-Gnu-PR-Package: emacs Reply-To: 9819@debbugs.gnu.org Date: Mon, 24 Oct 2011 17:40:02 +0000 Content-Type: multipart/mixed; boundary="----------=_1319478002-20570-1" This is a multi-part message in MIME format... ------------=_1319478002-20570-1 Content-Disposition: inline Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset="utf-8" Your bug report #9819: 24.0.50; Docstring of `define-minor-mode' and KEYMAP 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 9819@debbugs.gnu.org. --=20 9819: http://debbugs.gnu.org/cgi/bugreport.cgi?bug=3D9819 GNU Bug Tracking System Contact help-debbugs@gnu.org with problems ------------=_1319478002-20570-1 Content-Type: message/rfc822 Content-Disposition: inline Content-Transfer-Encoding: 7bit Received: (at 9819-done) by debbugs.gnu.org; 24 Oct 2011 17:39:04 +0000 Received: from localhost ([127.0.0.1] helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1RIOUJ-0005KX-Cz for submit@debbugs.gnu.org; Mon, 24 Oct 2011 13:39:03 -0400 Received: from fencepost.gnu.org ([140.186.70.10] ident=Debian-exim) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1RIOUH-0005K9-HI for 9819-done@debbugs.gnu.org; Mon, 24 Oct 2011 13:39:02 -0400 Received: from rgm by fencepost.gnu.org with local (Exim 4.71) (envelope-from ) id 1RIOSm-0007QO-P3; Mon, 24 Oct 2011 13:37:28 -0400 From: Glenn Morris To: 9819-done@debbugs.gnu.org Subject: Re: bug#9819: 24.0.50; Docstring of `define-minor-mode' and KEYMAP References: <86sjmns236.fsf@dogan.se> X-Spook: terrorism Syria Clinton investigation chameleon man X-Ran: I"V8$lt/2ofHXmVC`tKP<@l.||>JkH&D1|F+lszX!^{6B-I.h7Yrm!hb/*Js|4P#MJ[M%3 X-Hue: white X-Debbugs-No-Ack: yes X-Attribution: GM Date: Mon, 24 Oct 2011 13:37:28 -0400 In-Reply-To: (Glenn Morris's message of "Fri, 21 Oct 2011 03:13:44 -0400") Message-ID: User-Agent: Gnus (www.gnus.org), GNU Emacs (www.gnu.org/software/emacs/) MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Spam-Score: -6.4 (------) X-Debbugs-Envelope-To: 9819-done X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.11 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.4 (------) Version: 24.0.91 I have tried to clarify the doc-string. ------------=_1319478002-20570-1 Content-Type: message/rfc822 Content-Disposition: inline Content-Transfer-Encoding: 7bit Received: (at submit) by debbugs.gnu.org; 20 Oct 2011 22:59:27 +0000 Received: from localhost ([127.0.0.1] helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1RH1aA-0000zQ-Q7 for submit@debbugs.gnu.org; Thu, 20 Oct 2011 18:59:27 -0400 Received: from eggs.gnu.org ([140.186.70.92]) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1RH1a8-0000zC-PM for submit@debbugs.gnu.org; Thu, 20 Oct 2011 18:59:25 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1RH1Yt-00072J-VZ for submit@debbugs.gnu.org; Thu, 20 Oct 2011 18:58:08 -0400 X-Spam-Checker-Version: SpamAssassin 3.3.1 (2010-03-16) on eggs.gnu.org X-Spam-Level: X-Spam-Status: No, score=-2.6 required=5.0 tests=BAYES_00,RCVD_IN_DNSWL_LOW autolearn=unavailable version=3.3.1 Received: from lists.gnu.org ([140.186.70.17]:51753) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1RH1Yt-00072F-U6 for submit@debbugs.gnu.org; Thu, 20 Oct 2011 18:58:07 -0400 Received: from eggs.gnu.org ([140.186.70.92]:45155) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1RH1Ys-0000bZ-Ty for bug-gnu-emacs@gnu.org; Thu, 20 Oct 2011 18:58:07 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1RH1Yr-00071m-R8 for bug-gnu-emacs@gnu.org; Thu, 20 Oct 2011 18:58:06 -0400 Received: from ch-smtp05.sth.basefarm.net ([80.76.153.6]:48124) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1RH1Yr-00071e-Lx for bug-gnu-emacs@gnu.org; Thu, 20 Oct 2011 18:58:05 -0400 Received: from c80-216-107-103.bredband.comhem.se ([80.216.107.103]:58125 helo=EKATERINA) by ch-smtp05.sth.basefarm.net with esmtps (TLSv1:AES128-SHA:128) (Exim 4.76) (envelope-from ) id 1RH1Yn-0008HR-JD for bug-gnu-emacs@gnu.org; Fri, 21 Oct 2011 00:58:03 +0200 From: Deniz Dogan To: bug-gnu-emacs@gnu.org Subject: 24.0.50; Docstring of `define-minor-mode' and KEYMAP Date: Fri, 21 Oct 2011 00:57:49 +0200 Message-ID: <86sjmns236.fsf@dogan.se> MIME-Version: 1.0 Content-Type: text/plain X-Originating-IP: 80.216.107.103 X-Scan-Result: No virus found in message 1RH1Yn-0008HR-JD. X-Scan-Signature: ch-smtp05.sth.basefarm.net 1RH1Yn-0008HR-JD ad98d60cdedcb0d0e4f7b2d83efd49d5 X-detected-operating-system: by eggs.gnu.org: Genre and OS details not recognized. X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 3) X-Received-From: 140.186.70.17 X-Spam-Score: -5.5 (-----) X-Debbugs-Envelope-To: submit X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.11 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: -5.6 (-----) I read in the docstring of `define-minor-mode': Optional KEYMAP is the default keymap bound to the mode keymap. If non-nil, it should be a variable name (whose value is a keymap), or an expression that returns either a keymap or a list of arguments for `easy-mmode-define-keymap'. If KEYMAP is not a symbol, this also defines the variable MODE-map. [...] :keymap MAP Same as the KEYMAP argument. The way I interpret that is: if I don't pass a KEYMAP argument, it will define a variable named `MODE-map'. However, this doesn't happen when I use this code: (define-minor-mode helo-track-minor-mode "Global minor mode for tracking activity in helo buffers." :init-value nil :lighter "" :global t :group 'helo [...] Am I misunderstanding the docstring or is this a bug? Deniz ------------=_1319478002-20570-1--