From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Drew Adams Newsgroups: gmane.emacs.devel Subject: RE: Changes in revision 114466 Date: Tue, 1 Oct 2013 00:44:33 -0700 (PDT) Message-ID: References: <831u49fkxk.fsf@gnu.org> <83pprse4mf.fsf@gnu.org> <87r4c5egfj.fsf@uwakimon.sk.tsukuba.ac.jp> <87ob79ed1l.fsf@uwakimon.sk.tsukuba.ac.jp> NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable X-Trace: ger.gmane.org 1380613497 17769 80.91.229.3 (1 Oct 2013 07:44:57 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Tue, 1 Oct 2013 07:44:57 +0000 (UTC) Cc: emacs-devel To: "Stephen J. Turnbull" Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Tue Oct 01 09:44:59 2013 Return-path: Envelope-to: ged-emacs-devel@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by plane.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1VQudd-0006Wl-5t for ged-emacs-devel@m.gmane.org; Tue, 01 Oct 2013 09:44:57 +0200 Original-Received: from localhost ([::1]:53243 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1VQudc-0007B2-SR for ged-emacs-devel@m.gmane.org; Tue, 01 Oct 2013 03:44:56 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:59101) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1VQudS-0007At-Ov for emacs-devel@gnu.org; Tue, 01 Oct 2013 03:44:55 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1VQudK-0003eV-5E for emacs-devel@gnu.org; Tue, 01 Oct 2013 03:44:46 -0400 Original-Received: from userp1040.oracle.com ([156.151.31.81]:33195) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1VQudJ-0003eJ-UR for emacs-devel@gnu.org; Tue, 01 Oct 2013 03:44:38 -0400 Original-Received: from ucsinet21.oracle.com (ucsinet21.oracle.com [156.151.31.93]) by userp1040.oracle.com (Sentrion-MTA-4.3.1/Sentrion-MTA-4.3.1) with ESMTP id r917iZwg025303 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK); Tue, 1 Oct 2013 07:44:36 GMT Original-Received: from aserz7021.oracle.com (aserz7021.oracle.com [141.146.126.230]) by ucsinet21.oracle.com (8.14.4+Sun/8.14.4) with ESMTP id r917iYvr019763 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO); Tue, 1 Oct 2013 07:44:35 GMT Original-Received: from abhmt110.oracle.com (abhmt110.oracle.com [141.146.116.62]) by aserz7021.oracle.com (8.14.4+Sun/8.14.4) with ESMTP id r917iYsr014763; Tue, 1 Oct 2013 07:44:34 GMT In-Reply-To: <87ob79ed1l.fsf@uwakimon.sk.tsukuba.ac.jp> X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.8 (707110) [OL 12.0.6680.5000 (x86)] X-Source-IP: ucsinet21.oracle.com [156.151.31.93] X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.4.x-2.6.x [generic] X-Received-From: 156.151.31.81 X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.14 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.org@gnu.org Original-Sender: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.devel:163766 Archived-At: > > But users are not necessarily aware of it. >=20 > Isn't that what should be fixed, then? 1) How? 2) It's still good to provide a visual cue that a given term is in the manual. > > It would be good to provide explicit (visible) links for some symbols > > in some doc strings. >=20 > Which ones and which ones? =20 It would be a matter of judgment, case by case. Unless you decide that every (documented) symbol gets a link programmatically, which might be too busy visually. Would it be only symbols enclosed in `...' (yes)? Some of those are already linked to other *Help* entries, of course. Maybe such links to the manual should be distinguished visually from links within *Help*. We do have links to source files, which appear the same as links within *Help*. But if we start adding lots of links to the manuals for defined symbols then it might help to tell the difference from links within *Help*. Maybe distinguish links to the manuals using :underline with style `wave'? Maybe use that for any link (e.g. source file target) that leaves *Help*? > And why is that better (or easier to achieve) than having access > for all symbols in all docstrings at the user's option? Doing it automatically is no doubt easier, not harder, than doing it using judgment case by case. At the user's option sounds good. Systematically might be too much for some people.