From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Christopher Dimech Newsgroups: gmane.emacs.devel Subject: Re: Emacs Manual under a categorisation scheme Date: Tue, 12 Jul 2022 18:57:20 +0200 Message-ID: References: <83sfn6wb38.fsf@gnu.org> Mime-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: quoted-printable Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="36753"; mail-complaints-to="usenet@ciao.gmane.io" Cc: emacs-devel@gnu.org To: Eli Zaretskii Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Tue Jul 12 18:59:02 2022 Return-path: Envelope-to: ged-emacs-devel@m.gmane-mx.org Original-Received: from lists.gnu.org ([209.51.188.17]) by ciao.gmane.io with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1oBJDy-0009OX-6U for ged-emacs-devel@m.gmane-mx.org; Tue, 12 Jul 2022 18:59:02 +0200 Original-Received: from localhost ([::1]:56172 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1oBJDx-0006n9-0Z for ged-emacs-devel@m.gmane-mx.org; Tue, 12 Jul 2022 12:59:01 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:35778) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1oBJCP-0005lH-PR for emacs-devel@gnu.org; Tue, 12 Jul 2022 12:57:25 -0400 Original-Received: from mout.gmx.net ([212.227.17.22]:50483) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1oBJCN-0004y0-Nz; Tue, 12 Jul 2022 12:57:25 -0400 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=gmx.net; s=badeba3b8450; t=1657645040; bh=uXvxTixrssfKycAfA9M02TgjlnVOLmVA7YQBt5WSXrQ=; h=X-UI-Sender-Class:From:To:Cc:Subject:Date:In-Reply-To:References; b=iCrGMGvws3QHQ7XcRcddqGYsy962ghYV82SLGzyddOjyWUQ8BLfyvVsSigjFPPX5W /Q2cdKKi11p8V6sfFUPbQJ9zB8kB8ephE0ZXYnYKx5ORE0Ysl8JdC8Gh7wCtfmLQiC ZrPClfjcZg+uwMefVwJxmv9Ud1vtB7PXxA8T28Jc= X-UI-Sender-Class: 01bb95c1-4bf8-414a-932a-4f6e2808ef9c Original-Received: from [92.251.127.164] ([92.251.127.164]) by web-mail.gmx.net (3c-app-mailcom-bs07.server.lan [172.19.170.175]) (via HTTP); Tue, 12 Jul 2022 18:57:20 +0200 Importance: normal Sensitivity: Normal In-Reply-To: <83sfn6wb38.fsf@gnu.org> X-UI-Message-Type: mail X-Priority: 3 X-Provags-ID: V03:K1:iIZRuBKTQyj1IFwwSYiaINJOp0o/M9q/lVnYXBS4bTl2CiwjDelTotPX5HARVpk3gu6N1 EfCu3cycPGH1l8HDVJoqO9Mz7VcXmDOZRN1GH5IUqI2Sdtjyx4b1LCCr6IDdgOxbOtQupwColr8h UUPga+CfGNXXt9Px7DNRm7BzNXnhfToTjPzPSTDLJT/lR+mqEQvNXJQQbe5Zmvv9WZi+WZ15HLvb YTz9GeHb6RHFn69Z12YlE1Uo3ZzKatNkQ9budJ4w6RueEz3kp/7kZYk6EsMGISjMS5JobgJvPOqp Qs= X-UI-Out-Filterresults: notjunk:1;V03:K0:3rNLBEQuagI=:v3q1hn7+5viwjp4blEYKpR hwEgjhaFE2Uesda3pS26LSKEqh8puLdwUnJ/M0tA1Bk1GvmVeb6+3WJ/XvrhYd49FB6BRWRfy l1moSM5yh8zdrYuEbNgRfYQjMtxeKTUPeaLZBzmxyH/6ScppYr19A+3EeyE/SpOz/Igne4Keh z5M7w/WgarK0p2xnO9Hidh++rbTJPYBbljhMiDeTmCjBS8kH4uLpX5dwjtBz+7BMsldGxGUqd klVCAdvb+6aXjN7d2V6B83eJqtHguJjBO4nKqzkTp3HeZhZiA5fBCKbhCjkf3lxt/qBALDUBO YgO88tuu8fDms81xdEYpuyG8yGjAalYUuRI2qoHkBYT9huSXSsDBGcEmfzQfId7hynXGF1Y0U 3NbtqW5R6I+r7xmzCx3QTdE/8A19h03aDggoMdfGZbl7BNpL5wW/+1dBEd+KLjFp9M0+WEzTy 3BQ7x6SXe2yePI2ZakmYax/IHfhqWTjBYtIKACZna4MUBs0IRbzZ/8qT0acT9SUBxxFRImQkP 82W5eoew0SPIzPwN1ovu8YneMAw/hF4xZkS77/XOlzF+cxnvT9gk89Yo71kCDbHqWgDfWejFp MYFOWBlABpdUbya9tHSV7AjcopmFFEBKnDXwBq/eLJsZlZRqDYyALn6jJEuLHE1jc5JVrWEYQ B718+G8Eo3+ryslwmlrZ1/Gmp234xQXMUcYaNtyyDBaHW37hVTOgPPVV5EkoW1zibvyjngTW4 VGJpLVoiosdFH5QKbT1r72FGfWZpPYdGxEJrX8UIdqH2DN09hf/piSqq7F4DT3B1K5w72BBY Received-SPF: pass client-ip=212.227.17.22; envelope-from=dimech@gmx.com; helo=mout.gmx.net X-Spam_score_int: -25 X-Spam_score: -2.6 X-Spam_bar: -- X-Spam_report: (-2.6 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, FREEMAIL_FROM=0.001, RCVD_IN_DNSWL_LOW=-0.7, RCVD_IN_MSPIKE_H2=-0.001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001, T_SCC_BODY_TEXT_LINE=-0.01 autolearn=ham autolearn_force=no X-Spam_action: no action X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Original-Sender: "Emacs-devel" Xref: news.gmane.io gmane.emacs.devel:292091 Archived-At: > Sent: Wednesday, July 13, 2022 at 4:27 AM > From: "Eli Zaretskii" > To: "Christopher Dimech" > Cc: emacs-devel@gnu.org > Subject: Re: Emacs Manual under a categorisation scheme > > > From: Christopher Dimech > > Date: Tue, 12 Jul 2022 18:13:55 +0200 > > Sensitivity: Normal > > > > With the Emacs Manual having 54 sections, could it be be categorised u= nder a much smaller > > scheme (perhaps five or eight). This is to easily and quickly go thro= ugh it for the > > information one wants by using a category system. > > I don't think I understand what kind of category system do you have in > mind. Please elaborate and/or show an example. One could arrange either by difficulty or frequency. Basically, using a higher level categorisation to the 54 chapters, with ea= ch high level category being independent of the others. One can then quickly skip whole categories one is not interested in, even when using the manual= on the website. 1. Comprehending the Graphical Display 2. Running Commands (by Name, using Minibuffer read and completion) 3. Editing Commands (moving and killing text) 4. Using and Controlling the Graphical Display (buffer, window, frame) 5. Major and Minor Modes 6. Using Help 7. Programming and Markup Modes 8. Compiling, Testing, and Maintaining Programs 9. Running Shell Commands 10. Calendar, Diary, Document Viewing 10. Web Applications (EWW, Mail) 11. Emacs Customisation 12. Handling Problems (crashes, reporting bugs) > > For instance, the GNU Manuals Online is arranged by a limited number o= f categories. > > See https://www.gnu.org/manual/manual.html > > This has about 40 categories: not a far cry from our 54 chapters. > > To look for some subject, one is supposed to use the Info-index > command, bound to 'i' inside Info. There's no need to look up > subjects by reading the chapter titles. >