From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED!not-for-mail From: Jean-Christophe Helary Newsgroups: gmane.emacs.devel Subject: Re: Specialized Emacs Features ? Date: Sat, 3 Jun 2017 01:15:38 +0900 Message-ID: References: <9376E14B-E917-4494-810A-8F6496E19916@gmail.com> <83bmq6d1f2.fsf@gnu.org> <838tlacz2g.fsf@gnu.org> <59E6B0B8-8D96-4C32-AFEE-4666DC9693E9@gmail.com> <837f0ucwog.fsf@gnu.org> <7C19A7A0-22C6-4CE6-9C66-683000F6B6EE@gmail.com> <8337bicrjm.fsf@gnu.org> NNTP-Posting-Host: blaine.gmane.org Mime-Version: 1.0 (Mac OS X Mail 10.3 \(3273\)) Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable X-Trace: blaine.gmane.org 1496420276 5041 195.159.176.226 (2 Jun 2017 16:17:56 GMT) X-Complaints-To: usenet@blaine.gmane.org NNTP-Posting-Date: Fri, 2 Jun 2017 16:17:56 +0000 (UTC) To: emacs-devel Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Fri Jun 02 18:17:49 2017 Return-path: Envelope-to: ged-emacs-devel@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by blaine.gmane.org with esmtp (Exim 4.84_2) (envelope-from ) id 1dGpGm-0000rE-DH for ged-emacs-devel@m.gmane.org; Fri, 02 Jun 2017 18:17:48 +0200 Original-Received: from localhost ([::1]:50620 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1dGpGp-0006FG-WE for ged-emacs-devel@m.gmane.org; Fri, 02 Jun 2017 12:17:52 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:56596) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1dGpEo-0004Q7-44 for emacs-devel@gnu.org; Fri, 02 Jun 2017 12:15:47 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1dGpEk-0001M2-Qb for emacs-devel@gnu.org; Fri, 02 Jun 2017 12:15:46 -0400 Original-Received: from mail-pf0-x22c.google.com ([2607:f8b0:400e:c00::22c]:34692) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1dGpEk-0001Kt-Kf for emacs-devel@gnu.org; Fri, 02 Jun 2017 12:15:42 -0400 Original-Received: by mail-pf0-x22c.google.com with SMTP id 9so51939181pfj.1 for ; Fri, 02 Jun 2017 09:15:42 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=from:content-transfer-encoding:mime-version:subject:date:references :to:in-reply-to:message-id; bh=P3cLei//UkyCc02kaGPtdgeXF26CRLb6lD/aKhDnCSo=; b=cGfwu+GlNMl+x0LgwgxmX65vaONzev/NRtg5Sqo2oBg78/hEHrVJjxFAI/3irYTqyY GKcaztgTTfURIlXzCV3PtHTKe7G5ObAV7J80c5JsZnLJSGbZQ3fEi6hF1lMqTfI7vgpt 6grlVjgn0foNcHBWQv+3Kns5IxfHXaiQMXKogzPff2sbGUfx/Xb/GqyFzdsG1uiay0k+ XGoMs7AfgBGyjEDRfdfjXqfYO5Z5ed4fEmAUHM/ApaU3Oy5YgW7WfxOW/YE1cN4aHdAw CSGXGmP55+ionyJ/sDLOIttIM+kLC1sUGEgpkRtTFYz6yyv/TS9/+zCCaz2a/Px3IFJz iI9g== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:content-transfer-encoding:mime-version :subject:date:references:to:in-reply-to:message-id; bh=P3cLei//UkyCc02kaGPtdgeXF26CRLb6lD/aKhDnCSo=; b=Zw/jh/VFW7vK1LyDuM6Ki60u/BTtPc4zQrKWikqDTX/tCAZoYdZGhPDwxGzZCyLPaz Amt42yr0mi/dS0/r3yUl7TuT8fIWr2gmVs1u4/qN7e0vyweScl/vxNVzvhjbzjL/iV8L jtvl0NgLuAU3q/j8PnmNN3jO0Mfk9qGkLhdfWJcX1KfrsIxHPjfDfyp0Ew58bLCvOq2Z SFcZ+zLMhAaUL5mQZ673DJtdaT2KPbRO/tQjor45JmYeiY9C1KaPpYBtAmR4p6uBcc3W 6/jBWlVnk46qz3Sz7yErfoR57AuoIRv2NRWHjP5ThH/PWYmlKhevLLWjhktje2HBqDYt 8bBA== X-Gm-Message-State: AODbwcDb2iZufPPksSQ3aEfmYoWMm8V+sbKnUNeiYNs5Nrf3fA8dRvhp RdxwsZNN+D0YoQZ+gaE= X-Received: by 10.99.104.69 with SMTP id d66mr8001612pgc.12.1496420141517; Fri, 02 Jun 2017 09:15:41 -0700 (PDT) Original-Received: from [192.168.24.63] (pl25298.ag0304.nttpc.ne.jp. [133.232.153.210]) by smtp.gmail.com with ESMTPSA id r11sm15395516pgn.35.2017.06.02.09.15.40 for (version=TLS1_2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Fri, 02 Jun 2017 09:15:40 -0700 (PDT) In-Reply-To: <8337bicrjm.fsf@gnu.org> X-Mailer: Apple Mail (2.3273) X-detected-operating-system: by eggs.gnu.org: Genre and OS details not recognized. X-Received-From: 2607:f8b0:400e:c00::22c X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.21 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.org@gnu.org Original-Sender: "Emacs-devel" Xref: news.gmane.org gmane.emacs.devel:215414 Archived-At: > On Jun 3, 2017, at 0:55, Eli Zaretskii wrote: >=20 >> From: Jean-Christophe Helary >> Date: Sat, 3 Jun 2017 00:11:53 +0900 >>=20 >> Now, forward to the structure of the current manual... Let's say we = keep the separation between "normal" and "specialized" as far as the = printed copies are concerned, we can still rearrange the way the manual = is structured right now to put related features together and get rid of = that silly "advanced features" section: >>=20 >> =E2=80=A2 1 The Organization of the Screen >> =E2=80=A2 2 Kinds of User Input >> =E2=80=A2 3 Keys >> =E2=80=A2 4 Keys and Commands >> =E2=80=A2 5 Entering Emacs >> =E2=80=A2 6 Exiting Emacs >> =E2=80=A2 52 Quitting and Aborting >> =E2=80=A2 46 Saving Emacs Sessions >> =E2=80=A2 10 Help >>=20 >> =E2=80=A2 8 The Minibuffer >> =E2=80=A2 9 Running Commands by Name >> =E2=80=A2 40 Running Shell Commands from Emacs >>=20 >> =E2=80=A2 18 File Handling >> =E2=80=A2 7 Basic Editing Commands >> =E2=80=A2 22 International Character Set Support >> =E2=80=A2 16 Commands for Fixing Typos >> =E2=80=A2 15 Searching and Replacement >> =E2=80=A2 43 Sorting Text >> =E2=80=A2 24 Indentation >> =E2=80=A2 11 The Mark and the Region >> =E2=80=A2 12 Killing and Moving Text >> =E2=80=A2 13 Registers >> =E2=80=A2 17 Keyboard Macros >> =E2=80=A2 47 Recursive Editing Levels >> =E2=80=A2 30 Dired, the Directory Editor >> =E2=80=A2 42 Printing Hard Copies >>=20 >> =E2=80=A2 14 Controlling the Display >> =E2=80=A2 19 Using Multiple Buffers >> =E2=80=A2 20 Multiple Windows >> =E2=80=A2 21 Frames and Graphical Displays >>=20 >> =E2=80=A2 23 Major and Minor Modes >> =E2=80=A2 25 Commands for Human Languages >> =E2=80=A2 31 The Calendar and the Diary >> =E2=80=A2 26 Editing Programs >> =E2=80=A2 27 Compiling and Testing Programs >> =E2=80=A2 28 Maintaining Large Programs >> =E2=80=A2 29 Abbrevs >> =E2=80=A2 44 Editing Pictures >> =E2=80=A2 45 Editing Binary Files >> =E2=80=A2 37 Document Viewing >> =E2=80=A2 48 Hyperlinking and Navigation Features >> =E2=80=A2 49 Other Amusements >>=20 >> =E2=80=A2 35 Host Security >> =E2=80=A2 36 Network Security >> =E2=80=A2 32 Sending Mail >> =E2=80=A2 33 Reading Mail with Rmail >> =E2=80=A2 34 Gnus >> =E2=80=A2 38 Web Browsing with EWW >> =E2=80=A2 39 Embedded WebKit Widgets >> =E2=80=A2 41 Using Emacs as a Server >>=20 >> =E2=80=A2 50 Emacs Lisp Packages >> =E2=80=A2 51 Customization >>=20 >> =E2=80=A2 53 Dealing with Emacs Trouble >> =E2=80=A2 54 Reporting Bugs >> =E2=80=A2 55 Contributing to Emacs Development >> =E2=80=A2 56 How To Get Help with GNU Emacs >=20 > Could you explain what principles led to this order? 1st section is about starting/quitting and getting help. 2nd is about running commands. 3rd is about text editing 4th is about the display 5th is about the main advertised modes 6th is about networking 7th is about extending Emacs 8th is about the project in general (although 53 could be in the 1st = section) > It looks strange to me to have, for example, "Saving Emacs Sessions" = before "Basic > Editing Commands" Maybe, but Saving emacs sessions is more related to quitting than to = anything else. > , or "Sorting Text" before "Killing and Moving text". Indeed, but Mark&Region/Killing/Registers are all related and Sorting is = closer to general text editing. But there is definitely room for improvement. Jean-Christophe=20