From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Christopher Dimech Newsgroups: gmane.emacs.bugs Subject: bug#65913: with-help-window arranges for 'inhibit-read-only' to be set to 't' Date: Thu, 14 Sep 2023 18:40:16 +0200 Message-ID: References: <838r9anrmi.fsf@gnu.org> <83v8cem8pu.fsf@gnu.org> <83o7i5nbeq.fsf@gnu.org> <83fs3hmk33.fsf@gnu.org> <83jzsslojd.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="9214"; mail-complaints-to="usenet@ciao.gmane.io" Cc: 65913@debbugs.gnu.org, uzibalqa@proton.me, heimeborgia@protonmail.com, stefankangas@gmail.com, Drew Adams To: Eli Zaretskii Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Thu Sep 14 18:41:13 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 1qgpOy-0002FZ-LR for geb-bug-gnu-emacs@m.gmane-mx.org; Thu, 14 Sep 2023 18:41:12 +0200 Original-Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1qgpOl-0007qv-Au; Thu, 14 Sep 2023 12:41:00 -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 1qgpOi-0007lr-72 for bug-gnu-emacs@gnu.org; Thu, 14 Sep 2023 12:40:56 -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 1qgpOh-0001aY-VD for bug-gnu-emacs@gnu.org; Thu, 14 Sep 2023 12:40:55 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1qgpOn-0008TD-Km for bug-gnu-emacs@gnu.org; Thu, 14 Sep 2023 12:41:01 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Christopher Dimech Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Thu, 14 Sep 2023 16:41:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 65913 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: wontfix Original-Received: via spool by 65913-submit@debbugs.gnu.org id=B65913.169470964232518 (code B ref 65913); Thu, 14 Sep 2023 16:41:01 +0000 Original-Received: (at 65913) by debbugs.gnu.org; 14 Sep 2023 16:40:42 +0000 Original-Received: from localhost ([127.0.0.1]:40978 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1qgpOR-0008SJ-9l for submit@debbugs.gnu.org; Thu, 14 Sep 2023 12:40:42 -0400 Original-Received: from mout.gmx.net ([212.227.15.15]:57111) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1qgpOM-0008S1-EJ for 65913@debbugs.gnu.org; Thu, 14 Sep 2023 12:40:38 -0400 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=gmx.com; s=s31663417; t=1694709616; x=1695314416; i=dimech@gmx.com; bh=hG+X6kWHGjyzNIcigk9Nhym4o4SKxFxzCmQTrL80qbI=; h=X-UI-Sender-Class:From:To:Cc:Subject:Date:In-Reply-To:References; b=iR7/j6hRdJ5vWmQ2HYhiRQn5Cx6EP27qWq71nLB7GP3P3a5RePgpSbJ76S765C07PN7tmr+SERh VOxxVZGoPpw46XVdV3VdPb+nrVKsX+8s+flTzm+MDjmGyBMVjuAj3XQvIdCsAbAcxJXwNc/J3tskG RKNAJlVNhe6HAM3HO8QFILfs91lkQN9rFLoifAF2CFkN3rMK++C6j0TVgAlm2SMTL+BXaVmsKrv2b aDYDFEjwudeX5uGj5klC4PQdMt1aRQH4xSXgaf1bZ39aFwWRPqF1SWTQqAzNQSgCKVVZuQA97w+Gm qAmJPwcsvmBnA8Bb3mPzpOiqMU/K5atbTz5w== X-UI-Sender-Class: 724b4f7f-cbec-4199-ad4e-598c01a50d3a Original-Received: from [141.8.81.247] ([141.8.81.247]) by web-mail.gmx.net (3c-app-mailcom-bs10.server.lan [172.19.170.178]) (via HTTP); Thu, 14 Sep 2023 18:40:16 +0200 Importance: normal Sensitivity: Normal In-Reply-To: <83jzsslojd.fsf@gnu.org> X-UI-Message-Type: mail X-Priority: 3 X-Provags-ID: V03:K1:+HwFhMtzMBG4hDSnOQ9wQ1N3t7+ZgAXMRWg24hA3N9QdfdejZq2wcsJyzMVhAY3cWLNeJ o5PQnlcJVKW5RBO1D3bBzA9ekKOeZUjhV4mzYhHzWweraOQHpducG3E8s9GvDvLxI/qAefZXKsdh JnI9Ub/n0mxvaEWSJALZ1em0mj2UYSqHp2F6FT9PRdzLLh/OtrF0vNorqF0MvrWx03SXrBwxMuKs Jnz+wltno3H2Eih9DaUGv9uNQ3MNdq6kQQrY6tvoqSQOU0iLrIOA6XDOVlpibWfijH0Fsma/tLrq HA= UI-OutboundReport: notjunk:1;M01:P0:ObRTeHlN+uQ=;OOZgaHTVICwRDqdfRHUNZWG1bYy jUV1sXcskrHcMQas6seYu6k3nQlLsaIGgW+m2+37TcbMR0ZooR7XUQrEdtZHlmbgjWt92IheQ +RfupYWRtCIC77Qo76n4c70DyjLSQ34WvhtGMvyL8blbGeOHrh6U7GhVyyfblQTp7b4+UXI5I zMcRO1SIzamWy9x4OXJvkNktgX7bt1GIYlJo1wsYFUM4gnGFRy+/V2suZjPv9//dResvXsM7E X+ljWBaMn0VrAF1LJA6zLFZXOO5SunQd4x4K4HTBWKf+WtpR5kiXnMSbgeYI3+olkkxpjzf9o c7iwaZ1OvUSA0XmdDhOABl6wXdy6czt8BSJqhQD/ule5+EwC4nrzHWkM56Cdz8iSPwi+cqvh2 pllW5m9uN0FACCQDO9KEU9fUbyD33/VFnB0ThXmkOEALt0jCEKZbyeGAPzJcYN/dohf/kTTxM rn3BoKe9YJQENnLNCpNywgopgcwW7011u+w2lMWBVwvK+wmoBpj3wqhVXX8Xlx4fRmVSCAI4b 0NlTNwbWnnMh/NlZGJTSzfSMZamVA74BlVFsRf0k6ynOi6FhpVHbHBn2y+I+9uVZDzR3JuogT v13wlG6S1MpGaBKkVtAcIupsMNlP3lBNaBwt/M85tl3rYB4FjOykk7cFnT3Foylb2wlD8LTwO e9Pc1EAdbXiEBCwG8x6mW1dQtq72eRJkiy2TPcM37UNx0bVtoR7zNYxG2SC82QZLxqxsF2cx1 gv+559lfNPnAEd/6XuPg4h0ofXrYeEj0+RiUhS2j8TI6uXk+0pFumnzfa6YSdJKb4fqx/AeE 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:270449 Archived-At: > Sent: Friday, September 15, 2023 at 4:15 AM > From: "Eli Zaretskii" > To: "Drew Adams" > Cc: uzibalqa@proton.me, heimeborgia@protonmail.com, stefankangas@gmail.c= om, 65913@debbugs.gnu.org > Subject: bug#65913: with-help-window arranges for 'inhibit-read-only' to= be set to 't' > > > From: Drew Adams > > CC: "65913@debbugs.gnu.org" <65913@debbugs.gnu.org>, > > "heimeborgia@protonmail.com" , > > "stefankangas@gmail.com" > > Date: Thu, 14 Sep 2023 16:03:56 +0000 > > > > That said, more links from *Help* to manuals > > could help, I think. > > Yes -- when either the manuals have information that is generally > expected to be in the doc string, but we decided not to have it there > (e.g., because it's very voluminous), or when the place in the manual > where to look is not trivially clear from the doc string. I think the whole point is that if the information is available somewhere, one should be able to access it (voluminous or not). > In most cases, the place where to look for the related information in > the manuals is quite easily found: just visit the manual and then type > "i SYMBOL RET", where SYMBOL is the name of the variable or the > function whose doc string you are reading. There could be some information in the "Introduction to Programming in Emacs Lisp" that illustrates an actual serious problem and how to get to the information from within Emacs itself in an efficient way. But, in my opinion the introduction is more about toy problems rather than complicated actual work examples.