From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Eli Zaretskii Newsgroups: gmane.emacs.devel Subject: Re: Emacs Manual under a categorisation scheme Date: Tue, 12 Jul 2022 20:06:05 +0300 Message-ID: <83pmiaw9aa.fsf@gnu.org> References: <83sfn6wb38.fsf@gnu.org> Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="1949"; mail-complaints-to="usenet@ciao.gmane.io" Cc: emacs-devel@gnu.org To: Christopher Dimech Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Tue Jul 12 19:07:36 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 1oBJMG-0000Or-Bb for ged-emacs-devel@m.gmane-mx.org; Tue, 12 Jul 2022 19:07:36 +0200 Original-Received: from localhost ([::1]:34156 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1oBJMF-00039m-05 for ged-emacs-devel@m.gmane-mx.org; Tue, 12 Jul 2022 13:07:35 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:37930) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1oBJKy-0002Gn-38 for emacs-devel@gnu.org; Tue, 12 Jul 2022 13:06:16 -0400 Original-Received: from fencepost.gnu.org ([2001:470:142:3::e]:38516) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1oBJKx-0004ux-Qv; Tue, 12 Jul 2022 13:06:15 -0400 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnu.org; s=fencepost-gnu-org; h=References:Subject:In-Reply-To:To:From:Date: mime-version; bh=YSjZXqzu5RlIVZKlWuQ1lw/qtp3wyMF05hL7mwFR9LM=; b=j3RHmoRD1vx4 XURkD6KC3/Yqx9LKxWa07DjxD0Z5QkdnoN5uweQ50OZGhSmxLPlNWmuvRo8oG3yR2IWUCdS7ZIrzh rMim4GmHansxpbTxKrJoX2GX9JPMXX8vMhDMMxTl8SE+KAr5ogS7rtb2PpDcuarRqkz6de3u2synY AifUcKvWowfA41u8o585lKMfHA+Y3sABZ6NAVLkAQrSYRIg5frP9LovxMFfjKnPrdnSJEu9/DfF9Z KKetNGbH4cQ8bjk1TWX2zD1ewlphD3eMHWfTauccsGIInQlJ8ydqwjHIF6fYnWVjMK5AUMucnmLOj 75EHPni+rXkVW+WPTMBiEQ==; Original-Received: from [87.69.77.57] (port=4831 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1oBJKx-0002cw-4C; Tue, 12 Jul 2022 13:06:15 -0400 In-Reply-To: (message from Christopher Dimech on Tue, 12 Jul 2022 18:57:20 +0200) 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:292092 Archived-At: > From: Christopher Dimech > Cc: emacs-devel@gnu.org > Date: Tue, 12 Jul 2022 18:57:20 +0200 > > > 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 each > 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) I don't see how this is significantly different from the chapters we have now. You can categorize Emacs in any number of ways, but the one we have is IMNSHO completely adequate. What you propose is also adequate (although incomplete, so I cannot easily judge it except as an example), but I don't see why it is superior.