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
|

Reply via email to