From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Jan Moringen Newsgroups: gmane.emacs.devel Subject: Menu entry for describe-package? Date: Mon, 21 Jun 2010 01:22:36 +0200 Message-ID: <19162_1277076158_ZZh013Uew0JKU.00_1277076156.6852.1.camel@steed.robot-madness> NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: multipart/mixed; boundary="Boundary_(ID_NTOxkjLmFCSZwUYRvAVT2Q)" X-Trace: dough.gmane.org 1277076175 26517 80.91.229.12 (20 Jun 2010 23:22:55 GMT) X-Complaints-To: usenet@dough.gmane.org NNTP-Posting-Date: Sun, 20 Jun 2010 23:22:55 +0000 (UTC) To: emacs-devel@gnu.org Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Mon Jun 21 01:22:54 2010 Return-path: Envelope-to: ged-emacs-devel@m.gmane.org Original-Received: from lists.gnu.org ([199.232.76.165]) by lo.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1OQTql-00007Y-TA for ged-emacs-devel@m.gmane.org; Mon, 21 Jun 2010 01:22:53 +0200 Original-Received: from localhost ([127.0.0.1]:37306 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1OQTqj-00031D-0A for ged-emacs-devel@m.gmane.org; Sun, 20 Jun 2010 19:22:49 -0400 Original-Received: from [140.186.70.92] (port=47347 helo=eggs.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1OQTqc-00030Q-PG for emacs-devel@gnu.org; Sun, 20 Jun 2010 19:22:43 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.69) (envelope-from ) id 1OQTqb-00057s-2U for emacs-devel@gnu.org; Sun, 20 Jun 2010 19:22:42 -0400 Original-Received: from mux1-unibi-smtp.hrz.uni-bielefeld.de ([129.70.204.65]:40213) by eggs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1OQTqa-00057d-OF for emacs-devel@gnu.org; Sun, 20 Jun 2010 19:22:41 -0400 Original-Received: from pmxchannel-daemon.mux1-unibi-smtp.hrz.uni-bielefeld.de by mux1-unibi-smtp.hrz.uni-bielefeld.de (Sun Java(tm) System Messaging Server 6.3-6.03 (built Mar 14 2008; 32bit)) id <0L4C0090069Q9Q00@mux1-unibi-smtp.hrz.uni-bielefeld.de> for emacs-devel@gnu.org; Mon, 21 Jun 2010 01:22:38 +0200 (CEST) Original-Received: from [192.168.2.102] ([212.100.61.53]) by mux1-unibi-smtp.hrz.uni-bielefeld.de (Sun Java(tm) System Messaging Server 6.3-6.03 (built Mar 14 2008; 32bit)) with ESMTPPSA id <0L4C009JR69PIOD0@mux1-unibi-smtp.hrz.uni-bielefeld.de> for emacs-devel@gnu.org; Mon, 21 Jun 2010 01:22:38 +0200 (CEST) X-Mailer: Evolution 2.30.1.2 X-EnvFrom: jan.moringen@uni-bielefeld.de X-PMX-Version: 5.5.9.395186, Antispam-Engine: 2.7.2.376379, Antispam-Data: 2010.6.20.230915, pmx7 X-Connecting-IP: 212.100.61.53 X-detected-operating-system: by eggs.gnu.org: Solaris 10 (beta) X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Original-Sender: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.devel:126284 Archived-At: --Boundary_(ID_NTOxkjLmFCSZwUYRvAVT2Q) Content-type: text/plain; charset=UTF-8 Content-transfer-encoding: 7BIT Hi, I think it's great to have package.el in Emacs. I suggest adding a "Describe Package" menu item in the "Help > Describe" menu, in analogy to the other `describe-*' functions. The attached patch adds the menu entry. Looking at the neighboring entries, it seems like the function should be bound to C-h p. However, this binding is already in use (by `finder-by-keyword'). More generally, does anyone else find it potentially confusing (at least for new users) to have the following menu entries? Options > Manage Emacs Packages -> `package-list-packages' Help > Find Emacs Packages -> `finder-by-keyword' Help > External Packages -> `menu-bar-help-extra-packages' I think, the main source of potential confusion is the inconsistent use of the term "package". Maybe the meaning of "package" in the "Help" menu could also be conveyed by something more vague like "Find Emacs-related software"? Kind regards, Jan --Boundary_(ID_NTOxkjLmFCSZwUYRvAVT2Q) Content-type: text/x-patch; name=emacs-describe-package.patch; charset=UTF-8 Content-transfer-encoding: 7BIT Content-disposition: attachment; filename=emacs-describe-package.patch --- lisp/menu-bar.el.orig 2010-07-18 01:00:44.000000000 +0200 +++ lisp/menu-bar.el 2010-07-18 04:54:07.522794927 +0200 @@ -1404,6 +1332,9 @@ (define-key menu-bar-describe-menu [describe-current-display-table] `(menu-item ,(purecopy "Describe Display Table") describe-current-display-table :help ,(purecopy "Describe the current display table"))) +(define-key menu-bar-describe-menu [describe-package] + `(menu-item ,(purecopy "Describe Package...") describe-package + :help ,(purecopy "Display information about an Emacs software package"))) (define-key menu-bar-describe-menu [describe-face] `(menu-item ,(purecopy "Describe Face...") describe-face :help ,(purecopy "Display the properties of a face"))) --Boundary_(ID_NTOxkjLmFCSZwUYRvAVT2Q)--