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 00:18:15 -0400 Message-ID: <20200429041745.srdhgypy5v27e3mv@E15-2016.optimum.net> References: <20200422155528.ccsjljhamqeaocsd@E15-2016.optimum.net> <87h7x33ggs.fsf@panama> 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="86440"; mail-complaints-to="usenet@ciao.gmane.io" User-Agent: NeoMutt/20180716 Cc: 40773@debbugs.gnu.org To: Ulf Jasper Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Wed Apr 29 06:19:33 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 1jTeC5-000MPt-62 for geb-bug-gnu-emacs@m.gmane-mx.org; Wed, 29 Apr 2020 06:19:33 +0200 Original-Received: from localhost ([::1]:39658 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1jTeC4-0006CB-1B for geb-bug-gnu-emacs@m.gmane-mx.org; Wed, 29 Apr 2020 00:19:32 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:59790) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1jTeBb-0006C2-J5 for bug-gnu-emacs@gnu.org; Wed, 29 Apr 2020 00:19:04 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.90_1) (envelope-from ) id 1jTeBa-00016A-Uq for bug-gnu-emacs@gnu.org; Wed, 29 Apr 2020 00:19:03 -0400 Original-Received: from debbugs.gnu.org ([209.51.188.43]:58808) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1jTeBa-00014j-IQ for bug-gnu-emacs@gnu.org; Wed, 29 Apr 2020 00:19:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1jTeBa-0006tA-EO for bug-gnu-emacs@gnu.org; Wed, 29 Apr 2020 00:19: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 04:19:02 +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.158813390626440 (code B ref 40773); Wed, 29 Apr 2020 04:19:02 +0000 Original-Received: (at 40773) by debbugs.gnu.org; 29 Apr 2020 04:18:26 +0000 Original-Received: from localhost ([127.0.0.1]:42121 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1jTeB0-0006sM-7Z for submit@debbugs.gnu.org; Wed, 29 Apr 2020 00:18:26 -0400 Original-Received: from mout.gmx.net ([212.227.17.22]:44797) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1jTeAy-0006s7-8i for 40773@debbugs.gnu.org; Wed, 29 Apr 2020 00:18:24 -0400 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=gmx.net; s=badeba3b8450; t=1588133898; bh=WZ2XBHPrdVSoi5Hh+H/uhD/LecMPUMtKOZVId5Ayd4A=; h=X-UI-Sender-Class:Date:From:To:Cc:Subject:References:In-Reply-To; b=cqTouxUVBth1WtsKjHIabX0+MM21ukdJTCFQqd0EQjzdJTwOnpBT11Oryj1BIeGiy Im6LWMaQnuIQN9pQpateJV5HHqD8WtCDTEr+/1p/AnZbMJvdB0Uo65wiu++wF+u5NX 2+6VpB0p0IFWSIfuDksTnG9ztTTNoU0WQ5iDouks= X-UI-Sender-Class: 01bb95c1-4bf8-414a-932a-4f6e2808ef9c Original-Received: from E15-2016.optimum.net ([100.38.74.74]) by mail.gmx.com (mrgmx104 [212.227.17.174]) with ESMTPSA (Nemesis) id 1M9Fnj-1jZRjq2cIp-006SAs; Wed, 29 Apr 2020 06:18:17 +0200 Content-Disposition: inline In-Reply-To: <87h7x33ggs.fsf@panama> X-Provags-ID: V03:K1:ZVc7nN0L7TclC5slXggz0pKF5nm99nCQPDAdq0g6PyYe03RHNj6 KX/H5xnFOEjosTWhPV1LRC8osobwF8E2BiwgtNiKRo3X0DjAZkX90+ivjZf+vW1YtgQDvyG 7Jq4S+vZF/fQZigybvw2GtMv7fJ5Nbw1/3Yc1zJwQQbpQPRVeEKuYdPmz2VoIhFpQAYBb1g r7tK1lY0gDGfuvQy0P6Yg== X-UI-Out-Filterresults: notjunk:1;V03:K0:Nz58pdX0fPk=:oHhmOdjQ2ek9iADqo9RX9E 9SDiIKVsNGUNicbatSGnICHjZRuHKkYtng6odD1mz+xQt1WpShXf+sei5JCg8FlQkfhNI5FaB eCRQS6f4q99JBbZ+Eu99Fl3YtFJf4qWPWAHRa4voFI9DB8h/GIhTjlm+oxo5z07A4LMk/y2LN ckrVJg9vMxBXPLAqgqmyKC5XFxC7jrQxa264ENwuS+8m3z18Mjroq9sf8VG2ac5zGruM7IkLR 8G32UjiMlHvbn04inRtBArZdbqDmEEtetvZPiYo7MnMThOOG0gPdYNy9XGw9VF0duO9L/xeBi L6xqq7+BIqWHQ498Uuj0Yisrt1b77i+T2B/sn4v7S1PI0zM8m3Xtf6RmiuETgX40OpfKu6LvG VtP8eca5V8sIGUnBtLiNVS3gOAdD/12j1FWJpOiNMfWJ9XzmP1zS7s0KikqQcexQOPA7joji7 m7D2Ck+OYIJLqbyZAY4c8q1ISPs5ymoS8uCYkQ5TSnMZFSGblKlY8WAJZTY1nI7FxUyLH4fpd iJ/xfOR9rxvTLEAHkomsEU9V9NQKjrTFqHm/vmtHnM6nPsdfJnxINx6X/UrQOVPc4U4wzA4c0 hu3/XgZmybdGi1ABVS/YDP+JKuKfrWARvNPriwbDY2VaVaR4M5O2ACO+ISwgYqq/lrdLxk8nb FDQ+EmF1Tt1grvX2ESvjyzzSeQ3WQ7XFgWxAb0Ka2/vyyy71NUli1Z/og/TBr2z1SPYvI5Hgx Qys4jUdAiMorI7GiPGgWesUgpmc+bmd79tT46iHeoOQPM3o0ac6jxsXZr6tIUFvu8yb89fr2 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:179278 Archived-At: On 2020-04-28 15:08, Ulf Jasper wrote: > Am 22.04.2020 um 11:55 (-0400) schrieb Boruch Baum: > > I just discovered the existence of `newsticker' bundled into emacs; > > however, I see not even a cursory mention of it in the emacs manual. A= t > > the very least, there should be a short stub entry in the emacs manual= , > > next to the index entry for > > > > * Gnus:: A flexible mail and news reader. > > You should find newsticker documentation in its own manual: > > * Newsticker: (newsticker). A feed reader for Emacs. That's great, but the point of my report is that there should be a reference to it in the emacs manual, and that reference should be alongside similar emacs packages (eg. gnus). It's not intuitive to check outside of the emacs manual from inside emacs. A user (ahem, me) discovers newsticker in emacs, and by habit looks for it by instinctively typing C-h R. I can understand the situation needs to be different for emacs-related packages that are not bundled into emacs itself and aren't 'part of emacs', but for packages that have become part of the default emacs distribution, the documentation should be withing the emacs manual. IMO, that should be the standard behavior for all similar packages. Further, as a corollary, I suggest that packages bundled in the default 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. =2D- hkp://keys.gnupg.net CA45 09B5 5351 7C11 A9D1 7286 0036 9E45 1595 8BC0