From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Andrea Corallo Newsgroups: gmane.emacs.bugs Subject: bug#65288: 30.0.50; Make Type: annotation optional in *Help* buffers Date: Sun, 20 Aug 2023 06:11:20 -0400 Message-ID: References: <87pm3p4xjx.fsf@gmail.com> <87jztxivfl.fsf@posteo.net> <87leed4pro.fsf@gmail.com> <83350f1lmy.fsf@gnu.org> Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="31440"; mail-complaints-to="usenet@ciao.gmane.io" User-Agent: Gnus/5.13 (Gnus v5.13) Cc: 65288@debbugs.gnu.org, philipk@posteo.net, Visuwesh To: Eli Zaretskii Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Sun Aug 20 12:12:25 2023 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 1qXfQ0-0007xx-Hw for geb-bug-gnu-emacs@m.gmane-mx.org; Sun, 20 Aug 2023 12:12:24 +0200 Original-Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1qXfPh-0006ST-Dg; Sun, 20 Aug 2023 06:12:05 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1qXfPe-0006Rg-CQ for bug-gnu-emacs@gnu.org; Sun, 20 Aug 2023 06:12:03 -0400 Original-Received: from debbugs.gnu.org ([2001:470:142:5::43]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1qXfPc-0005PU-OG for bug-gnu-emacs@gnu.org; Sun, 20 Aug 2023 06:12:00 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1qXfPe-0006qL-8Q for bug-gnu-emacs@gnu.org; Sun, 20 Aug 2023 06:12:02 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Andrea Corallo Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sun, 20 Aug 2023 10:12:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 65288 X-GNU-PR-Package: emacs Original-Received: via spool by 65288-submit@debbugs.gnu.org id=B65288.169252629226251 (code B ref 65288); Sun, 20 Aug 2023 10:12:02 +0000 Original-Received: (at 65288) by debbugs.gnu.org; 20 Aug 2023 10:11:32 +0000 Original-Received: from localhost ([127.0.0.1]:53119 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1qXfPA-0006pK-18 for submit@debbugs.gnu.org; Sun, 20 Aug 2023 06:11:32 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:55926) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1qXfP6-0006p5-LZ for 65288@debbugs.gnu.org; Sun, 20 Aug 2023 06:11:30 -0400 Original-Received: from fencepost.gnu.org ([2001:470:142:3::e]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1qXfOz-0005KT-72; Sun, 20 Aug 2023 06:11:21 -0400 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnu.org; s=fencepost-gnu-org; h=MIME-Version:Date:References:In-Reply-To:Subject:To: From; bh=8LfUd4juxcng1rhGCHpBf8Jj/Yen6EFfpdS1HB9Peoc=; b=fQMV8ouJzf8KvqClGOhh 71aoMTEMRbpdALGw/uMApC9oXV+Iz7fADlGGPmfFy1EJByaQiKnCrL0VMw3H1YP4+NjwY8bfNIwoW mY8J3FYvwM6/BUDFvApmlPJ/5RjeC71dVtDiy9C6DjQBTk3WLNwVyn8Tt0ivzu0+SQE5YGqcQR4ot pRPr0BsccS2nxui92ZhLqg4wpC9gfIhfsI11venER5j9qAqmt+lTUa0uXK6xBZRIuaGx/kbtPC7dt +Hb1riaNg6iR+u/Vrfasjkngjowx+V4wZSupI8Mmo7tpJCR6Vm3c3m9Dyc03fASMTxLpBKSuqEKK6 FsMUV3Ca3MNNrg==; Original-Received: from acorallo by fencepost.gnu.org with local (Exim 4.90_1) (envelope-from ) id 1qXfOy-0004pv-WA; Sun, 20 Aug 2023 06:11:21 -0400 In-Reply-To: <83350f1lmy.fsf@gnu.org> (Eli Zaretskii's message of "Sat, 19 Aug 2023 11:28:37 +0300") 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-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Xref: news.gmane.io gmane.emacs.bugs:267974 Archived-At: Eli Zaretskii writes: >> Cc: 65288@debbugs.gnu.org >> From: Visuwesh >> Date: Mon, 14 Aug 2023 20:47:31 +0530 >>=20 >> [=E0=AE=A4=E0=AE=BF=E0=AE=99=E0=AF=8D=E0=AE=95=E0=AE=B3=E0=AF=8D =E0=AE= =86=E0=AE=95=E0=AE=B8=E0=AF=8D=E0=AE=9F=E0=AF=8D 14, 2023] Philip Kaluderci= c wrote: >>=20 >> > Visuwesh writes: >> > >> >> Can a user option be added to not show the "Type:" annotation in *Hel= p* >> >> buffers for certain functions? An example is `char-after' >> >> >> >> char-after is a built-in function in =E2=80=98src/editfns.c=E2=80= =99. >> >> >> >> (char-after &optional POS) Type: (function (&optional (or marker >> >> integer)) (or null (integer -2305843009213693952 >> >> 2305843009213693951))) >> >> >> >> Return character in current buffer at position POS. >> >> POS is an integer or a marker and defaults to point. >> >> If POS is out of range, the value is nil. >> >> >> >> If not a user option, can it be moved after the docstring? >> > >> > Only functions have types, these are not the same types those given to >> > user options. >>=20 >> There's no confusion about user option type and function argument type >> but this info crowds the second line which only contained the function >> signature before. Other extra info are at the bottom of the buffer so >> moving it there would be more consistent too. >>=20 >> > That being said, I agree that in cases like `char-after' the informati= on >> > of a very specific type like that one is limited. I don't know if the= re >> > is a sensible heuristic to reformat the type into something like >> > >> > (function (&optional position) (or position null)) >> > >> > using some kind of type aliasing, but it might be better to not >> > highlight the information so prominently? > > Andrea, would it make sense to introduce an option which could disable > showing this information in *Help*? Hi Eli, sure why not, something like `help-enable-function-type'? Thanks Andrea