From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Boruch Baum Newsgroups: gmane.emacs.devel Subject: Re: ~Make emacs friendlier: package documentation [POC CODE INCLUDED] Date: Sun, 18 Oct 2020 11:58:44 -0400 Message-ID: <20201018155844.ypnqlq552x3cb73y@E15-2016.optimum.net> References: <20201015190929.gdvx7j2yukcdcoaw@E15-2016.optimum.net> <83pn5jwav0.fsf@gnu.org> <20201015194132.jdn3e2v62vfvh7ju@E15-2016.optimum.net> <83imbawu6y.fsf@gnu.org> <20201016073432.4bmahi4jna2xxayl@E15-2016.optimum.net> <20201018144345.wgrbsivvzuuohbj5@E15-2016.optimum.net> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: quoted-printable Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="8095"; mail-complaints-to="usenet@ciao.gmane.io" User-Agent: NeoMutt/20180716 Cc: Eli Zaretskii , emacs-devel@gnu.org To: Stefan Monnier Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Sun Oct 18 18:03:44 2020 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 1kUB9s-00020W-8b for ged-emacs-devel@m.gmane-mx.org; Sun, 18 Oct 2020 18:03:44 +0200 Original-Received: from localhost ([::1]:38944 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1kUB9r-0005g5-1Y for ged-emacs-devel@m.gmane-mx.org; Sun, 18 Oct 2020 12:03:43 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:52476) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1kUB5C-0000sq-Pj for emacs-devel@gnu.org; Sun, 18 Oct 2020 11:58:54 -0400 Original-Received: from mout.gmx.net ([212.227.17.22]:48487) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1kUB5A-0004FD-Ja; Sun, 18 Oct 2020 11:58:54 -0400 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=gmx.net; s=badeba3b8450; t=1603036727; bh=yhKECD7l5kpdU4Wr39AfqX+Sc1BRA3S0cWXN1naycpM=; h=X-UI-Sender-Class:Date:From:To:Cc:Subject:References:In-Reply-To; b=bGwp5Dv+nHxisagnB8MSUtxyU9H2lO7AYhD2jM+U8XwMUIYoxcUEpED//ihW8+Cwt tLUvAyWa8EgIB7oXk7G2/m00iocmhibOJa0gT5d2Pnkt/mnSc9fIXNWP3BmaNJj/zu 2fuTl8CWqo0cJ4lTc07z/rAZ0BuJOl2xpDY4O/Gc= X-UI-Sender-Class: 01bb95c1-4bf8-414a-932a-4f6e2808ef9c Original-Received: from E15-2016.optimum.net ([72.89.170.172]) by mail.gmx.com (mrgmx105 [212.227.17.174]) with ESMTPSA (Nemesis) id 1M2wKq-1kQslH12bM-003PPZ; Sun, 18 Oct 2020 17:58:47 +0200 Content-Disposition: inline In-Reply-To: <20201018144345.wgrbsivvzuuohbj5@E15-2016.optimum.net> X-Provags-ID: V03:K1:ZSD5YSLTpzalZwIDI123CjsioNhcakOxD8G0qax1HbVH6asrMcT Lj8Db3Nc8DQ2OTvTc7No5n6O4Ag+dllcKPHm1b/D0ICE7zCFbKNY8fXr5JjXKkJu89bBRgQ dvXtsz9fatrQiAuT2uHsqPQFTDnRK99xbpk5LGb5rbyF4qNq4PLcXD01U9Gc+qWN204PYlS 7olBpKsF2yQ+kp1rRs30w== X-UI-Out-Filterresults: notjunk:1;V03:K0:Qjt3w6F+058=:HKQ3iTSab9d/KIjS5fX7h0 i32qyGjiysCai8TZ7AZphMrpI6a6vBaNTA7VtLFnmjDnUX98skktf00PzNQHlNB+jDAg6bn3t anARL5X0cnSN8hqnFlryeA87YQeHpeUlCisZvGoAKa4gpfNpcxurjM6n1wcdo4kdwDQKdzNMj JO0wB7qv+7SI/fzTGQUB6ESuQxxPE4K7RadBRgXMVc8OywBqFlJT0KbRTF5P7np7oxFMQfbTz sZbA0oIV2T4LoqHEbjL+N9fU25f6HK/GgCnygP3HGBowPgHMtzaq8T0FaaU77fERj7IvxRGe/ +Su8ga71RJV2Boze06u5gx+ERESbdbc3xVxqKq1kXiAm+X9aRIPZGreYgnH1ScGjknli3u8bL J4E+mt+TVaHIejRz/CXYiCiT+5DsDnO4bud+Pjxo6zTecH/wiGfLRqaMGyNN0Goicqz790Vo/ oFkS/8qL+6QbBzDbBkpAyqLVj/v0KTsRnGLNL1UrW/frfa6VFFPzBSUYNcadKn/wPnA7GDqG+ +RJLDNzjmdsbFr0pee4G0xScArhntP+vpQMCgauXcweDBGIhoxmln+R5H8O7GIoP2QJjxtEJg AQtNKfhyFiPkz+MNOmg5l3Q3sk0F58IP1uFgjOXJUDXCfLlFx81Suz5M2Ft8pEe7/1TCznc9/ DCBq7ZNib4ILV64vEFBIl/1nOkEn7uur84URKaRdwxfTzGkehTfM54VbCGjulRCokdSo/kLq+ 0mDXMo9d/xRETI36G4MxUo+KttTJEWgjR0xHOR6BqwtQW67XXkwANjKqVtt4QblkkCfOen05 Received-SPF: pass client-ip=212.227.17.22; envelope-from=boruch_baum@gmx.com; helo=mout.gmx.net X-detected-operating-system: by eggs.gnu.org: First seen = 2020/10/18 11:05:43 X-ACL-Warn: Detected OS = Linux 2.2.x-3.x [generic] [fuzzy] X-Spam_score_int: -25 X-Spam_score: -2.6 X-Spam_bar: -- X-Spam_report: (-2.6 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, FREEMAIL_FROM=0.001, RCVD_IN_DNSWL_LOW=-0.7, RCVD_IN_MSPIKE_H2=-0.001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001 autolearn=ham autolearn_force=no X-Spam_action: no action X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.23 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:258040 Archived-At: I just did some extra due-diligence, and need to correct something I said in my prior email... On 2020-10-18 10:43, Boruch Baum wrote: > On 2020-10-18 09:11, Stefan Monnier wrote: > > > 1) I share the sentiment about consolidating the help/describe comma= nds, > > > and have no objection to the feature being accessed via a link in > > > describe-package (ie. no direct dedicated keybinding). > > > > IIUC your pack-doc provides a superset of what `C-h P` provides. > > No, the only intersection is the 'commentary' text taken from the elisp > file. That statement of mine turns out to be false. For example, describe-package for yasnippet does not supply any commentary or package description text at all, while my code submission is chock-full of useful information. =2D- hkp://keys.gnupg.net CA45 09B5 5351 7C11 A9D1 7286 0036 9E45 1595 8BC0