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: Thanks Re: Global keymap not found Date: Sat, 10 Oct 2015 12:09:47 +0300 Message-ID: <834mhzt7hg.fsf@gnu.org> References: NNTP-Posting-Host: plane.gmane.org X-Trace: ger.gmane.org 1444468225 31964 80.91.229.3 (10 Oct 2015 09:10:25 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Sat, 10 Oct 2015 09:10:25 +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 Oct 10 11:10:11 2015 Return-path: Envelope-to: geh-help-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by plane.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1ZkqAM-0003yb-Tm for geh-help-gnu-emacs@m.gmane.org; Sat, 10 Oct 2015 11:10:11 +0200 Original-Received: from localhost ([::1]:44142 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1ZkqAM-0000O4-3R for geh-help-gnu-emacs@m.gmane.org; Sat, 10 Oct 2015 05:10:10 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:46167) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1ZkqAB-0000Nk-KY for help-gnu-emacs@gnu.org; Sat, 10 Oct 2015 05:10:00 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1ZkqA8-0002kK-E2 for help-gnu-emacs@gnu.org; Sat, 10 Oct 2015 05:09:59 -0400 Original-Received: from mtaout24.012.net.il ([80.179.55.180]:36650) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1ZkqA8-0002k8-13 for help-gnu-emacs@gnu.org; Sat, 10 Oct 2015 05:09:56 -0400 Original-Received: from conversion-daemon.mtaout24.012.net.il by mtaout24.012.net.il (HyperSendmail v2007.08) id <0NVZ00D00Y78A900@mtaout24.012.net.il> for help-gnu-emacs@gnu.org; Sat, 10 Oct 2015 12:02:59 +0300 (IDT) Original-Received: from HOME-C4E4A596F7 ([84.94.185.246]) by mtaout24.012.net.il (HyperSendmail v2007.08) with ESMTPA id <0NVZ0032PYGZZV90@mtaout24.012.net.il> for help-gnu-emacs@gnu.org; Sat, 10 Oct 2015 12:02:59 +0300 (IDT) In-reply-to: X-012-Sender: halo1@inter.net.il X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6.x X-Received-From: 80.179.55.180 X-BeenThere: help-gnu-emacs@gnu.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: Users list for the GNU Emacs text editor List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: help-gnu-emacs-bounces+geh-help-gnu-emacs=m.gmane.org@gnu.org Original-Sender: help-gnu-emacs-bounces+geh-help-gnu-emacs=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.help:107568 Archived-At: > From: Albrecht Mehl > Date: Fri, 9 Oct 2015 11:07:21 +0200 > > Nevertheless I insist > > - Fundamental things should be available at once and not after > hopping from one point to another to another ... They are. The Emacs User Manual starts by explaining them in a methodical way. It's a lot of stuff to digest, because Emacs is very large, but if you read enough of the material at the beginning of the manual, Chapters 1 through 7, you get to know those basics. > - The manual should have three appendices - there might be other > candidates - > > 1. Alphabetical list of all global (prefix) keys > 2. Alph. list of all global commands > 3. List of all global commands grouped according to scope Such lists would not be useful in Emacs, for 2 main reasons: . They would be extremely long lists, so finding anything there would be very hard, if at all practical. . The lists change depending on what optional packages are loaded. Some optional packages are loaded because other packages request them automatically on as-needed basis, so these changes can happen out of user control. For these reasons, Emacs provides many help commands that allow you to look up commands, prefixes, etc. dynamically as needed, and provide filtering facilities so that the lists you get are relatively short and focused on the features you are interested in. I suggest to use those help commands first, and only go to the manual for further details, if the built-in documentation is not detailed enough or leaves some things uncovered. > - The chapters in the manual are numerated within the text. So > they should be in the table of context as well. People > write 'Look at 49.1' e.g. and one wonders where this is. There's no Table Of Contents in the on-line manual, only in the printed manual. The Master Menu (which is what I believe you referred to) does not show chapter and section names, it shows the node names. It could make sense to have the TOC produced in the Info format as well, but that's a feature you/someone should ask the Texinfo developers to provide, as the programs which produce the manuals are maintained by another project, not by Emacs.