From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Tim X Newsgroups: gmane.emacs.help Subject: Re: understanding emacs packages Date: Mon, 08 Oct 2007 13:01:37 +1000 Organization: Posted via Supernews, http://www.supernews.com Message-ID: <87bqbas41a.fsf@lion.rapttech.com.au> References: <1191413661.873145.69990@w3g2000hsg.googlegroups.com> <874ph8nwe1.fsf@W0053328.mgh.harvard.edu> <1191420317.776020.58280@d55g2000hsg.googlegroups.com> <87ejgb2pdz.fsf@lion.rapttech.com.au> <1191731933.039348.11670@22g2000hsm.googlegroups.com> NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Trace: sea.gmane.org 1191814848 17391 80.91.229.12 (8 Oct 2007 03:40:48 GMT) X-Complaints-To: usenet@sea.gmane.org NNTP-Posting-Date: Mon, 8 Oct 2007 03:40:48 +0000 (UTC) To: help-gnu-emacs@gnu.org Original-X-From: help-gnu-emacs-bounces+geh-help-gnu-emacs=m.gmane.org@gnu.org Mon Oct 08 05:40:45 2007 Return-path: Envelope-to: geh-help-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([199.232.76.165]) by lo.gmane.org with esmtp (Exim 4.50) id 1IejU3-00023t-95 for geh-help-gnu-emacs@m.gmane.org; Mon, 08 Oct 2007 05:40:43 +0200 Original-Received: from localhost ([127.0.0.1] helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1IejTy-0000Qc-40 for geh-help-gnu-emacs@m.gmane.org; Sun, 07 Oct 2007 23:40:38 -0400 Original-Path: shelby.stanford.edu!newsfeed.stanford.edu!newsfeed.berkeley.edu!ucberkeley!sn-xt-sjc-03!sn-xt-sjc-09!sn-post-sjc-01!supernews.com!corp.supernews.com!not-for-mail Original-Newsgroups: gnu.emacs.help User-Agent: Gnus/5.11 (Gnus v5.11) Emacs/22.1.50 (gnu/linux) Cancel-Lock: sha1:P/N/+aKxp5TcXa8fZcawr8sscQ8= Original-X-Complaints-To: abuse@supernews.com Original-Lines: 127 Original-Xref: shelby.stanford.edu gnu.emacs.help:152696 X-BeenThere: help-gnu-emacs@gnu.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Users list for the GNU Emacs text editor List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Original-Sender: help-gnu-emacs-bounces+geh-help-gnu-emacs=m.gmane.org@gnu.org Errors-To: help-gnu-emacs-bounces+geh-help-gnu-emacs=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.help:48201 Archived-At: knubee writes: >> ,----[ C-h k control h p ] >> | control h p runs the command finder-by-keyword >> | which is an interactive autoloaded Lisp function in `finder'. >> | It is bound to control h p , p , p , . >> | (finder-by-keyword) >> | >> | Find packages matching a given keyword. > > Interesting. Just out of curiosity, what is a use scenario for this > function? > 1. It provides an easy way to get an overview of the package categories available on your system. 2. It provides a convenient way to find all the elisp packages relating to a particular category. For example, When I run this on my system, I see - ,---- | emacspeak Audio Desktop | abbrev abbreviation handling, typing shortcuts, macros | bib code related to the `bib' bibliography processor | c support for the C language and related languages | calendar calendar and time management support | comm communications, networking, remote access to files | convenience convenience features for faster editing | data support for editing files of data | docs support for Emacs documentation `---- plus a lot of others (this is just a partial listing). If I then go to one of the items and hit enter, for example the 'c' item, I see ,---- | The following packages match the keyword `c': | | emacspeak-c.el Speech enable CC-mode and friends -- supports C, C++, Java | emacspeak-c.el Speech enable CC-mode and friends -- supports C, C++, Java | emacspeak-c.el Speech enable CC-mode and friends -- supports C, C++, Java | find-file.el find a file corresponding to this one given a pattern | tooltip.el show tooltip windows | cc-align.el custom indentation functions for CC Mode | cc-bytecomp.el compile time setup for proper compilation | cc-cmds.el user level commands for CC Mode | cc-compat.el cc-mode compatibility with c-mode.el confusion | cc-defs.el compile time definitions for CC Mode | cc-engine.el core syntax guessing engine for CC mode | cc-fonts.el font lock support for CC Mode | cc-langs.el language specific settings for CC Mode | cc-menus.el imenu support for CC Mode | cc-mode.el major mode for editing C and similar languages | cc-styles.el support for styles in CC Mode `---- again, this is just a partial listing. If I then select one of the files and hit enter, I get (for example cc-mode.el) ,---- | Commentary: | NOTE: Read the commentary below for the right way to submit bug reports! | NOTE: See the accompanying texinfo manual for details on using this mode! | Note: The version string is in cc-defs. | | This package provides GNU Emacs major modes for editing C, C++, | Objective-C, Java, CORBA's IDL, Pike and AWK code. As of the | latest Emacs and XEmacs releases, it is the default package for | editing these languages. This package is called "CC Mode", and | should be spelled exactly this way. | | CC Mode supports K&R and ANSI C, ANSI C++, Objective-C, Java, | CORBA's IDL, Pike and AWK with a consistent indentation model | across all modes. This indentation model is intuitive and very | flexible, so that almost any desired style of indentation can be | supported. Installation, usage, and programming details are | contained in an accompanying texinfo manual. | | CC Mode's immediate ancestors were, c++-mode.el, cplus-md.el, and | cplus-md1.el.. | | To submit bug reports, type "C-c C-b". These will be sent to | bug-gnu-emacs@gnu.org (mirrored as the Usenet newsgroup | gnu.emacs.bug) as well as bug-cc-mode@gnu.org, which directly | contacts the CC Mode maintainers. Questions can sent to | help-gnu-emacs@gnu.org (mirrored as gnu.emacs.help) and/or | bug-cc-mode@gnu.org. Please do not send bugs or questions to our | personal accounts; we reserve the right to ignore such email! | | Many, many thanks go out to all the folks on the beta test list. | Without their patience, testing, insight, code contributions, and | encouragement CC Mode would be a far inferior package. | | You can get the latest version of CC Mode, including PostScript | documentation and separate individual files from: | | http://cc-mode.sourceforge.net/ | | You can join a moderated CC Mode announcement-only mailing list by | visiting | | http://lists.sourceforge.net/mailman/listinfo/cc-mode-announce `---- which is the commentry section from the elisp file. So, C-h p can be a useful tool to explore your emacs environment. When you see a package category that looks interesting, you can hit enter and find all the elisp files that correspond to that category. When you see a file that looks interesting, you can hit enter to see the commentry section from the file, which generally gives you an overview of what functionality that file provides, where to get more information and what you may need to do to take advantage of the functions it offers. In short, C-h p is yet another of the comprehensive help tools available in emacs that can assist you to discover some of the (sometimes non-obvious) features and power available in the editor. Being done in elisp, it also has the nice property that it gets updated automatically as you add additional packages (i.e. its not just limited to what is bundled in emacs). Tim -- tcross (at) rapttech dot com dot au