Re: Predicate for true lists

[Eli Zaretskii]

> From: "Basil L. Contovounesios" <address@hidden>
> Cc: <address@hidden>,  <address@hidden>,  <address@hidden>,  <address@hidden>
> 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.