From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Eli Zaretskii Newsgroups: gmane.emacs.devel Subject: Re: generate 2) other pages for Info Date: Sun, 23 Sep 2007 21:18:42 +0200 Message-ID: References: <87lkaxbput.fsf@bzg.ath.cx> <87ejgp7epy.fsf_-_@jurta.org> <87sl55a2kb.fsf@bzg.ath.cx> Reply-To: Eli Zaretskii NNTP-Posting-Host: lo.gmane.org X-Trace: sea.gmane.org 1190575146 1538 80.91.229.12 (23 Sep 2007 19:19:06 GMT) X-Complaints-To: usenet@sea.gmane.org NNTP-Posting-Date: Sun, 23 Sep 2007 19:19:06 +0000 (UTC) Cc: emacs-devel@gnu.org To: Bastien Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Sun Sep 23 21:19:01 2007 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 1IZWym-0002nH-Su for ged-emacs-devel@m.gmane.org; Sun, 23 Sep 2007 21:18:57 +0200 Original-Received: from localhost ([127.0.0.1] helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1IZWyk-0006qs-84 for ged-emacs-devel@m.gmane.org; Sun, 23 Sep 2007 15:18:54 -0400 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1IZWyg-0006om-KP for emacs-devel@gnu.org; Sun, 23 Sep 2007 15:18:50 -0400 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1IZWye-0006mO-Mr for emacs-devel@gnu.org; Sun, 23 Sep 2007 15:18:50 -0400 Original-Received: from [199.232.76.173] (helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1IZWye-0006mF-Ie for emacs-devel@gnu.org; Sun, 23 Sep 2007 15:18:48 -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 1IZWye-0004SN-4S for emacs-devel@gnu.org; Sun, 23 Sep 2007 15:18:48 -0400 Original-Received: from HOME-C4E4A596F7 (IGLD-84-228-205-190.inter.net.il [84.228.205.190]) by heller.inter.net.il (MOS 3.7.3a-GA) with ESMTP id DRT78279 (AUTH halo1); Sun, 23 Sep 2007 21:18:42 +0200 (IST) In-reply-to: <87sl55a2kb.fsf@bzg.ath.cx> (message from Bastien on Sun, 23 Sep 2007 16:17:40 +0200) X-Detected-Kernel: FreeBSD 4.7-5.2 (or MacOS X 10.2-10.4) (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:79606 Archived-At: > From: Bastien > Date: Sun, 23 Sep 2007 16:17:40 +0200 > Cc: drew.adams@oracle.com, emacs-devel@gnu.org > > Imagine someone is looking for the command that add a ChangeLog entry. > Here are a few different searching paths he might go through: > > 1. His first reflex is to go to the Emacs manual. Great! It's there. > > 2. He thinks he can use `finder-by-keyword' (C-h P) for that. If he is > brave enough to go to the end of the list, he will find "tools", then > add-log.el, then he will stumble on "This facility is documented in > the Emacs Manual." Okay, then he should have gone there first. > > 3. He is used to `apropos-command' (C-h a). He tries that and look for > "ChangeLog". Bad luck. He will find this: > > log-edit-add-to-changelog M-x ... RET > log-edit-insert-changelog M-x ... RET My personal recommendation is use the Help commands in a different order: 1. Info-index (`i' in Info mode) 2. M-x apropos 3. M-x apropos-documentation > So here is what a personal help manager could store: > > | searched | found | manual | > |-----------------------+----------------------+---------------------------| > | Add a ChangeLog entry | add-change-log-entry | (info "(emacs)Change Log) | > > (This is actually what I'm trying to use inside my org-mode file.) After 10 years of using Emacs, this index will become so huge that it will be unusable, I'm pretty sure. > > I think only adding various index entries including most synonyms > > (e.g. "revert", "refresh", "update", ...) will help to find the entry. > > The main job of the personal help manager would be to be able to find > these synonyms. I guess different people would use different synonyms > sets (not mentionning language-dependant issues). We could collect those synonyms for them (we actually do that today, in the index entries we place in the manual, please take a look).