[Top][All Lists]
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: Index entries leading to @seealso
From: |
Patrick McCarty |
Subject: |
Re: Index entries leading to @seealso |
Date: |
Tue, 21 Oct 2008 16:36:26 -0700 |
Hi Trevor,
On Tue, Oct 21, 2008 at 3:20 PM, Trevor Daniels <address@hidden> wrote:
> I've just noticed that there are many entries in the index to the Notation
> Reference which lead you to the @seealso sections. It seems that the @r..{}
> macros generate index entries automatically. But these entries are pretty
> useless as they take to the place where the reference is made, rather than
> the place being referenced. For example, look at the entries for
> "fingering".
>
> Should this be classified as a documentation bug?
I would consider this a bug. Since the index entries for the main
docs jump straight to correct position on the page, additional entries
for the @r... in @seealso aren't as useful IMO. In addition, many of
the @seealso links are duplicated in the main docs, so these index
entries are redundant.
-Patrick