From unknown Wed Jun 18 23:13:35 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#12628 <12628@debbugs.gnu.org> To: bug#12628 <12628@debbugs.gnu.org> Subject: Status: 24.2.50; doc of `easy-menu-define' Reply-To: bug#12628 <12628@debbugs.gnu.org> Date: Thu, 19 Jun 2025 06:13:35 +0000 retitle 12628 24.2.50; doc of `easy-menu-define' reassign 12628 emacs submitter 12628 "Drew Adams" severity 12628 minor thanks From debbugs-submit-bounces@debbugs.gnu.org Fri Oct 12 13:10:27 2012 Received: (at submit) by debbugs.gnu.org; 12 Oct 2012 17:10:27 +0000 Received: from localhost ([127.0.0.1]:41269 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1TMikk-0002yD-Do for submit@debbugs.gnu.org; Fri, 12 Oct 2012 13:10:27 -0400 Received: from eggs.gnu.org ([208.118.235.92]:37382) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1TMikh-0002y0-D1 for submit@debbugs.gnu.org; Fri, 12 Oct 2012 13:10:24 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1TMijm-00040j-7i for submit@debbugs.gnu.org; Fri, 12 Oct 2012 13:09:27 -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]:41567) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1TMijm-00040f-4y for submit@debbugs.gnu.org; Fri, 12 Oct 2012 13:09:26 -0400 Received: from eggs.gnu.org ([208.118.235.92]:41058) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1TMijl-000587-2W for bug-gnu-emacs@gnu.org; Fri, 12 Oct 2012 13:09:26 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1TMijk-00040O-0e for bug-gnu-emacs@gnu.org; Fri, 12 Oct 2012 13:09:25 -0400 Received: from rcsinet15.oracle.com ([148.87.113.117]:48568) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1TMijj-0003zv-Qs for bug-gnu-emacs@gnu.org; Fri, 12 Oct 2012 13:09:23 -0400 Received: from ucsinet22.oracle.com (ucsinet22.oracle.com [156.151.31.94]) by rcsinet15.oracle.com (Sentrion-MTA-4.2.2/Sentrion-MTA-4.2.2) with ESMTP id q9CH9JRl010412 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK) for ; Fri, 12 Oct 2012 17:09:20 GMT Received: from acsmt357.oracle.com (acsmt357.oracle.com [141.146.40.157]) by ucsinet22.oracle.com (8.14.4+Sun/8.14.4) with ESMTP id q9CH9JNJ011974 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO) for ; Fri, 12 Oct 2012 17:09:19 GMT Received: from abhmt117.oracle.com (abhmt117.oracle.com [141.146.116.69]) by acsmt357.oracle.com (8.12.11.20060308/8.12.11) with ESMTP id q9CH9IP6017917 for ; Fri, 12 Oct 2012 12:09:18 -0500 Received: from dradamslap1 (/10.159.176.49) by default (Oracle Beehive Gateway v4.0) with ESMTP ; Fri, 12 Oct 2012 10:09:18 -0700 From: "Drew Adams" To: Subject: 24.2.50; doc of `easy-menu-define' Date: Fri, 12 Oct 2012 10:09:14 -0700 Message-ID: <80621F4908684D1DAE49E699F0888277@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: Ac2onE30JYDMLJBoS4CvDnLREr0/yg== X-MimeOLE: Produced By Microsoft MimeOLE V6.00.2900.6157 X-Source-IP: ucsinet22.oracle.com [156.151.31.94] 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: -3.4 (---) 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: -3.4 (---) This doc is all the more important because the doc for nearly all of the other `easy-menu-*' functions just punts and points back to this doc. It needs to be clear, complete, and correct. In practice, users have to read the source code and work their way through low-level helper function `easy-menu-convert-item-1' to figure out what a menu item really can be. Not good. 1. AFAICT, there is nothing in the doc string that corresponds to use cases like these, for MENU: ["--" t] ["--" nil nil] The doc says that CALLBACK is a command or a _list_ to evaluate. `t' is certainly not a list. The doc also does not say anything about what CALLBACK is evaluated for, so presumably it is only for its side effects and its value is not used (?). This should be made explicit - e.g., "CALLBACK is an expression that is evaluated for its side effects." 2. What on earth is ARG here? It needs to be described. "Alternatively, a menu item may have the form: [ NAME CALLBACK [ KEYWORD ARG ] ... ]" 3. Why isn't there anything about `easy-menu*' in the Elisp manual? The manual covers defining and modifying menus, but it doesn't cover the standard "easy" way to do that defined by RMS. In GNU Emacs 24.2.50.1 (i386-mingw-nt5.1.2600) of 2012-10-09 on DANI-PC Bzr revision: 110489 monnier@iro.umontreal.ca-20121009163751-ui2zwwoaj8bqwj52 Windowing system distributor `Microsoft Corp.', version 5.1.2600 Configured using: `configure --with-gcc (4.7) --no-opt --enable-checking --cflags -I../../libs/libxpm-3.5.8/include -I../../libs/libxpm-3.5.8/src -I../../libs/libpng-1.4.10 -I../../libs/zlib-1.2.6 -I../../libs/giflib-4.1.4-1/include -I../../libs/jpeg-6b-4/include -I../../libs/tiff-3.8.2-1/include -I../../libs/libxml2-2.7.8-w32-bin/include/libxml2 -I../../libs/gnutls-3.0.16/include -I../../libs/libiconv-1.14-2-mingw32-dev/include' From debbugs-submit-bounces@debbugs.gnu.org Tue Oct 23 23:51:55 2012 Received: (at 12628) by debbugs.gnu.org; 24 Oct 2012 03:51:55 +0000 Received: from localhost ([127.0.0.1]:58490 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1TQs0Y-0005Xz-W5 for submit@debbugs.gnu.org; Tue, 23 Oct 2012 23:51:55 -0400 Received: from mail-vc0-f172.google.com ([209.85.220.172]:55122) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1TQs0W-0005Xm-W5 for 12628@debbugs.gnu.org; Tue, 23 Oct 2012 23:51:53 -0400 Received: by mail-vc0-f172.google.com with SMTP id fl11so116834vcb.3 for <12628@debbugs.gnu.org>; Tue, 23 Oct 2012 20:49:52 -0700 (PDT) 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=vNBK0X77rO7jqTJ9iRBZ4E7EJTqv90S/TjHGZ69ZJEs=; b=BP48LXh8r/0V/TVfefMaPZr8262AjYLjJwiLjKTrerG7SjK5NYuLIB9VAjL5UHx4i0 XnrG7FA0iIGMAjBS6i3E8t7AMcvWaoYy+iPD5JoEIOJnKgJ9xiXn4anllxM/3Felfp4w NBWKxu16fCQEtceHd38l4R2t0WTU00ikusG+BMfTUe9To/yOoLCLT1Mwflyv8Im0UDaj p4agnCcQYpEgSoxHbDtiHikknUB23aKljGnJ2Wvhz9QNyaMgd/y7xALyy6dVxBpqM6W8 MuNA6xEotOvivIR+HfH3LvtuYVcFYAu5P69Jk47QGh2rboKYCrji0G2GuL18RntUqmUL IXbg== Received: by 10.52.36.40 with SMTP id n8mr19469041vdj.52.1351050592050; Tue, 23 Oct 2012 20:49:52 -0700 (PDT) Received: from ulysses (173-166-11-18-newengland.hfc.comcastbusiness.net. [173.166.11.18]) by mx.google.com with ESMTPS id v9sm14364341ves.8.2012.10.23.20.49.39 (version=SSLv3 cipher=OTHER); Tue, 23 Oct 2012 20:49:51 -0700 (PDT) From: Chong Yidong To: "Drew Adams" Subject: Re: bug#12628: 24.2.50; doc of `easy-menu-define' References: <80621F4908684D1DAE49E699F0888277@us.oracle.com> Date: Wed, 24 Oct 2012 11:49:05 +0800 In-Reply-To: <80621F4908684D1DAE49E699F0888277@us.oracle.com> (Drew Adams's message of "Fri, 12 Oct 2012 10:09:14 -0700") Message-ID: <87d308r0lq.fsf@gnu.org> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/24.2.50 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain X-Spam-Score: 0.1 (/) X-Debbugs-Envelope-To: 12628 Cc: 12628@debbugs.gnu.org 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: 0.1 (/) "Drew Adams" writes: > 1. AFAICT, there is nothing in the doc string that corresponds to use > cases like these, for MENU: > > 2. What on earth is ARG here? It needs to be described. > > 3. Why isn't there anything about `easy-menu*' in the Elisp manual? The > manual covers defining and modifying menus, but it doesn't cover the > standard "easy" way to do that defined by RMS. Fixed in trunk. From debbugs-submit-bounces@debbugs.gnu.org Tue Oct 23 23:51:46 2012 Received: (at control) by debbugs.gnu.org; 24 Oct 2012 03:51:47 +0000 Received: from localhost ([127.0.0.1]:58487 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1TQs0Q-0005Xf-A3 for submit@debbugs.gnu.org; Tue, 23 Oct 2012 23:51:46 -0400 Received: from mail-vb0-f44.google.com ([209.85.212.44]:44729) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1TQs0N-0005XT-Ia for control@debbugs.gnu.org; Tue, 23 Oct 2012 23:51:44 -0400 Received: by mail-vb0-f44.google.com with SMTP id fc26so130963vbb.3 for ; Tue, 23 Oct 2012 20:49:41 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=sender:from:to:subject:date:message-id:mime-version:content-type; bh=mXuSmSZTgyEByqlgKsQ9h4ZaIB2lDaOJFP2Bo89P0G4=; b=PnKvvwVzkn3ZVj+c7q+gt1ZB6cCWpmbtSceCDsbRO75tOAPYoz1cgSFX0YQC4q3Git LRz5UlF14vD134nWjrJUXvkHXNgOZmJwpqr5YDzC+LK0CP4AzfR/8+Fkzfx3gwuK/1r+ B/nyC8nsC79QG3EfSk0K8y2xpa1COmLtnRaXmagRKOudAi9COfI1oYjYxiM6TWUi6f/6 qgiNBmvLiMzdL5Ef3ctmVXopvipWCeqliBVbxTGUyyQFQaZhVbgWvQId5THUQxuYEWTY rEK/Q5mTN6FBy6fdZFZPZUQ1dmUsGRU24QXakF8r18FXy+spICLx8ZyANwgWuUzRduMf ZHHQ== Received: by 10.220.150.134 with SMTP id y6mr5948071vcv.20.1351050581345; Tue, 23 Oct 2012 20:49:41 -0700 (PDT) Received: from ulysses (173-166-11-18-newengland.hfc.comcastbusiness.net. [173.166.11.18]) by mx.google.com with ESMTPS id co1sm15173804vdc.10.2012.10.23.20.49.32 (version=SSLv3 cipher=OTHER); Tue, 23 Oct 2012 20:49:40 -0700 (PDT) From: Chong Yidong To: control@debbugs.gnu.org Subject: close 12628 Date: Wed, 24 Oct 2012 11:49:17 +0800 Message-ID: <873914edhe.fsf@gnu.org> MIME-Version: 1.0 Content-Type: text/plain X-Spam-Score: 0.1 (/) X-Debbugs-Envelope-To: control 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: 0.1 (/) close 12628 thanks From unknown Wed Jun 18 23:13:35 2025 Received: (at fakecontrol) by fakecontrolmessage; To: internal_control@debbugs.gnu.org From: Debbugs Internal Request Subject: Internal Control Message-Id: bug archived. Date: Wed, 21 Nov 2012 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