Re: Index in gdb.texinfo

[Eli Zaretskii <eliz at delorie dot com>]

Date: Mon, 17 Apr 2000 22:23:12 +0400 (MSD)
From: Dmitry Sivachenko <dima@Chg.RU>

>    > We have 'complete (@key{TAB})' in Readline chapter.
>    > I thought we should markup RET in a similar manner.
> 
>    Then how about including the command name, or a virtual command
>    name like "repeat (@key{RET})"?
> 
> Sounds good for me.

Based on discussions with Stan by private mail, I intend to change all
of the commands in the way Stan suggested above.  So RET will get the
same treatment.

I just need the thumbs-up from Stan to make this and other changes we
talked about, to get this done.  Most of the changes are already ready
on my disk.

> In the translated version of manual it is better to have translated
> part of Index separated from untranslated (command, functions, etc.)

This is an issue that no GNU manual currently handles correctly.  The
main problem is the sorting order, AFAIK, but a plethora of other
issues pop up as well.

You can easily separate the indices if you comment away the
@syncodeindex directives at the beginning of gdb.texinfo.

Sorting the entries will also effectively separate translated and
untranslated entries.

But by and large, this issue was not attacked by Texinfo yet.  You
could say that non-ASCII support in Texinfo is nothing more than a
kludgey hack, unfortunately.  I don't think we should expect GDB to
solve this ;-)

However, I do suggest to take these issues up with bug-texinfo mailing
list.  I think those who work on Texinfo should at least be aware of
the problem, if not start working on solutions.