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: C-h r and Images Date: Tue, 3 Sep 2013 09:34:51 -0700 (PDT) Message-ID: <0b0e7cc8-6de6-446e-88fe-6b332c1e63b5@default> References: <<87y57fe2ej.fsf@gmail.com>> <<831u57e089.fsf@gnu.org>> <<5224AEB3.5000508@cs.ucla.edu>> <<878uzf5dvr.fsf@gmail.com>> <<50869c34-8cb2-477b-a6a8-a393abb76d12@default>> <> <<83ioyhdhg7.fsf@gnu.org>> NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: quoted-printable X-Trace: ger.gmane.org 1378226181 13026 80.91.229.3 (3 Sep 2013 16:36:21 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Tue, 3 Sep 2013 16:36:21 +0000 (UTC) Cc: eggert@cs.ucla.edu, kjambunathan@gmail.com, emacs-devel@gnu.org To: Eli Zaretskii , Xue Fuqiao Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Tue Sep 03 18:36:22 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 1VGtaR-00024M-Ls for ged-emacs-devel@m.gmane.org; Tue, 03 Sep 2013 18:36:15 +0200 Original-Received: from localhost ([::1]:47543 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1VGtaR-0008Kx-Ap for ged-emacs-devel@m.gmane.org; Tue, 03 Sep 2013 12:36:15 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:36389) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1VGtaF-0008Bp-RX for emacs-devel@gnu.org; Tue, 03 Sep 2013 12:36:12 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1VGtZw-0000EL-Nh for emacs-devel@gnu.org; Tue, 03 Sep 2013 12:36:03 -0400 Original-Received: from userp1040.oracle.com ([156.151.31.81]:40091) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1VGtZH-0008I6-12; Tue, 03 Sep 2013 12:35:03 -0400 Original-Received: from acsinet21.oracle.com (acsinet21.oracle.com [141.146.126.237]) by userp1040.oracle.com (Sentrion-MTA-4.3.1/Sentrion-MTA-4.3.1) with ESMTP id r83GYqoj020056 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK); Tue, 3 Sep 2013 16:34:53 GMT Original-Received: from aserz7022.oracle.com (aserz7022.oracle.com [141.146.126.231]) by acsinet21.oracle.com (8.14.4+Sun/8.14.4) with ESMTP id r83GYqnR013090 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO); Tue, 3 Sep 2013 16:34:52 GMT Original-Received: from abhmt119.oracle.com (abhmt119.oracle.com [141.146.116.71]) by aserz7022.oracle.com (8.14.4+Sun/8.14.4) with ESMTP id r83GYpdY007991; Tue, 3 Sep 2013 16:34:51 GMT In-Reply-To: <<83ioyhdhg7.fsf@gnu.org>> X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.8 (707110) [OL 12.0.6680.5000 (x86)] X-Source-IP: acsinet21.oracle.com [141.146.126.237] 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:163170 Archived-At: > > > What's more, it would be helpful to hyperlink directly to an explanat= ion > > > of the term in question, rather than just saying "which see" or some > > > such English alternative to "q.v." > > > > I made a patch for it. See bug#15254. >=20 > Thanks. However, I'm not sure doing this is useful. The Glossary is > a long series of short paragraphs, each one explaining one term. What > your patch does is add a cross-reference to many of these short > paragraphs, which makes those paragraphs longer and more complex to > read and grasp at first glance. OTOH, since the terms are listed in > alphabetic order, it is quite easy to find a given term, even if you > just scroll and don't use the search commands. >=20 > So my take of this is that on balance this is not useful. I haven't looked at the patch itself. But the idea should be, if possible, to have inline xrefs (links). That is, not add any extra text (e.g. "See"), but just turn the term used in the text into a link to its own definition. That's pretty common in glossaries these days (and in indexes, when referring to another index entry). And yes, it's a lot easier to click (or hit `RET' on) a term to look at its definition, and then click `Back' (or hit `l') to get back to where you were, than it is to scroll down to find its definition and then scroll back and find where you were. Now, if it is not possible today to have inline xrefs in Info then that's too bad. Then it's a tradeoff: Is the convenience of direct access worth the extra verbage ("See" or whatever) added?