From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.ciao.gmane.io!not-for-mail From: Boruch Baum Newsgroups: gmane.emacs.bugs Subject: bug#40773: newsticker documentation Date: Wed, 29 Apr 2020 14:55:54 -0400 Message-ID: <20200429185554.wd2byg5lksp7ngj5@E15-2016.optimum.net> References: <20200422155528.ccsjljhamqeaocsd@E15-2016.optimum.net> <87h7x33ggs.fsf@panama> <20200429041745.srdhgypy5v27e3mv@E15-2016.optimum.net> <838sie205k.fsf@gnu.org> <20200429091213.rtyoo537qgccbccz@E15-2016.optimum.net> <83v9lizlcu.fsf@gnu.org> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: quoted-printable Injection-Info: ciao.gmane.io; posting-host="ciao.gmane.io:159.69.161.202"; logging-data="39284"; mail-complaints-to="usenet@ciao.gmane.io" User-Agent: NeoMutt/20180716 Cc: 40773@debbugs.gnu.org To: Eli Zaretskii Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Wed Apr 29 20:57:35 2020 Return-path: Envelope-to: geb-bug-gnu-emacs@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 1jTrtm-000A4r-H1 for geb-bug-gnu-emacs@m.gmane-mx.org; Wed, 29 Apr 2020 20:57:34 +0200 Original-Received: from localhost ([::1]:54142 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1jTrtl-0001V9-2o for geb-bug-gnu-emacs@m.gmane-mx.org; Wed, 29 Apr 2020 14:57:33 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:40290) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1jTrtH-0001Up-36 for bug-gnu-emacs@gnu.org; Wed, 29 Apr 2020 14:57:03 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.90_1) (envelope-from ) id 1jTrtG-0005Nx-DE for bug-gnu-emacs@gnu.org; Wed, 29 Apr 2020 14:57:02 -0400 Original-Received: from debbugs.gnu.org ([209.51.188.43]:33055) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1jTrtG-0005Nr-0a for bug-gnu-emacs@gnu.org; Wed, 29 Apr 2020 14:57:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1jTrtF-00043B-WC for bug-gnu-emacs@gnu.org; Wed, 29 Apr 2020 14:57:02 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Boruch Baum Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Wed, 29 Apr 2020 18:57:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 40773 X-GNU-PR-Package: emacs Original-Received: via spool by 40773-submit@debbugs.gnu.org id=B40773.158818656615484 (code B ref 40773); Wed, 29 Apr 2020 18:57:01 +0000 Original-Received: (at 40773) by debbugs.gnu.org; 29 Apr 2020 18:56:06 +0000 Original-Received: from localhost ([127.0.0.1]:44598 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1jTrsL-00041f-Rf for submit@debbugs.gnu.org; Wed, 29 Apr 2020 14:56:06 -0400 Original-Received: from mout.gmx.net ([212.227.17.20]:60755) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1jTrsK-00041C-1x for 40773@debbugs.gnu.org; Wed, 29 Apr 2020 14:56:04 -0400 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=gmx.net; s=badeba3b8450; t=1588186557; bh=zVmOxmdam9HMFNbE5b7eRzPaKlImMK1AfuCU3Yujq04=; h=X-UI-Sender-Class:Date:From:To:Cc:Subject:References:In-Reply-To; b=LoC/5zlt4NqeK5ruFk+MfgsxXACI3skaNgzBDtoWp9bAhUnTa2sRAluVfyBmCT/YX vqHR7pGMOkpknOWRvMIDMx4/fPlWZlfTmnnRg4NPNev/WfFfJPyb6WDatLPdDC9hpb KSWwOJM0vu5xUwQtVMKIEN+N09z+oN93XajIyHLc= X-UI-Sender-Class: 01bb95c1-4bf8-414a-932a-4f6e2808ef9c Original-Received: from E15-2016.optimum.net ([100.38.74.74]) by mail.gmx.com (mrgmx105 [212.227.17.174]) with ESMTPSA (Nemesis) id 1MDQic-1jMkah0hhG-00Aa7h; Wed, 29 Apr 2020 20:55:57 +0200 Content-Disposition: inline In-Reply-To: <83v9lizlcu.fsf@gnu.org> X-Provags-ID: V03:K1:U+Szob3lzC8377De+lMd4NRgd3LW7AnWN5ehQM5g1yhcEeahgNV rX5Kw2InkRWmTZEmyqxoj+di4upqh6Lwc48jrE3irvUq0wHzBZCzpuqvHHfpgz8Jp0SUxQR DwT3EnIVzjl4/h9CChlCEcGNkAMTJlLPFNctG9PV9tHoDB/N0Rzf4HMJHl+uB/vQDDmzgUB MuRm4gsiXnkLpLd6q4yNg== X-UI-Out-Filterresults: notjunk:1;V03:K0:c0PbJy1pHsA=:PgTi7REKSNakX9GjKUvdNM +mGFeN5/GIcWfmCyTYwJt8nTjS1qTiwAU6RKhNPf5O4FTnQbxtnCp5qpi+uLIw1/s0EX7LYUQ DKR8y1Nb81X/DNT5RRYuYnskkQIfHKY4WAimYybF/K/ONaTfYziQGSjb5WIJ5dxCh91UbL/Yt lMqYHejE0P2sghUpA3k1Oe2hnMNQSJ8cE7Og5utv7sFNxf4/ez8mAlUyiN8YuEJSk8wyH/5wQ sx9IS0eEld+f7b24fIrYekeGXlciZVnJPDQIYIwQAMaHjW9sSu6WZGTPQ1qrZ1HHsU93kRJjq UisSNZSuxPW5RuON8ZwVM/s7ABmlF/h9kKjMqlRC7b+bniNyqLkITydH/IdOqwp09z501unJR PXjqImUHgQcFjiAJRF7p25Ey2rnJV0i/tskd2mT9+wBgGsjQX/hgNEuADN1g5jesTkB6d0lz5 8hAF99+XojZ8MrfiDIOdqAkbRWkiocxUESvSenSOs8rf8ei5EJML9Lw7idI6JNOB0g5qnBlMz e0gHVJdm1+Pv3s+RdBbPjQkqo7crFIGOwV3hPB61m06BE0yEV3f9K4g5+eOMm74QrcDeowhlx awmSNRQgs41n/JPrOiTVflDQQf689PtzcCvHyYVwhavth1vc7eWq2yPMTqdPHQ6lyCavSgPCE 42giCMo5xrVKGYRWvmRrg6S8B2VlgfXgUWsXQM8KQDJpPHYnLV53L9c7M49blk22NUvcOkN/n qzBfGegnsOOkFJi0hX8CJwuZCW5GYSEHkoUNLKibK2C7nBmt3LjZAVTcRw2t0djqxU/eUQel X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list 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-mx.org@gnu.org Original-Sender: "bug-gnu-emacs" Xref: news.gmane.io gmane.emacs.bugs:179346 Archived-At: On 2020-04-29 12:34, Eli Zaretskii wrote: > > Date: Wed, 29 Apr 2020 05:12:13 -0400 > > > > Further, as a corollary, I suggest that packages bundled in the de= fault > > > > emacs distribution should NOT have info nodes in the emacs section= of > > > > the root info index, ie. no duplication. Either the emacs section = of the > > > > root info index should be restricted to non-default emacs packages= , or > > > > there shouldn't exist such a section at all, and the emacs manual = should > > > > have a section for external packages. > > > > > > I don't think I understand what you propose here. What is "the root > > > info index"? is that the Emacs menu in the DIR file > > > > That sounds right. I meant what I see when I type `C-h i'. > > Then I don't understand the rationale for removing the entries from > there. What useful purpose would that serve? It manages and guides users' expectations. Emacs should have a single authoritative manual, and users should feel confident that they can turn to a single place for the comprehensive documentation. When you partially duplicate components in a second place, you confuse beginner users as to where to turn for documentation. If it were up to me, the entire Emacs section for M-x info would have just three entries: Emacs * The emacs manual All the features of the default emacs * Your emacs extensions Docs for the add-ons you've installed * Other emacs help Ways to quickly find information The third entry would point to content similar to what is displayed by M-x help-for-help (C-h ?), but also mentioning M-x info-display-manual, and whatever other constructive input gets suggested. =2D- hkp://keys.gnupg.net CA45 09B5 5351 7C11 A9D1 7286 0036 9E45 1595 8BC0