Gerald Pfeifer wrote:
Okay, so I applied this patch plus the one below to adjust
gcc-4.9/changes.html accordingly. (The first anchor there
is not stable, but for other reasons.)
But it should be sufficient to check them before the release and then
one is fine as the links should refer to the released versions per
item13 of http://gcc.gnu.org/releasing.html (that's why I proposed to
add that item).
Talking about links like
http://gcc.gnu.org/onlinedocs/gcc/Language-Independent-Options.html#index-fdiagnostics-color-246
What I always disliked that it doesn't linke to the @item
"|-fdiagnostics-color[=WHEN]" but to the first paragraph after the
@item. That makes somewhat sense if one looks at the source code:
@item -fdiagnostics-color[=@var{WHEN}]
@itemx -fno-diagnostics-color
@opindex fdiagnostics-color
@cindex highlight, color, colour
@vindex GCC_COLORS @r{environment variable}
Use color ...
Actually, it also makes sense if one reads the texi doc,
http://www.gnu.org/software/texinfo/manual/texinfo/texinfo.html#Index-Entries
: "||Index entries should precede the visible material that is being
indexed. [...] ||Among other reasons, that way following indexing links
(in whatever context) ends up before the material, where readers want to
be, instead of after."
Thus, it seems as we should go through all of GCC's *texi files and swap
the order of @item and @*index.
Tobias
|