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.
