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:36:09 -0700 (PDT) Message-ID: <1aef473c-c2de-4257-a187-3bd580e01834@default> References: <20200926163008.GS1349@protected.rcdrun.com> <83blhc7f4x.fsf@gnu.org> <673405e1-0df4-4655-a5e6-4551f2565e91@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="2542"; mail-complaints-to="usenet@ciao.gmane.io" Cc: bobnewell@bobnewell.net, rms@gnu.org, rpluim@gmail.com, emacs-devel@gnu.org, joaotavora@gmail.com, ghe@sdf.org, Eli Zaretskii , =?iso-8859-1?B?RGFuaWVsIE1hcnTtbg==?= To: Stefan Monnier Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Fri Oct 09 00:39:57 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 1kQeZp-0000Vq-Tq for ged-emacs-devel@m.gmane-mx.org; Fri, 09 Oct 2020 00:39:57 +0200 Original-Received: from localhost ([::1]:51704 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1kQeZo-0004NJ-Qh for ged-emacs-devel@m.gmane-mx.org; Thu, 08 Oct 2020 18:39:56 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:41922) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1kQeYE-0003vL-Es for emacs-devel@gnu.org; Thu, 08 Oct 2020 18:38:19 -0400 Original-Received: from aserp2120.oracle.com ([141.146.126.78]:40166) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1kQeYB-0005n1-Fx; Thu, 08 Oct 2020 18:38:17 -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 098MYwbL179530; Thu, 8 Oct 2020 22:38:11 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=p44Sfm+AJvHAYddDzGB/9694SyPSN0xpRVogC2MTRQo=; b=j+EImQwc3ZjsUWahY5Bkoyt17dpCpyrNRXyy0qeHJzef9hoH0Pr8qipOyjZlC8O9Gz6G jE5BaMphSsrF6l65sC+AbqP7/5E01aP4W42UtfqplxvXQBy/q+gpEsdPAaIv/PKLqQ6Q 8q9cZuyAfat11ZIEwhKZphnSNrQ0XpwjUUjQEPsrYc+BHMZARTWZju6R5f5Wei9Z3ZXU rHb4WLgYDQOYl+sYAhXNc3i95C1yfQyyXHwlDlo3neEYdMMJJ+QY8soAatd5l0vF83+p 2sQg1UkQ8bNlyT/N1KdZVNO6qaj/Rg0R7zFX9/bOnenVc3B/55K/Ps8E2+cr4C+ZFdod QQ== Original-Received: from aserp3020.oracle.com (aserp3020.oracle.com [141.146.126.70]) by aserp2120.oracle.com with ESMTP id 3429jurmev-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=FAIL); Thu, 08 Oct 2020 22:38:11 +0000 Original-Received: from pps.filterd (aserp3020.oracle.com [127.0.0.1]) by aserp3020.oracle.com (8.16.0.42/8.16.0.42) with SMTP id 098MYw7Y183133; Thu, 8 Oct 2020 22:36:11 GMT Original-Received: from aserv0121.oracle.com (aserv0121.oracle.com [141.146.126.235]) by aserp3020.oracle.com with ESMTP id 3429kakeqf-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Thu, 08 Oct 2020 22:36:11 +0000 Original-Received: from abhmp0006.oracle.com (abhmp0006.oracle.com [141.146.116.12]) by aserv0121.oracle.com (8.14.4/8.13.8) with ESMTP id 098MaAdk011454; Thu, 8 Oct 2020 22:36:10 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 adultscore=0 phishscore=0 spamscore=0 mlxscore=0 malwarescore=0 bulkscore=0 mlxlogscore=999 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.12.0-2009150000 definitions=main-2010080158 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-2010080158 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:257235 Archived-At: > >> I think something like: > >> > >> Also documented in the >Emacs user's manual<. > >> Also documented in the >ELisp programmer's reference<. > >> > >> should be clear enough (where >...< is meant to delimit the hyperlink)= . > > > > That won't help with functions (vars, faces, etc.) > > covered in other manuals: CL, Tramp, Org, Dired-X, > > Calc, Ediff, etc. >=20 > Why not? I'd expect them to appear as things like: > Also documented in >Calc's manual<. I meant that it won't help now (as is, with `Info-lookup'). Yes, links to such manuals would help. But if we are going to do this for more, or all, names referred to in *Help*, and not just for the name that's the subject of the *Help*, then "Also documented in..." would become a real drag. Instead, we should let you get to the info in a manual from the occurrence of the name itself in the buffer, just as we now do with a link to its own *Help*. That is, do it only for quoted (`...'), linked names. The same link can't go to two different places when you use the same key (e.g. `mouse-1' or `RET'). But it can go to a different place (or places) if we provide more bindings at that location. E.g., bind `C-h mouse-1' to do it. (And `C-h S RET' with point on the link already does it.) Change the `help-echo' to indicate this go-to-manual behavior. Do that and there's no need for umpteen "Also documented in..." additions to the buffer. The links are already there, in context, for each recognized name. (If we can easily/quickly tell whether a given linked name `...' is documented in a manual then we can also omit any `help-echo' about checking the manual for it when there's no manual that covers it.)