Re: Predicate for true lists

["Basil L. Contovounesios" <contovob@tcd.ie>]

Eli Zaretskii <eliz@gnu.org> writes:

>> From: "Basil L. Contovounesios" <contovob@tcd.ie>
>> Cc: <drew.adams@oracle.com>,  <branham@utexas.edu>,  <monnier@iro.umontreal.ca>,  <emacs-devel@gnu.org>
>> 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

Makes sense, thanks for explaining.

-- 
Basil