From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED.blaine.gmane.org!not-for-mail From: Eli Zaretskii Newsgroups: gmane.emacs.devel Subject: Re: Predicate for true lists Date: Mon, 22 Apr 2019 09:39:41 +0300 Message-ID: <83imv68rwy.fsf@gnu.org> References: <87fu3vdjjk.fsf@tcd.ie> <2af892df-26cb-60b2-4fd8-067fcb3d32e9@cs.ucla.edu> <87r2kh9uwx.fsf@tcd.ie> <83h8lcnbxb.fsf@gnu.org> <87sh4s9poo.fsf@tcd.ie> <87k1q49p0i.fsf@tcd.ie> <87efgbbq2p.fsf@tcd.ie> <87a7gz8hp2.fsf@tcd.ie> <875zrn9bum.fsf@tcd.ie> <835zrm7fow.fsf@gnu.org> <878swivtcr.fsf@gmail.com> <87r2aayln2.fsf@tcd.ie> <87lg0hyidf.fsf@tcd.ie> <87tvew7bxj.fsf@tcd.ie> <83a7gne5w8.fsf@gnu.org> <87h8argqhu.fsf@tcd.ie> <83r29v87sz.fsf@gnu.org> <87imv76nos.fsf@tcd.ie> Injection-Info: blaine.gmane.org; posting-host="blaine.gmane.org:195.159.176.226"; logging-data="145570"; mail-complaints-to="usenet@blaine.gmane.org" Cc: branham@utexas.edu, monnier@iro.umontreal.ca, drew.adams@oracle.com, emacs-devel@gnu.org To: "Basil L. Contovounesios" Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Mon Apr 22 08:40:42 2019 Return-path: Envelope-to: ged-emacs-devel@m.gmane.org Original-Received: from lists.gnu.org ([209.51.188.17]) by blaine.gmane.org with esmtps (TLS1.0:RSA_AES_256_CBC_SHA1:256) (Exim 4.89) (envelope-from ) id 1hISd8-000bkD-Il for ged-emacs-devel@m.gmane.org; Mon, 22 Apr 2019 08:40:42 +0200 Original-Received: from localhost ([127.0.0.1]:33152 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1hISd7-0000RH-JV for ged-emacs-devel@m.gmane.org; Mon, 22 Apr 2019 02:40:41 -0400 Original-Received: from eggs.gnu.org ([209.51.188.92]:53658) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1hIScR-0000R7-3D for emacs-devel@gnu.org; Mon, 22 Apr 2019 02:40:00 -0400 Original-Received: from fencepost.gnu.org ([2001:470:142:3::e]:36189) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1hIScM-0003cI-3k; Mon, 22 Apr 2019 02:39:57 -0400 Original-Received: from [176.228.60.248] (port=2142 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_256_CBC_SHA1:256) (Exim 4.82) (envelope-from ) id 1hIScJ-0006ED-6J; Mon, 22 Apr 2019 02:39:52 -0400 In-reply-to: <87imv76nos.fsf@tcd.ie> (contovob@tcd.ie) X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.21 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" Xref: news.gmane.org gmane.emacs.devel:235753 Archived-At: > From: "Basil L. Contovounesios" > Cc: , , , > Date: Sun, 21 Apr 2019 22:41:39 +0100 > > > Each time you write @cindex (or @findex, or @vindex, or ...), the > > entry you wrote is added to the Index, and it points to the place > > where you wrote the above. > > I understood this, but thought that every section relevant to some key > should be indexed by that key, not just the section which defines it. > I understand now that this is not the case. This is not the case. The index entry should point to the place where the subject is described and discussed in its fullest. If there are certain specific aspects of the subject whose description is elsewhere (e.g., because it would be out of place or inappropriate as part of the main description, perhaps because some missing context), then add qualified index entries that point to those other places, as in @cindex foo -- the main index entry @cindex foo, and bar -- index entry for discussion of foo in context of bar Here are two real-life examples of the latter: @cindex display property, and point display @cindex display property, unsafe evaluation Thanks.