From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED!not-for-mail From: Drew Adams Newsgroups: gmane.emacs.help Subject: RE: Path of tool-bar icons Date: Wed, 11 Apr 2018 15:23:45 -0700 (PDT) Message-ID: <0e2cbbd3-d5d6-4c60-baea-6f475ad4cf9c@default> References: <83h8oh3dp4.fsf@gnu.org> <864lkhfpgs.fsf@zoho.com> <20180411205539.GE26644@tuxteam.de> <86vacxe75d.fsf@zoho.com> NNTP-Posting-Host: blaine.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: quoted-printable X-Trace: blaine.gmane.org 1523485339 15516 195.159.176.226 (11 Apr 2018 22:22:19 GMT) X-Complaints-To: usenet@blaine.gmane.org NNTP-Posting-Date: Wed, 11 Apr 2018 22:22:19 +0000 (UTC) To: Emanuel Berg , help-gnu-emacs@gnu.org Original-X-From: help-gnu-emacs-bounces+geh-help-gnu-emacs=m.gmane.org@gnu.org Thu Apr 12 00:22:15 2018 Return-path: Envelope-to: geh-help-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by blaine.gmane.org with esmtp (Exim 4.84_2) (envelope-from ) id 1f6O86-0003tp-Up for geh-help-gnu-emacs@m.gmane.org; Thu, 12 Apr 2018 00:22:15 +0200 Original-Received: from localhost ([::1]:34789 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1f6OAC-0000AC-32 for geh-help-gnu-emacs@m.gmane.org; Wed, 11 Apr 2018 18:24:24 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:48026) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1f6O9g-00008r-H5 for help-gnu-emacs@gnu.org; Wed, 11 Apr 2018 18:23:53 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1f6O9d-0006ag-CS for help-gnu-emacs@gnu.org; Wed, 11 Apr 2018 18:23:52 -0400 Original-Received: from aserp2120.oracle.com ([141.146.126.78]:58950) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1f6O9d-0006aE-4M for help-gnu-emacs@gnu.org; Wed, 11 Apr 2018 18:23:49 -0400 Original-Received: from pps.filterd (aserp2120.oracle.com [127.0.0.1]) by aserp2120.oracle.com (8.16.0.22/8.16.0.22) with SMTP id w3BMLqtg145018; Wed, 11 Apr 2018 22:23:48 GMT DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=oracle.com; h=mime-version : message-id : date : from : sender : to : subject : references : in-reply-to : content-type : content-transfer-encoding; s=corp-2017-10-26; bh=PLEVoQ2fbujUCqRpk8iD0dy89iPh0f3zSVDvdc1xUEo=; b=lEFlVVc6HWPyUu/0LpV1PXvGYUXR/mZsxqq/pPeZY9/386TU9BU0x2FDOCHhuIse+7z/ Ui9xbrXpxSSHCmtYXjkR00OUOk1F444XNmOo3IKf/v3XDHU/JyJGDEUYxgWPMIshDHld n8AIImmSjsSw7/raliVNBCJAH1qJz6wFPIFal5anPzQMqLzpCTCerp8KuOKfAE6vwdh6 w66uAPxvfBqLOvv+0yI68wZfqdHkBUdB4QIlA35QEo3j/alVgGloxywnWsE2OmPkZ3bq vBjabKUoPqC6tuNZLIpwJVRed6RSo3lZbJhs36pWzBc3VSy3xBk6zEWvlYrWebN4Cuw4 cw== Original-Received: from aserv0021.oracle.com (aserv0021.oracle.com [141.146.126.233]) by aserp2120.oracle.com with ESMTP id 2h6ny3hd5e-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Wed, 11 Apr 2018 22:23:48 +0000 Original-Received: from aserv0122.oracle.com (aserv0122.oracle.com [141.146.126.236]) by aserv0021.oracle.com (8.14.4/8.14.4) with ESMTP id w3BMNlpd020473 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Wed, 11 Apr 2018 22:23:47 GMT Original-Received: from abhmp0003.oracle.com (abhmp0003.oracle.com [141.146.116.9]) by aserv0122.oracle.com (8.14.4/8.14.4) with ESMTP id w3BMNk5B003457; Wed, 11 Apr 2018 22:23:47 GMT In-Reply-To: <86vacxe75d.fsf@zoho.com> X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.9.1 (1003210) [OL 16.0.4678.0 (x86)] X-Proofpoint-Virus-Version: vendor=nai engine=5900 definitions=8860 signatures=668698 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 suspectscore=0 malwarescore=0 phishscore=0 bulkscore=0 spamscore=0 mlxscore=0 mlxlogscore=999 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1711220000 definitions=main-1804110208 X-detected-operating-system: by eggs.gnu.org: GNU/Linux 3.x [generic] [fuzzy] X-Received-From: 141.146.126.78 X-BeenThere: help-gnu-emacs@gnu.org X-Mailman-Version: 2.1.21 Precedence: list List-Id: Users list for the GNU Emacs text editor List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: help-gnu-emacs-bounces+geh-help-gnu-emacs=m.gmane.org@gnu.org Original-Sender: "help-gnu-emacs" Xref: news.gmane.org gmane.emacs.help:116480 Archived-At: > > > expects: "image"> > > [...] > > 1. `C-h r' > > > > `i glossary' > > (or `g glossary', if you know there is a node > > named Glossary) >=20 > So ? 1. My point was that if someone really thinks that some Emacs users will think only "icon" and never "image" in this context, and it is a sufficiently important problem, they can ask that the two terms be added to the glossary and linked there. Emacs jargon uses "yank", but newbies can find it under "paste" in the glossary. (Personally, I can't imagine not thinking of looking for "image" if I didn't find what I was looking for under "icon". But users look for things differently, and users have different vocabularies and mental models.) Even without bringing the glossary into it (and this is a case where the glossary is not really relevant, I think - "image" is not really Emacs jargon), you could request an _index_ entry for "icon" that links to where `image-load-path' is discussed. 2. But that variable is covered only in the Elisp manual, not the Emacs manual. There is an index entry for it, but index entries that contain substring "icon" don't lead there. So if someone thought this was a real discovery problem s?he could request an index entry in the Elisp manual for "icon file locations" or some such, which would take you to the same node (`Defining Images'). 3. But it is true that if something is not in one of the manuals then there is no equivalent of indexing or a glossary. (But you can google or search Emacs Wiki.) You can search doc strings or use apropos commands, including `apropos-documentation', but that just searches doc strings literally. It doesn't take advantage of someone having created an explicit link (xref) between "icon" and "image".