From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: =?utf-8?Q?Daniel_Mart=C3=ADn?= Newsgroups: gmane.emacs.devel Subject: Re: Helpful in Emacs? Date: Thu, 09 Sep 2021 17:21:30 +0200 Message-ID: References: Mime-Version: 1.0 Content-Type: text/plain Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="39895"; mail-complaints-to="usenet@ciao.gmane.io" User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/27.2 (darwin) Cc: Stefan Kangas , me@wilfred.me.uk, Emacs developers To: Arthur Miller Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Thu Sep 09 17:22:34 2021 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 1mOLso-000ACr-9D for ged-emacs-devel@m.gmane-mx.org; Thu, 09 Sep 2021 17:22:34 +0200 Original-Received: from localhost ([::1]:58058 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1mOLsm-0001J9-Jh for ged-emacs-devel@m.gmane-mx.org; Thu, 09 Sep 2021 11:22:32 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:45606) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1mOLs0-0008GN-Hr for emacs-devel@gnu.org; Thu, 09 Sep 2021 11:21:44 -0400 Original-Received: from sonic304-22.consmr.mail.ir2.yahoo.com ([77.238.179.147]:34784) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1mOLrx-00023O-1h for emacs-devel@gnu.org; Thu, 09 Sep 2021 11:21:44 -0400 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=yahoo.es; s=s2048; t=1631200896; bh=k1H8/sHe+DHI9i75AFQYNGgFjXsipRmN25XF/f5AeQU=; h=From:To:Cc:Subject:References:Date:In-Reply-To:From:Subject:Reply-To; b=OY7ZUkTESZg0ZQ/U8Q2+/CLsQq3j04dst3FkURx3I8muJbMk6J8joOUTW8bKpJhedoXmAQXbN0rAO6atQxEPowL/FpaBl12mjB/opQARxo0fdSX3ycZxL/EdlULrBC6IywNym3GmbHGbSUMFA4TlDNOz6E9ZaoiamGo7NIhLr0hDPZzGi5MOsiNcfmhOd+W5rdQWCZnpERYeix5TCw+i7Q9BodyCIA+Nb3P75LG2D5NsYgNRoYcxW9J/B+vgDrsNqf0zPulB4YYgr5vVgH9majfFaniQ1U7W2JtF4+Rx66e+Vfamhixls3nhChVDOAZuJvdUTs8g0o9DOBIqwHD96w== X-SONIC-DKIM-SIGN: v=1; a=rsa-sha256; c=relaxed/relaxed; d=yahoo.com; s=s2048; t=1631200896; bh=QE/PLJMqkvaLg/2U15d0zvPL9AX9ETUOJoR3/4e0z+O=; h=X-Sonic-MF:From:To:Subject:Date:From:Subject; b=ozjb0nj/fCTjaYVFLROwOQval8aT5SFVcDEf5KxrLQcCNPaDwBcWvoTh0vEQgpjV3zAAyi4srDEY1bIhNwSzxtjSiIS1MWJEkdyrwhWJxDOj4LytodiYnNBm4R1BblBesTCrsW/kQVih4Ax0qZcI3ZtNnLeOY2bgKSQ04HzEOa6YaLNYbsfd0W8NIt7LvHK7Y47RPkoP1MJWn12kC2QfULHKR3eShonn2UVQ3sCK2dSbGhC8loDPJG2NE+46M3uToe21XFyp4SJRu5ExqAYWS5roKyBAbAFVXNqYkoW3siHtCKfwc5fExgFp9/pKJdFe6DOAWyiHvGTFk2WiJ63PwA== X-YMail-OSG: nQxcEzgVM1mLLLeSM2Dd8jzG0QbegRX4flZMyLfbP7Kj9ZAKWs0k8K_8k5ybfM6 Mc0fDGy7oZMp2Ul2t2OcFON3OhUax5MW5xKW4Nrpa7nPXrVmBdrSaLmdkDIvhUdsrAEDQTk7QsWO 4kcAM4NtdrMDRmS3qbDb6ZBjXLt_roFSPQKOYNz8rwl0Ksa6l_3610yXL_9iuCrCMeohDhL1Thjp P_5b025vBj72nZVbrML8BI2Ng0eKImOHON6nIfnCBEp.97XUpPOWQ0VqWvbWm1pJI_EiUHivNatL CPRzY8Mv79.rolfEVpG09g6eyHleGt44cwnjQUev.qkfVJ8a9P.T7tfC2ELa_iab4jmXgXujZLCf LQbc0_JHRD5eHSXDTcF_oP0etBefe0lXdCHjj7hTCo_XliUHha24BxA2QfYsiBwqc7I_7UOGCesE AQ43bJ9xR2zw7gsG0Df7dLxcGCjNPF4Llw6v04ONZc9ReD.Y_UQRvEilBQBaeBU8jcBxXbC5qNuV obbga5WqkMHBNMzCam.NA_59egmcYhSceNLA0bNSU.uJv3I8hVERRQ22F7_9ryMcs9qIWA7F0nBA OEt3oInV79YBY99tdc0tENgoaOJ6d2ROtL29GNVYJHog49UmYJg8HjkSQ6JUIXSVNBO__3jV751e xduv6tjCCaCO3SJf62achkmG1dK.L1xFDgBntzjBWtRhCeR1n1oT3E_TTv8VGzxPttFCxdqvA2J6 Au1GrsONbERfMywOWXLd5Svr0YXCdulFDRjdllVPyT5F2t_.LBJPL3kn2fHPjc_7cwrxqbPY8xlz rh5uKgf1Bt1G2S4PqvgUpnXTA0VnXY_NZPzpA19u7p X-Sonic-MF: Original-Received: from sonic.gate.mail.ne1.yahoo.com by sonic304.consmr.mail.ir2.yahoo.com with HTTP; Thu, 9 Sep 2021 15:21:36 +0000 Original-Received: by kubenode531.mail-prod1.omega.ir2.yahoo.com (VZM Hermes SMTP Server) with ESMTPA ID 1036a6d4a2cab503613535fc70d6ff89; Thu, 09 Sep 2021 15:21:31 +0000 (UTC) In-Reply-To: (Arthur Miller's message of "Thu, 09 Sep 2021 14:35:47 +0200") X-Mailer: WebService/1.1.18924 mail.backend.jedi.jws.acl:role.jedi.acl.token.atz.jws.hermes.yahoo Received-SPF: pass client-ip=77.238.179.147; envelope-from=mardani29@yahoo.es; helo=sonic304-22.consmr.mail.ir2.yahoo.com X-Spam_score_int: -18 X-Spam_score: -1.9 X-Spam_bar: - X-Spam_report: (-1.9 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, FREEMAIL_ENVFROM_END_DIGIT=0.25, FREEMAIL_FROM=0.001, RCVD_IN_DNSWL_NONE=-0.0001, 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:274455 Archived-At: Arthur Miller writes: > A week or two ago I was actually looking at Emacs help code. I wanted to bring > in the source code as well as references into help lookup, but honestly, I would > rather prefer to just include helpful instead of re-implementing everything. If > the authors have signed the paperwork, I see no reason why not just include > it. Also original help lookup could be left as low-resource, faster solution for > people who prefer to spend less resources on help lookup, while helpful could be > enabled by a custom variable, something like show extended help or as > a minor mode. Instead of integrating the library as a whole, I'd prefer we extract those features from Helpful that people think are useful and not already available in Emacs. I don't think that having two separate help systems in core is a good idea, there'll be too much duplication and maintenance burden. Showing references to a symbol is an interesting feature (for example, to learn how to use an ELisp API by looking at examples). I see that Helpful provides this feature via the separate package elisp-refs (https://github.com/Wilfred/elisp-refs). The closest package I know that actually understands ELisp is el-search from ELPA, but elisp-refs is a more specific package for the concrete use case of searching for references. If we can get copyright papers, perhaps we could start by integrating the functionality of elisp-refs as an xref backend. Then the help system could use the new backend to provide a "References" link button.