From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED.blaine.gmane.org!not-for-mail From: Nicholas Drozd Newsgroups: gmane.emacs.bugs Subject: bug#37812: Update Emacs manual intro with more compelling features Date: Fri, 18 Oct 2019 12:50:46 -0500 Message-ID: Mime-Version: 1.0 Content-Type: text/plain; charset="UTF-8" Injection-Info: blaine.gmane.org; posting-host="blaine.gmane.org:195.159.176.226"; logging-data="224422"; mail-complaints-to="usenet@blaine.gmane.org" To: 37812@debbugs.gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Fri Oct 18 20:17:03 2019 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([209.51.188.17]) by blaine.gmane.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.89) (envelope-from ) id 1iLWoB-000wEJ-FH for geb-bug-gnu-emacs@m.gmane.org; Fri, 18 Oct 2019 20:17:03 +0200 Original-Received: from localhost ([::1]:44806 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1iLWoA-0006fC-4H for geb-bug-gnu-emacs@m.gmane.org; Fri, 18 Oct 2019 14:17:02 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:60122) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1iLWPz-0005qP-RM for bug-gnu-emacs@gnu.org; Fri, 18 Oct 2019 13:52:04 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1iLWPy-0001A1-Pn for bug-gnu-emacs@gnu.org; Fri, 18 Oct 2019 13:52:03 -0400 Original-Received: from debbugs.gnu.org ([209.51.188.43]:42691) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1iLWPy-00019x-Mm for bug-gnu-emacs@gnu.org; Fri, 18 Oct 2019 13:52:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1iLWPy-0004y3-IE for bug-gnu-emacs@gnu.org; Fri, 18 Oct 2019 13:52:02 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Nicholas Drozd Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Fri, 18 Oct 2019 17:52:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 37812 X-GNU-PR-Package: emacs X-Debbugs-Original-To: bug-gnu-emacs@gnu.org Original-Received: via spool by submit@debbugs.gnu.org id=B.157142106819010 (code B ref -1); Fri, 18 Oct 2019 17:52:02 +0000 Original-Received: (at submit) by debbugs.gnu.org; 18 Oct 2019 17:51:08 +0000 Original-Received: from localhost ([127.0.0.1]:51509 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1iLWP5-0004wV-Tr for submit@debbugs.gnu.org; Fri, 18 Oct 2019 13:51:08 -0400 Original-Received: from lists.gnu.org ([209.51.188.17]:45814) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1iLWP1-0004wL-3P for submit@debbugs.gnu.org; Fri, 18 Oct 2019 13:51:06 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:60052) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1iLWOz-0004YL-LJ for bug-gnu-emacs@gnu.org; Fri, 18 Oct 2019 13:51:02 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1iLWOy-0000dl-K5 for bug-gnu-emacs@gnu.org; Fri, 18 Oct 2019 13:51:01 -0400 Original-Received: from mail-il1-x130.google.com ([2607:f8b0:4864:20::130]:33930) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1iLWOy-0000dR-G3 for bug-gnu-emacs@gnu.org; Fri, 18 Oct 2019 13:51:00 -0400 Original-Received: by mail-il1-x130.google.com with SMTP id c12so6332820ilm.1 for ; Fri, 18 Oct 2019 10:51:00 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=mime-version:from:date:message-id:subject:to; bh=FrbZXL2vIBgY+AtLVfBO7lCA96PEyU6D6FaXa6InSeo=; b=bnTHKNVmyMZHvu1xzxeK3I+AK54TlDUw2Ei7/ERu1xHFqA4vyyGm34DarKQGnFWtpR 69UNVXvhe4ID+R7inb24GxNeCNCBnFWUxtffnd04ilgJj6hITWT1FLd39jqZPadj0+nt HF2qoqoEu1YcidZd8nvagy8j1G+XnkXAaMv/X4hZvOMq+RLmcyPnZ/QpC5lLHyaOvyvo OPZy/VVjAuuY5kFw+ckRl2DPTn3qg0i3N6Jvr8v4EJSLzxZjqvfWlDn7MMP3+wG0/JJF e8knfUyZjrEbZFjVD1905FhGmsVcUVWQpkNqw0jX9r24ZncXV5jtBPYc9m8m8sPJMyRR vqWg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:mime-version:from:date:message-id:subject:to; bh=FrbZXL2vIBgY+AtLVfBO7lCA96PEyU6D6FaXa6InSeo=; b=GgHjXwHArpXMMl5m4YnInxF7GbaUqow8QSmgd3fQbGZYS53G54nz6Qm/S4wgCypKxB Cu8TsjgT9l3YQMZac3Ex5/WGHYbpGvoiJse1lMKDZq2gqDLJi+IAghwo4Gxh/ru+0l4V 0ZZ3CwusEz83k3dWf48EVHGfpQa3mvxrmTaJGEB2GF8+Iy6dBo+nrY+EKA1wz0EX2kqT TnCcqXfOYZPcmqG4v0gDRRmQIRUy/tHqESgebwHL5SwMpBnaBoI36iLEdrjrHspleS4O /GdNfZXZRfmwVvhUUOqQhApGllbgzeVmDmAAlbIP84iM/UiPlXI1ki0gJu8pNnnhHZoR 50wA== X-Gm-Message-State: APjAAAXMRT7803WkWvubU2ZZmBii/opfssodj65iYVOSU/2TaMizfHt4 7XDDUvXb7U2n1ZoA9zq7QkNWXxPYb8+31KEJp0ADgPY/gC4= X-Google-Smtp-Source: APXvYqwcikK0JPg/ybijNr2JcEpik5JjJ04nK/YoX9Cf5kzR7mjm25gBYG28Zv+3tRz6fU5UW2q+JEJJrJM0qM6vXcE= X-Received: by 2002:a92:4d2:: with SMTP id 201mr5981330ile.289.1571421059155; Fri, 18 Oct 2019 10:50:59 -0700 (PDT) X-detected-operating-system: by eggs.gnu.org: Genre and OS details not recognized. X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 209.51.188.43 X-BeenThere: bug-gnu-emacs@gnu.org List-Id: "Bug reports for GNU Emacs, the Swiss army knife of text editors" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Original-Sender: "bug-gnu-emacs" Xref: news.gmane.org gmane.emacs.bugs:169673 Archived-At: The introduction to the Emacs manual says, right near the beginning: "We call Emacs 'advanced' because it can do much more than simple insertion and deletion of text. It can control subprocesses, indent programs automatically, show multiple files at once, and more." This text has been around for a long time*. Maybe it's time for an update? Indenting programs automatically and showing multiple files at once aren't very compelling features these days. My go-to example of a remarkable Emacs-y feature is EWW, so maybe "browse the Web" could be added? Or something to do with Org mode? I don't know exactly, but listing "shows multiple files" as a feature is like describing someone as "punctual" in a reference letter -- it could signal that the person has no other important qualities. * How old exactly, I'm not sure. It appears in the 18.59 manual from 1992 (ftp://ftp.gnu.org/old-gnu/emacs/), so I assume it goes back even further than that. The passage underwent a minor facelift in 2006 (commit 350287ef), but besides that it has gone substantially unchanged.