bug-texinfo
[Top][All Lists]
Advanced

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

Re: Texindex: Leave out \initial{x} if there's only one


From: Eli Zaretskii
Subject: Re: Texindex: Leave out \initial{x} if there's only one
Date: Thu, 28 Mar 2002 11:02:14 +0200

> Date: Wed, 27 Mar 2002 23:40:40 -0800
> From: Zack Weinberg <address@hidden>
> 
> > Also, if the number of directives is very small, why make them a
> > separate index?
> 
> As the author I feel it's useful to have an index that lists all the
> directives and nothing but the directives.

IMHO, multiple indices are annoying in general, and should be avoided.
In a printed manual, they make it harder to look up things if you
don't know whether you are looking for some specific kind of entity
(function, variable, directive, etc.), because the reader is forced to
search several lists instead of just one.

So multiple indices should IMHO be used only when they are long
enough to justify the split.

> It is not obvious from the table of contents which directives are
> described where.

Sorry, I don't follow: are you talking about the printed manual or the
on-line version?

If the latter, just typing "i ifdef RET" inside an Info reader will
take you to the place in the manual where #ifdef is described; no
need to look in the TOC or in the index.

If the former, indexing the directives like this:

   @findex ifdef @r{preprocessor directive}

(or something similar) will clearly show the reader that this is a
directive, even though the index is not limited to directives.

What am I missing?



reply via email to

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