From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Drew Adams Newsgroups: gmane.emacs.devel Subject: RE: How to make Emacs popular again. Date: Thu, 8 Oct 2020 15:47:11 -0700 (PDT) Message-ID: <39e60177-7d71-489a-a39c-38b3cf291266@default> References: <20200926163008.GS1349@protected.rcdrun.com> <749c3394-ec9a-43a5-aad6-942a5583d072@default> Mime-Version: 1.0 Content-Type: text/plain; charset=iso-8859-1 Content-Transfer-Encoding: quoted-printable Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="37542"; mail-complaints-to="usenet@ciao.gmane.io" Cc: bobnewell@bobnewell.net, =?iso-8859-1?B?Sm/jbyBU4XZvcmE=?= , Robert Pluim , Richard Stallman , emacs-devel@gnu.org To: Gregory Heytings Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Fri Oct 09 00:48:09 2020 Return-path: Envelope-to: ged-emacs-devel@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 1kQehk-0009gV-Ft for ged-emacs-devel@m.gmane-mx.org; Fri, 09 Oct 2020 00:48:08 +0200 Original-Received: from localhost ([::1]:56446 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1kQehj-0006my-H2 for ged-emacs-devel@m.gmane-mx.org; Thu, 08 Oct 2020 18:48:07 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:44214) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1kQegz-0006MA-O4 for emacs-devel@gnu.org; Thu, 08 Oct 2020 18:47:21 -0400 Original-Received: from aserp2120.oracle.com ([141.146.126.78]:47246) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1kQegx-000774-GM; Thu, 08 Oct 2020 18:47:21 -0400 Original-Received: from pps.filterd (aserp2120.oracle.com [127.0.0.1]) by aserp2120.oracle.com (8.16.0.42/8.16.0.42) with SMTP id 098MixvX006700; Thu, 8 Oct 2020 22:47:14 GMT DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=oracle.com; h=mime-version : message-id : date : from : sender : to : cc : subject : references : in-reply-to : content-type : content-transfer-encoding; s=corp-2020-01-29; bh=R3z1aqkkQvDlyz0ECUDRBYGZ+R5wWGdEMojArxAtpqI=; b=ZTI4tUydNOZGemA7gEL/+oTzi5csh52SiAQ/qRIq/ydaHtMMBpuR/D8nnWXzve4jwK+J yac7lApbK6EVaigBF2j1nV7I4Ody9aQe3SqwPhk5DQ7NCpGBDtrmr7jzsXG5/UOoBh1b yOH+rLPETWKh4O6Yb8+c6dxTLRDjTRVN+B6GUkFhdgV5qJsgxwHWmX+FL7YpwTiNtGCp /31ZeO9JcWwMWVACZKg3+oSOeBZcJdurjo4srTnoE7ckPMkk9Hk8lwqyhzqX/DrJymcz FFwsKzCP7aSylvfbnenNvc8RpS8Lchp3eg2sRzzDf8atE+HQEgkseriZEXSf8QZ9DAQf QA== Original-Received: from aserp3030.oracle.com (aserp3030.oracle.com [141.146.126.71]) by aserp2120.oracle.com with ESMTP id 3429jurn5w-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=FAIL); Thu, 08 Oct 2020 22:47:14 +0000 Original-Received: from pps.filterd (aserp3030.oracle.com [127.0.0.1]) by aserp3030.oracle.com (8.16.0.42/8.16.0.42) with SMTP id 098MjNGx023830; Thu, 8 Oct 2020 22:47:14 GMT Original-Received: from userv0121.oracle.com (userv0121.oracle.com [156.151.31.72]) by aserp3030.oracle.com with ESMTP id 3429kk3k4g-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Thu, 08 Oct 2020 22:47:14 +0000 Original-Received: from abhmp0006.oracle.com (abhmp0006.oracle.com [141.146.116.12]) by userv0121.oracle.com (8.14.4/8.13.8) with ESMTP id 098MlCF0014645; Thu, 8 Oct 2020 22:47:12 GMT In-Reply-To: X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.9.1 (1003210) [OL 16.0.5056.0 (x86)] X-Proofpoint-Virus-Version: vendor=nai engine=6000 definitions=9768 signatures=668681 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 suspectscore=0 mlxlogscore=999 spamscore=0 adultscore=0 mlxscore=0 malwarescore=0 phishscore=0 bulkscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.12.0-2009150000 definitions=main-2010080160 X-Proofpoint-Virus-Version: vendor=nai engine=6000 definitions=9768 signatures=668681 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 adultscore=0 mlxlogscore=999 mlxscore=0 phishscore=0 bulkscore=0 suspectscore=0 lowpriorityscore=0 spamscore=0 clxscore=1015 malwarescore=0 priorityscore=1501 impostorscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.12.0-2009150000 definitions=main-2010080160 Received-SPF: pass client-ip=141.146.126.78; envelope-from=drew.adams@oracle.com; helo=aserp2120.oracle.com X-detected-operating-system: by eggs.gnu.org: First seen = 2020/10/08 16:41:05 X-ACL-Warn: Detected OS = Linux 3.1-3.10 [fuzzy] X-Spam_score_int: -43 X-Spam_score: -4.4 X-Spam_bar: ---- X-Spam_report: (-4.4 / 5.0 requ) BAYES_00=-1.9, DKIMWL_WL_HIGH=-0.001, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, RCVD_IN_DNSWL_MED=-2.3, RCVD_IN_MSPIKE_H2=-0.001, SPF_HELO_PASS=-0.001, SPF_PASS=-0.001 autolearn=ham autolearn_force=no X-Spam_action: no action X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.23 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Original-Sender: "Emacs-devel" Xref: news.gmane.io gmane.emacs.devel:257237 Archived-At: > > I see it generally. What do you see when you use `C-h f defcustom' or > > `C-h v print-circle? Don't you see links for each of the quoted (`...') > > functions and vars? >=20 > Yes, but not for the most important one: the function/variable/face... > being described, defcustom or print-circle in your examples. That one should be covered by an explicit sentence with a link to the manual. I already mentioned that (and said I do that in help-fns+.el). But even that one could be handled instead, or also, the same way. It's not quoted (`...'), but it's easy to find where it is and give it go-to-manual behavior. > >> Wouldn't a "See also chapter N ZZZZ in the Emacs manual." and/or "For > >> programmers, see also chapter N ZZZZ in the Emacs Lisp manual." (with > >> hyperlinks) at the end of ordinary help buffers be much more useful? > > > > For which symbols? Are you going to add such a see-also for each quote= d > > name in a `*Help*' buffer? >=20 > No, only for the main symbol, the symbol whose docstring is being > displayed in the help buffer. At least that was the meaning of the > proposal I sent a few hours ago: to add one (or more) link(s) at the end > of the docstring pointing to the chapter(s) of the manual(s) in which the= y > are documented. I already addressed that. > > I've long said that we need that for the thing that is the subject of > > the `*Help*' buffer. >=20 > Then I agree with you :-) >=20 > > And we do have it for some `*Help*' buffers - e.g., `C-h f defcustom'. >=20 > Thank you, this is an excellent example, it is exactly what I meant: a > link to the chapter of the manual. >=20 > > Inline (i.e., in-context) links are better, in general, than a pile of > > see-also's at the end of the buffer. >=20 > Not a pile, one or two. The point is to make manuals more accessible. Both would be useful: 1. Link(s) to manual(s) for the name that is the subject of the help. This can be in an explicit sentence that makes clear what it does - as mentioned earlier. 2. Links to manuals for each quoted, linked name in the buffer (or each known to be doc'd in a manual, if that's known when the buffer is created). For #2, such names already have inline links where they occur. It suffices to (1) give users an easy way to get to the manual(s) from that location, preferably by both mouse and key, and (2) let users know about this possibility. The usual way to let users know about possible actions at the mouse-pointer location is `help-echo': a tooltip or message in the echo area (depending on `tooltip-use-echo-area').