From unknown Sat Sep 13 17:04:07 2025 Content-Disposition: inline Content-Transfer-Encoding: quoted-printable MIME-Version: 1.0 X-Mailer: MIME-tools 5.509 (Entity 5.509) Content-Type: text/plain; charset=utf-8 From: bug#9819 <9819@debbugs.gnu.org> To: bug#9819 <9819@debbugs.gnu.org> Subject: Status: 24.0.50; Docstring of `define-minor-mode' and KEYMAP Reply-To: bug#9819 <9819@debbugs.gnu.org> Date: Sun, 14 Sep 2025 00:04:07 +0000 retitle 9819 24.0.50; Docstring of `define-minor-mode' and KEYMAP reassign 9819 emacs submitter 9819 Deniz Dogan severity 9819 minor thanks From debbugs-submit-bounces@debbugs.gnu.org Thu Oct 20 18:59:27 2011 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 From debbugs-submit-bounces@debbugs.gnu.org Fri Oct 21 03:15:06 2011 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 To: Deniz Dogan Subject: Re: bug#9819: 24.0.50; Docstring of `define-minor-mode' and KEYMAP 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-Debbugs-Envelope-To: 9819 Cc: 9819@debbugs.gnu.org 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 debbugs-submit-bounces@debbugs.gnu.org Fri Oct 21 10:00:24 2011 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" To: "'Glenn Morris'" , "'Deniz Dogan'" References: <86sjmns236.fsf@dogan.se> Subject: RE: bug#9819: 24.0.50; Docstring of `define-minor-mode' and KEYMAP 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-Debbugs-Envelope-To: 9819 Cc: 9819@debbugs.gnu.org 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 debbugs-submit-bounces@debbugs.gnu.org Mon Oct 24 13:39:04 2011 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. From unknown Sat Sep 13 17:04:07 2025 Received: (at fakecontrol) by fakecontrolmessage; To: internal_control@debbugs.gnu.org From: Debbugs Internal Request Subject: Internal Control Message-Id: bug archived. Date: Tue, 22 Nov 2011 12:24:03 +0000 User-Agent: Fakemail v42.6.9 # This is a fake control message. # # The action: # bug archived. thanks # This fakemail brought to you by your local debbugs # administrator