[Bug web/107651] Having two different kind of indexes is very useful still

["pinskia at gcc dot gnu.org" <gcc-bugzilla@gcc.gnu.org>]

https://gcc.gnu.org/bugzilla/show_bug.cgi?id=107651

--- Comment #11 from Andrew Pinski <pinskia at gcc dot gnu.org> ---
(In reply to Martin Liška from comment #10)
> > But the sphinx generated index is not very useful as it lists all options
> > under symbols heading which is very confusing to programmers.
> 
> It's a minor limitation, one can still jump to individual listings of
> options:
> https://gcc.gnu.org/onlinedocs/gcc/gcc-command-options.html

That is a TOC and NOT an index.
IT IS NOT A MINOR LIMITATION.
Compare this to the texinfo generated one:
https://gcc.gnu.org/onlinedocs/gcc-12.1.0/gcc/Option-Index.html

(yes the f and m is still combined)
But the - is ignored.
Plus the layout of the index is better.
The two parrallel columns of the sphinx generated index is also bad because the
order is first column then the second which means scrolling back up for the
wrapping. IS there a way to fix that?

Plus when I saw symbol I was thinking function/variable name and not -,&,etc.
The texinfo generated index splits out the symbols even which seems like sphinx
should be able to do too which will improve the look slightly.

Searching is not just about knowing keywords but looking into similar named
things which is another reason why the two column for the generated index is
bad idea.