emacs-devel
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: Predicate for true lists


From: Basil L. Contovounesios
Subject: Re: Predicate for true lists
Date: Mon, 22 Apr 2019 13:58:01 +0100
User-agent: Gnus/5.13 (Gnus v5.13) Emacs/27.0.50 (gnu/linux)

Eli Zaretskii <address@hidden> writes:

>> 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

Makes sense, thanks for explaining.

-- 
Basil



reply via email to

[Prev in Thread] Current Thread [Next in Thread]