From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Eli Zaretskii Newsgroups: gmane.emacs.help Subject: Re: My emacs was upgraded and I am a novice again Date: Sat, 22 Sep 2007 11:21:55 +0200 Message-ID: References: <46F2BA57.3060604@gmail.com> <711a73df0709212204r65af300cr37aab355f244176e@mail.gmail.com> <711a73df0709220156k3878df01j6b1002fc812da996@mail.gmail.com> NNTP-Posting-Host: lo.gmane.org X-Trace: sea.gmane.org 1190453046 31092 80.91.229.12 (22 Sep 2007 09:24:06 GMT) X-Complaints-To: usenet@sea.gmane.org NNTP-Posting-Date: Sat, 22 Sep 2007 09:24:06 +0000 (UTC) To: help-gnu-emacs@gnu.org Original-X-From: help-gnu-emacs-bounces+geh-help-gnu-emacs=m.gmane.org@gnu.org Sat Sep 22 11:23:52 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 1IZ1DL-0005WR-S5 for geh-help-gnu-emacs@m.gmane.org; Sat, 22 Sep 2007 11:23:52 +0200 Original-Received: from localhost ([127.0.0.1] helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1IZ1DE-0002Dg-Aa for geh-help-gnu-emacs@m.gmane.org; Sat, 22 Sep 2007 05:23:44 -0400 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1IZ1Be-0002CU-P6 for help-gnu-emacs@gnu.org; Sat, 22 Sep 2007 05:22:06 -0400 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1IZ1BZ-0002Ao-Rx for help-gnu-emacs@gnu.org; Sat, 22 Sep 2007 05:22:04 -0400 Original-Received: from [199.232.76.173] (helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1IZ1BY-0002AU-CQ for help-gnu-emacs@gnu.org; Sat, 22 Sep 2007 05:22:00 -0400 Original-Received: from heller.inter.net.il ([213.8.233.23]) by monty-python.gnu.org with esmtp (Exim 4.60) (envelope-from ) id 1IZ1BX-0000JG-RJ for help-gnu-emacs@gnu.org; Sat, 22 Sep 2007 05:22:00 -0400 Original-Received: from HOME-C4E4A596F7 (IGLD-84-229-122-46.inter.net.il [84.229.122.46]) by heller.inter.net.il (MOS 3.7.3a-GA) with ESMTP id DRM65841 (AUTH halo1); Sat, 22 Sep 2007 11:21:51 +0200 (IST) In-reply-to: <711a73df0709220156k3878df01j6b1002fc812da996@mail.gmail.com> (dave.pawson@gmail.com) X-Detected-Kernel: FreeBSD 4.7-5.2 (or MacOS X 10.2-10.4) (2) 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:47735 Archived-At: > Date: Sat, 22 Sep 2007 09:56:06 +0100 > From: "Dave Pawson" > Cc: help-gnu-emacs@gnu.org > > > Instead of inventing new machinery, how about enhancing the existing > > one? "C-h P" is supposed to use the index you seem to think about. > > Good example, both counts. > No sign of revert (even if I understood it to mean reload). Sorry, I don't understand what you are talking about: what revert? If you are looking for the place to learn Emacs parlance, there's the "Glossary" node in the manual (which does explain "revert"). If you are looking for a way to find the command revert-buffer using keywords or phrases pertinent to what it should do, then "apropos-documentation" is your man, and "Info-index" in Info is your friend. (I'm not saying that these two will necessarily find what you are looking for, but if you name here the words or phrases that you use or would think to use for what revert-buffer does, I can try to make sure that those words/phrases will find the relevant commands in the future releases of Emacs.) In short, please spell out what are the use cases you are thinking about, because it looks like we are talking about several different ones here, with possibly different solutions to each one of them. > And I'd never heard of C-h P. As I said, I'd need to know the magic > word 'revert' to find revert. That's the index I think is missing. I thought you were asking for finding packages by keywords (and I thought Tom Tromey was talking about something like that as well): Dave> > Ideas for an 'index' please? What form? Its the match of 'idea/usage' Dave> > vs package name/variable/mode. Generally once you have the key words, Dave> > emacs is sufficiently helpful? Tom> Stefan> I've been an Emacs maintainer for what... 10 years? I still Tom> Stefan> occasionally bump into a bundled *package* that I've never Tom> Stefan> heard of. Tom> Tom> Most long-time Emacs users I talk to have a similar experience. I Tom> think this is one of the great joys of Emacs. Tom> Tom> On the minus side, discoverability remains a problem. Sometimes I Tom> wish I'd found those features years earlier. That is why I pointed out that an index of Emacs packages already exists, and it is what "C-h P" consults to do its job. Now I see that I need to add several more indices to the list: . The index in the Info manual (search it by the `i' command) . The virtual index produced by "apropos" and "apropos-documentation" . The "Glossary" node in the Emacs manual