From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Stefan Monnier via "Bug reports for GNU Emacs, the Swiss army knife of text editors" Newsgroups: gmane.emacs.bugs Subject: bug#57974: 2022-08-30; Enhancing help facility for function doc string Date: Thu, 22 Sep 2022 12:47:37 -0400 Message-ID: References: <1509.1663752344@localhost> <871qs56iut.fsf@gnus.org> <6232.1663770080@localhost> <87czbn7jbh.fsf@gnus.org> <16872.1663860126@localhost> Reply-To: Stefan Monnier Mime-Version: 1.0 Content-Type: text/plain Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="33752"; mail-complaints-to="usenet@ciao.gmane.io" User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/29.0.50 (gnu/linux) Cc: Lars Ingebrigtsen , 57974@debbugs.gnu.org To: Ikumi Keita Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Thu Sep 22 20:23:00 2022 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 1obQqi-0008WH-Hj for geb-bug-gnu-emacs@m.gmane-mx.org; Thu, 22 Sep 2022 20:23:00 +0200 Original-Received: from localhost ([::1]:59474 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1obQqh-0000vj-BY for geb-bug-gnu-emacs@m.gmane-mx.org; Thu, 22 Sep 2022 14:22:59 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:42368) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1obPMp-0007ge-Bn for bug-gnu-emacs@gnu.org; Thu, 22 Sep 2022 12:48:03 -0400 Original-Received: from debbugs.gnu.org ([209.51.188.43]:39310) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1obPMo-0007Tq-3g for bug-gnu-emacs@gnu.org; Thu, 22 Sep 2022 12:48:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1obPMn-0003Z3-Lp for bug-gnu-emacs@gnu.org; Thu, 22 Sep 2022 12:48:01 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Stefan Monnier Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Thu, 22 Sep 2022 16:48:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 57974 X-GNU-PR-Package: emacs Original-Received: via spool by 57974-submit@debbugs.gnu.org id=B57974.166386527113650 (code B ref 57974); Thu, 22 Sep 2022 16:48:01 +0000 Original-Received: (at 57974) by debbugs.gnu.org; 22 Sep 2022 16:47:51 +0000 Original-Received: from localhost ([127.0.0.1]:38388 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1obPMd-0003Y4-0n for submit@debbugs.gnu.org; Thu, 22 Sep 2022 12:47:51 -0400 Original-Received: from mailscanner.iro.umontreal.ca ([132.204.25.50]:58647) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1obPMY-0003XB-TO for 57974@debbugs.gnu.org; Thu, 22 Sep 2022 12:47:49 -0400 Original-Received: from pmg2.iro.umontreal.ca (localhost.localdomain [127.0.0.1]) by pmg2.iro.umontreal.ca (Proxmox) with ESMTP id F14B58089B; Thu, 22 Sep 2022 12:47:40 -0400 (EDT) Original-Received: from mail01.iro.umontreal.ca (unknown [172.31.2.1]) by pmg2.iro.umontreal.ca (Proxmox) with ESMTP id D93358079C; Thu, 22 Sep 2022 12:47:38 -0400 (EDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=iro.umontreal.ca; s=mail; t=1663865258; bh=kNXFh4zA8brY3bzqwWmCY4XQvkH71PyW25pjXBv2loY=; h=From:To:Cc:Subject:In-Reply-To:References:Date:From; b=mixY7Dq4QV3pJBQ0+Be49UNlVKwfWiMRZg5WCtVoxRcnKXWN0PoiYq3WCQqkzpEuo 7UHvHIzxDEOMFJlrSc2W/J3MFYUwx3SUQ2gL+Zk5SLnnO5GWif2e0hCdtDUzcXB4Id 7f3lye8MYq3XwsHUzKv5zbi9rDwO9YEgnqe9ZLi9iEM//7Ef3oQPfF3TlTopiTFgQr bMAKQpUA/QYblJuIiJGWjMUhWTFTDvxeeRBBzGcw1Yf6mfP0vzdLi8EALva63bHdp0 tRayBRU55DmszvAP/FGrkJ/bVechofvDofhgrH7OunWV6/nuHD1Z9Jg1CCN/v85bgI 2Kb9orm0L5KzA== Original-Received: from lechazo (lechon.iro.umontreal.ca [132.204.27.242]) by mail01.iro.umontreal.ca (Postfix) with ESMTPSA id B85FB12089E; Thu, 22 Sep 2022 12:47:38 -0400 (EDT) In-Reply-To: <16872.1663860126@localhost> (Ikumi Keita's message of "Fri, 23 Sep 2022 00:22:06 +0900") X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list 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:243432 Archived-At: Ikumi Keita [2022-09-23 00:22:06] wrote: >>>>>> Stefan Monnier writes: >>> Right, makes sense. But there can be more than one advice -- would >>> moving just the :overrides to the front of the doc string solve the >>> problem? >> It used to be there, so maybe that's a good solution, yes. > More radical approach would also be an option, i.e., to display doc > string of B instead of A; but I don't strongly insist. I don't have a strong opinion either. I think the issue has more to do about how to implement it (the info about advice is provided via the same mechanism used for all kinds of other auxiliary info and is not designed to distinguish those things that are more or less important, it has a very limited flexibility right now). Stefan