From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: "H. Dieter Wilhelm" Newsgroups: gmane.emacs.bugs Subject: bug#60587: Patch for adding links to symbols' help documentation Date: Wed, 01 Feb 2023 23:09:54 +0100 Message-ID: <86tu05ujf1.fsf@duenenhof-wilhelm.de> References: <86y1qgr1bf.fsf@duenenhof-wilhelm.de> <86tu13qydg.fsf@duenenhof-wilhelm.de> <83h6x2u74b.fsf@gnu.org> <863588rfos.fsf@duenenhof-wilhelm.de> <83o7qw0yjy.fsf@gnu.org> <864jskx6a8.fsf@duenenhof-wilhelm.de> <831qnomh6l.fsf@gnu.org> <86wn5anw04.fsf@duenenhof-wilhelm.de> <86h6wboe2v.fsf@duenenhof-wilhelm.de> 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="38322"; mail-complaints-to="usenet@ciao.gmane.io" User-Agent: Gnus/5.13 (Gnus v5.13) Cc: Eli Zaretskii , "60587@debbugs.gnu.org" <60587@debbugs.gnu.org>, "monnier@iro.umontreal.ca" To: Drew Adams Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Wed Feb 01 23:11: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 1pNLK6-0009oM-KC for geb-bug-gnu-emacs@m.gmane-mx.org; Wed, 01 Feb 2023 23:11:22 +0100 Original-Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1pNLJq-0000ho-Dq; Wed, 01 Feb 2023 17:11:06 -0500 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 1pNLJn-0000hf-3L for bug-gnu-emacs@gnu.org; Wed, 01 Feb 2023 17:11:03 -0500 Original-Received: from debbugs.gnu.org ([209.51.188.43]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1pNLJm-0007mZ-Nz for bug-gnu-emacs@gnu.org; Wed, 01 Feb 2023 17:11:02 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1pNLJm-0004LH-9i for bug-gnu-emacs@gnu.org; Wed, 01 Feb 2023 17:11:02 -0500 X-Loop: help-debbugs@gnu.org Resent-From: "H. Dieter Wilhelm" Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Wed, 01 Feb 2023 22:11:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 60587 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: patch Original-Received: via spool by 60587-submit@debbugs.gnu.org id=B60587.167528941816637 (code B ref 60587); Wed, 01 Feb 2023 22:11:02 +0000 Original-Received: (at 60587) by debbugs.gnu.org; 1 Feb 2023 22:10:18 +0000 Original-Received: from localhost ([127.0.0.1]:60058 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1pNLJ2-0004KG-Tk for submit@debbugs.gnu.org; Wed, 01 Feb 2023 17:10:17 -0500 Original-Received: from mout.kundenserver.de ([212.227.17.10]:54649) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1pNLIy-0004Jw-13 for 60587@debbugs.gnu.org; Wed, 01 Feb 2023 17:10:16 -0500 Original-Received: from ping ([89.246.15.63]) by mrelayeu.kundenserver.de (mreue106 [212.227.15.183]) with ESMTPSA (Nemesis) id 1M5xDJ-1pGUTU11L9-007UQJ; Wed, 01 Feb 2023 23:09:59 +0100 In-Reply-To: (Drew Adams's message of "Fri, 27 Jan 2023 23:13:36 +0000") X-Provags-ID: V03:K1:M0Dd3dK0ERMnU6ayQrVK/wUZ3HbJD5J7nAlVv6XLBLKVWqsKMpg 9sJYQtCP03jb8JdM5FECZajZ2qWScpKxsBm2a8VI4S/79c7B7jQAwYR96K8SYDk1LBt/w8k aTfceoYUadZP8AKu0lcwEyIUbEbsf0T8mDxScf/QFElZzdjljBD3heFfDGBkbbZBB8Y9jHo x/2IYKVMFxPWo7WiDHo6w== UI-OutboundReport: notjunk:1;M01:P0:1Rggi2kyjqw=;yAEaUCkkOitI+slWCUk68/WGM2J LyjGQdejFa9VxvuV0mwauZBA008woLCkplwFwaJ3m6VPrFdiDx2T4diLcz3ArpOF2hiW4Rapm 9tVq5FkyW90AhnsNUnlwxXI2BIy5V6JOCHyYrS9VW2CCQD6mnkoK9pp66yxOVNZg6QSC3PE9M iwEWbCk5j+DwoVBQ3oeb+R1dQHV2nARIi6qBioAv+Y3jZjGrIZq6Nomlv9GaE61LjLHtyH3SE Yp5bj61mVw06XodrJuMF4GU46/UqWqeB/r/f+4/sb3YDHDYGr/Y6z+R+D2lCiLYDGaP1LRwnG YfZCoxxMLBVPGVgwZge57bIouLHCL1iJZXwp9VLS0/1EKy6l67yDepClX5X2Xb4K+v3TlQPif WoWknkyOlvSQT23OPoJ+rua+OyxOPTdLS3w35THms/SBvhatSAra+WRPCn8CYoboYcwR+ZZD4 gfRfLWYtBF+oaLEPoA5WL4o5LIpFE9ceUfJVrEatpj9uRzfHF/dNRSvlmdxTdmRE67LW6tgh/ yV/wara1I7iXx4VTTw6ix07Mj6Xuj/jnaTHqkwn7IHs5Ux6gWZRNZl303ZJPQ2jPlOMFcyZMA wl1Fqwou2TWzftkqiJ2mnK4Zpi0805GLSSCvDGN+erIS4DsLy3rIhoDUiFssjy+YH516eMbU1 M4ercy/qeSsgcYFWvcr5fRGeXLo3kjIJAuLFgoQTUw== 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:254606 Archived-At: Hi Drew Drew Adams writes: >> > 1. >> > + :type '(choice (const :tag "Create links" t) >> > + (const :tag "Do not link" nil)) >> > >> > is better as just :type 'boolean, and say in the >> > doc which Boolean value means which behavior. >>=20 >> The doc string says now: >>=20 >> "True (`t') means Emacs creates symbol link buttons in Info. >> Setting this variable to `nil' inhibits the creation of buttons >> on quoted symbols to their help strings. Please see the function >> `info-make-xrefs' for further details." > > Is the defcustom now :type 'boolean? Please tell me why you insist now on changing the :type from choice to boolean? Above you stated that it "is better than just :type boolean"!? I experimented in `customize' with :type 'boolean and the "toggle" button is fast and easy. On the other hand with 'choice I think the alternatives are clearer documented while changing it's values.. >> > 4. Or instead of having an option, maybe just have >> > a minor mode. >>=20 >> That's also a nice idea. (Maybe for later.) > > See Stefan's reply... Alright, I'm going in this direction but I'm not so fast. =F0=9F=98=85 >> > 6. "clicking @kbd{mouse-2} or @kbd{mouse-1} on it" >> > can't be right, I think. At least that doesn't >> > express what `mouse-1-follows-link' does/means. On the suggestion of Eli, I just stated `mouse' and added a cross reference, ahem, link to the mouse manual section. Thanks for your interest Dieter --=20 Best wishes H. Dieter Wilhelm Zwingenberg, Germany