From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: MON KEY Newsgroups: gmane.emacs.devel Subject: easy-menu Info documentation lacking Date: Tue, 24 Feb 2009 18:06:48 -0500 Message-ID: NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 7bit X-Trace: ger.gmane.org 1235516849 929 80.91.229.12 (24 Feb 2009 23:07:29 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Tue, 24 Feb 2009 23:07:29 +0000 (UTC) To: emacs-devel@gnu.org Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Wed Feb 25 00:08:45 2009 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.50) id 1Lc6Nx-0005Tw-9l for ged-emacs-devel@m.gmane.org; Wed, 25 Feb 2009 00:08:21 +0100 Original-Received: from localhost ([127.0.0.1]:50934 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1Lc6Mc-0008Ed-IZ for ged-emacs-devel@m.gmane.org; Tue, 24 Feb 2009 18:06:58 -0500 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1Lc6MW-0008EC-Vx for emacs-devel@gnu.org; Tue, 24 Feb 2009 18:06:53 -0500 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1Lc6MU-0008Dt-So for emacs-devel@gnu.org; Tue, 24 Feb 2009 18:06:51 -0500 Original-Received: from [199.232.76.173] (port=35194 helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1Lc6MU-0008Dp-Fa for emacs-devel@gnu.org; Tue, 24 Feb 2009 18:06:50 -0500 Original-Received: from yw-out-1718.google.com ([74.125.46.155]:49099) by monty-python.gnu.org with esmtp (Exim 4.60) (envelope-from ) id 1Lc6MU-00054G-3c for emacs-devel@gnu.org; Tue, 24 Feb 2009 18:06:50 -0500 Original-Received: by yw-out-1718.google.com with SMTP id 6so1172005ywa.66 for ; Tue, 24 Feb 2009 15:06:49 -0800 (PST) Original-Received: by 10.220.74.81 with SMTP id t17mr1227581vcj.56.1235516809204; Tue, 24 Feb 2009 15:06:49 -0800 (PST) X-Google-Sender-Auth: dc5b9be7926e2906 X-detected-operating-system: by monty-python.gnu.org: GNU/Linux 2.6 (newer, 2) 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:109321 Archived-At: easy-menu.el really ought to have *some* sort of documentation in the Elisp/Emacs .infos At the very least the lack of Info documentation belies the library's name :P The earliest reference of easy-menu I was able to find in the change logs is at: 1994-04-11 Richard Stallman (rms@mole.gnu.ai.mit.edu) Including easy-menu documentation with Info may not be a task which can be well mediated by relative newcomers to Emacs. It seems that there may have been some historical complications/kludges that might have encouraged integration of easy-menu integration in the Infos. A cursory glance through the archives indicates that there are some low level decisions re: easy-menu behavior that would be best documented (or not) by those with first hand knowledge of the library and which parts deserve elucidation. With Emacs' move to GTK+ as the default toolkit, increased image/font support etc. there appears to be a collective indication in the libraries of a move to a slightly more `GUI' oriented Emacs. For example, doc-view's .pdf integration and set-slice-using-mouse is indicative of this general trend. Now is prob. a good time to consider inclusion of some more formal lip service to easy-menu usage/examples. As Emacs continues toward GUI integration it will be increasingly important that there be some sort of guidance vis a vis Emacs menu integration and `best practices'. This area should be fleshed out formally. While I can certainly appreciate a hesitancy to promote heavy menu integration in Emacs esp. in lieu of existing alternatives more in line with Emacs kbd based approach, there *does* appear to be a real need for their use beyond simple `GUI convenience features'. Consider that Emacs 23.xx easy-menu functions are invoked/referenced by the following libraries (some not insignificant): /lisp ldefs-boot.el loaddefs.el mouse.el doc-view.el vc-hg.el info.el diff-mode.el tmm.el hexl.el allout.el woman.el wid-browse.el vc-annotate.el speedbar.el smerge-mode.el ses.el recentf.el proced.el printing.el pcvs-defs.el log-view.el log-edit.el help-mode.el follow.el cvs-status.el cus-edit.el calculator.el /emacs-lisp edebug.el find-func.el checkdoc.el /net eudc.el eudc-hotlist.el eudc-bob.el /mh-e mh-show.el mh-search.el mh-letter.el mh-identity.el mh-folder.el mh-comp.el /nxml rng-nxml.el /org org-agenda.el org.el org-table.el org-colview.el /play 5x5.el /progmodes ebrowse.el python.el cc-mode.el cc-langs.el hideif.el cperl-mode.el vhdl-mode.el verilog-mode.el vera-mode.el tcl.el prolog.el octave-mod.el idlwave.el fortran.el f90.el antlr-mode.el ada-mode.el sql.el ps-mode.el meta-mode.el idlw-shell.el idlw-help.el hideshow.el ada-xref.el /textmodes bibtex.el table.el texinfo.el reftex.el reftex-toc.el reftex-index.el dns-mode.el /term ns-win.el /calc calc-menu.el /erc erc-menu.el /gnus gnus-agent.el gnus-art.el gnus-diary.el gnus-draft.el gnus-eform.el gnus-group.el gnus-ml.el gnus-salt.el gnus-srvr.el gnus-sum.el gnus-topic.el message.el mml.el score-mode.el sieve-mode.el sieve.el /calendar todo-mode.el cal-menu.el calendar.el