From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Visuwesh Newsgroups: gmane.emacs.bugs Subject: bug#65288: 30.0.50; Make Type: annotation optional in *Help* buffers Date: Mon, 14 Aug 2023 20:47:31 +0530 Message-ID: <87leed4pro.fsf@gmail.com> References: <87pm3p4xjx.fsf@gmail.com> <87jztxivfl.fsf@posteo.net> 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="7106"; mail-complaints-to="usenet@ciao.gmane.io" User-Agent: Gnus/5.13 (Gnus v5.13) Cc: 65288@debbugs.gnu.org To: Philip Kaludercic Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Mon Aug 14 18:33:23 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 1qVaVO-0001fi-TY for geb-bug-gnu-emacs@m.gmane-mx.org; Mon, 14 Aug 2023 18:33:22 +0200 Original-Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1qVaVD-0002Hj-S0; Mon, 14 Aug 2023 12:33:11 -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 1qVaV4-0001wY-Hp for bug-gnu-emacs@gnu.org; Mon, 14 Aug 2023 12:33: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 1qVaV4-0005Ez-9F for bug-gnu-emacs@gnu.org; Mon, 14 Aug 2023 12:33:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1qVaV3-0004TA-Ra for bug-gnu-emacs@gnu.org; Mon, 14 Aug 2023 12:33:01 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Visuwesh Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Mon, 14 Aug 2023 16:33:01 +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.169203075517148 (code B ref 65288); Mon, 14 Aug 2023 16:33:01 +0000 Original-Received: (at 65288) by debbugs.gnu.org; 14 Aug 2023 16:32:35 +0000 Original-Received: from localhost ([127.0.0.1]:34248 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1qVaUc-0004SW-K2 for submit@debbugs.gnu.org; Mon, 14 Aug 2023 12:32:34 -0400 Original-Received: from mail-pj1-x1043.google.com ([2607:f8b0:4864:20::1043]:61446) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1qVaUb-0004SJ-7I for 65288@debbugs.gnu.org; Mon, 14 Aug 2023 12:32:33 -0400 Original-Received: by mail-pj1-x1043.google.com with SMTP id 98e67ed59e1d1-26b41d5e440so949400a91.2 for <65288@debbugs.gnu.org>; Mon, 14 Aug 2023 09:32:33 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20221208; t=1692030747; x=1692635547; h=content-transfer-encoding:mime-version:user-agent:references :message-id:date:in-reply-to:subject:cc:to:from:from:to:cc:subject :date:message-id:reply-to; bh=NqPW0qB28pYUYm91E+cLJeBnOLvWdHUTKpAwScSQ/cE=; b=K4xNjyC2KTquPmg059cgl3gbQE+roh8PItQ6fwLl+fNA3UKGh5sm3HmOjidsXtQXx8 GyqJUz6LfpDpBPVciJsfBnOVY+2sGFWrW/iKM7UBF9pm0Rgm+JP5dwvw2umQ9t2fCAhh L8XDEmWp81V+daW26NalXLDFzqMYdDso+OtxdVICdUtMQUXad5oq4GSxpuhgwGGHBwBi +ZO5/7r6kxMdquxOcaHMnbG5dPV+mQL+W+l1RDNx96kuSNr/bPldPs/ynd/Nxgi2LUSR mqXbHYBHDLupx9azAvxKqgtMtshMokZG0oEIl2L2gZBqjeFOJqzlA4QyfBWgygdJPwAL N6Xw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20221208; t=1692030747; x=1692635547; h=content-transfer-encoding:mime-version:user-agent:references :message-id:date:in-reply-to:subject:cc:to:from:x-gm-message-state :from:to:cc:subject:date:message-id:reply-to; bh=NqPW0qB28pYUYm91E+cLJeBnOLvWdHUTKpAwScSQ/cE=; b=LWb5AZkEyhLwGv1uDXj5ClJ+QSUb+VKwOYlZkY6Q/Uq0NlC0ZlEC64nNIKguaoF5Jc o9aW5GG/li6PxwNOWI6bNkJAZP1P2gaxqTkg+Hql0NnHNdSxr3VPNZTVQOYDgHzuYuWn HELyGDZl3HEyqU0FKgDX1mVh9guEkL5wKsNxMxOODKY8cijOVvnVY3izUg6Gj5KhmRVb QgGVQIUEcVijmgBjvOnTNMNeusrMjiRgdEDZMTggaA00tQHLCDzuUystgGeSwfG2C0Hs JuibHHlzEsnLt05FKa7IgH8Ge8pfdv2SmzU6EWvbCdYGrGymEpYvYM3C87j1RiMbq/F6 f3CQ== X-Gm-Message-State: AOJu0YzSklwzrTkOfGu8yswerVOcwAeLqL84tZN/JDLl6ohjmc5HIX33 tdlqpIU5QG8YpYAQrzu0zZo= X-Google-Smtp-Source: AGHT+IFUrdv2MojYSslSr8YHDcDuUWk2QPbFUdk5pYVt1e3JEAFEMuj0DMbzk1NJ9W2Yrun76LfT9Q== X-Received: by 2002:a17:90a:a609:b0:262:f09c:e73d with SMTP id c9-20020a17090aa60900b00262f09ce73dmr7294589pjq.34.1692030747301; Mon, 14 Aug 2023 09:32:27 -0700 (PDT) Original-Received: from localhost ([118.185.152.162]) by smtp.gmail.com with ESMTPSA id q4-20020a17090a304400b0026b4decfe59sm2914280pjl.31.2023.08.14.09.32.26 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Mon, 14 Aug 2023 09:32:26 -0700 (PDT) In-Reply-To: <87jztxivfl.fsf@posteo.net> (Philip Kaludercic's message of "Mon, 14 Aug 2023 13:51:26 +0000") 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:267436 Archived-At: [=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 Kaludercic w= rote: > Visuwesh writes: > >> Can a user option be added to not show the "Type:" annotation in *Help* >> 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. 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. > That being said, I agree that in cases like `char-after' the information > of a very specific type like that one is limited. I don't know if there > 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?