On Mon, 7 Nov 2011, Jonathan Wakely wrote: > We currently have a broken link in the installation docs, see below. > I've tried to fix it, but on both Fedora 15 and Debian squeeze the > docs generated by "make html" do not match the online docs because of > a different version of makeinfo (4.13 versus 4.8 usedfor the online > docs). > > Can anyone with makeinfo 4.8 confirm that this fixes the broken anchor? > > Or should I just commit it as obvious and revert it if the regenerated > onlinedocs aren't fixed?
Jonathan, I am a bit confused because if I use the online documentation at http://gcc.gnu.org/install/specific.html the anchor is already of the form "sparc-sun-solaris210", that is, without the dot, and it works just fine. On the other hand, looking at the source code your patch has not been applied yet. Since your patch makes things just more conservative and robust, let's go ahead and apply it. Just, if there is something I missed, please advise. :-) As a bit of background, sadly at one point makeinfo added transformations for special characters to replace them by hex values weirdly encoded; that is the _002e you are seeing: hex 2E, the ASCII dot. For this reason I have this in wwwdocs/bin/preprocess that takes care of restorting dashes and asterisks (at the price of breaking links to external documents, since we can only fix up what is under our control): sed -e 's/_002d/-/g' -e 's/_002a/*/g' We might consider adding -e 's/_002e/./g', but really, just avoiding this altogether as your patch does, seems wiser. Thanks, Gerald
