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:21:06 -0700 (PDT) Message-ID: 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="9033"; 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:22:28 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 1kQeIu-0002FO-3L for ged-emacs-devel@m.gmane-mx.org; Fri, 09 Oct 2020 00:22:28 +0200 Original-Received: from localhost ([::1]:45726 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1kQeIs-0000hy-RK for ged-emacs-devel@m.gmane-mx.org; Thu, 08 Oct 2020 18:22:26 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:37730) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1kQeHk-0008VC-Ul for emacs-devel@gnu.org; Thu, 08 Oct 2020 18:21:17 -0400 Original-Received: from userp2120.oracle.com ([156.151.31.85]:50798) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1kQeHh-0003UZ-3V; Thu, 08 Oct 2020 18:21:16 -0400 Original-Received: from pps.filterd (userp2120.oracle.com [127.0.0.1]) by userp2120.oracle.com (8.16.0.42/8.16.0.42) with SMTP id 098MJWWn055683; Thu, 8 Oct 2020 22:21:09 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=5nmJOVAvu0FHlHIvYqmaOi2Neo7FVjSq39xg056M4I0=; b=EuLoRwVUTyAD3INr8IF/RHfeIosEpV3SWNH8dY3waCYAIfzyWFXFV9Pn+ldrTRmHh1Ep 6w8OmSJMnhsOsQryq8ICrqWMZ5KwKYyFGoT178T1goabiD09SRmGOBmPxKzbjCDd4NZQ tcOYC+QnjQzPWxHXrWV0NBTbKkuiHIvGq1hr56pkmdiQNFWiCf2RpjG9BUOaI+2YlA84 TRqWnQBt90Vqm5zn1M1mM6iN7WVR+wsjIoOJkBO6ntzajD2gQodY4o9k9hVVAuvc8XCu GCTpdWijMAVMpHzOr3SYYPxuoCStv5K6k9WZ+z/Uwem24yHu3smrhKiIxgWR2vkX7vmX ow== Original-Received: from userp3020.oracle.com (userp3020.oracle.com [156.151.31.79]) by userp2120.oracle.com with ESMTP id 3429jmgjt1-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=FAIL); Thu, 08 Oct 2020 22:21:09 +0000 Original-Received: from pps.filterd (userp3020.oracle.com [127.0.0.1]) by userp3020.oracle.com (8.16.0.42/8.16.0.42) with SMTP id 098MFN1C126379; Thu, 8 Oct 2020 22:21:08 GMT Original-Received: from aserv0121.oracle.com (aserv0121.oracle.com [141.146.126.235]) by userp3020.oracle.com with ESMTP id 3429khkgcg-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Thu, 08 Oct 2020 22:21:08 +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 098ML7cd005250; Thu, 8 Oct 2020 22:21:07 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 spamscore=0 malwarescore=0 mlxlogscore=901 suspectscore=0 mlxscore=0 adultscore=0 bulkscore=0 phishscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.12.0-2009150000 definitions=main-2010080155 X-Proofpoint-Virus-Version: vendor=nai engine=6000 definitions=9768 signatures=668681 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 adultscore=0 spamscore=0 suspectscore=0 clxscore=1015 phishscore=0 lowpriorityscore=0 impostorscore=0 malwarescore=0 mlxlogscore=906 priorityscore=1501 mlxscore=0 bulkscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.12.0-2009150000 definitions=main-2010080155 Received-SPF: pass client-ip=156.151.31.85; envelope-from=drew.adams@oracle.com; helo=userp2120.oracle.com X-detected-operating-system: by eggs.gnu.org: First seen = 2020/10/08 16:39:50 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:257233 Archived-At: > >> C-h f kill-line > >> put point somewhere on 'kill-line' in the docstring > >> C-h S > >> > >> Now making that more widely known would help, I think. > > > > Yes. A start is to what I do in `help-mode+.el': change the help-echo > > on a linked symbol, so it includes mention of `C-h S'. This trivial > > change could be made to `help-mode.el'. > > > > IOW, instead of just > > "mouse-2, RET: describe this symbol" > > say: > > "mouse-2, RET: describe, C-h S RET: check manual" >=20 > This help-echo is not present in all help buffers, I see it only in C-h m > (describe-mode) buffers. 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? > And it is necessary to put point on the symbol > before pressing C-h S RET. If that's considered a big hurdle then we can add a mouse binding for it on such links. > 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 quoted name in a `*Help*' buffer? In general, that's what `C-h S' works on: each such name. That is, we generally put links on the names that `C-h S' will work for. > I can only speak for myself, but this is what I > would have found useful when I started using Emacs. I've long said that we need that for the thing that is the subject of the `*Help*' buffer. And we do have it for some `*Help*' buffers - e.g., `C-h f defcustom'. But I don't think it makes sense to add that for each quoted name that has a help link. Inline (i.e., in-context) links are better, in general, than a pile of see-also's at the end of the buffer. And we already have such links for recognized quoted names. What's missing is providing more info, or additional navigation possibilities, for such names.