Bugzilla Bug 194789

The documentation is almost unusable because of all the missing links.

Reproducible: Always

Steps to Reproduce:
1. Execute "emerge -u linkchecker boost".
2. Execute "linkchecker --ignore-url=^http: --no-warnings
/usr/share/doc/boost-1.33.1-r1/html"
Actual Results:  
Plenty of errors, here is the summary:
That's it. 40406 links checked. 12137 warnings found. 2935 errors found.

I have now unmasked dev-libs/boost-1.34.1, emerged it and executed linkchecker
on it. There are still problems. Summary:
That's it. 76774 links checked. 11399 warnings found. 4322 errors found.

Well, I can browse the documention here, except for the boost-logo which
doesn't get displayed.
Can you please be more specific?

Have you tried the steps to reproduce it? linkchecker shows plenty of errors.
What does it show for you?

Well, I don't care what the linkchecker says. I only care whether I can browse
the docs and whether I can read up the infos for the header-files/classes, etc.
And this works.

Linkchecker is a tool that reports broken links, which prevent browsing. If an
image link is broken, the browser will show a special icon indicating this (and
show a text that can be given in the alt="text" part of the image link) instead
of showing the intended image. If a normal link is broken, the user will not
get to the intended page. Instead he will see a page with an error message.
None of this should happen. So you should care about what linkchecker says. You
already mentioned that a logo was missing. That is one of the problems that
linkchecker reports.

I tried to read the documentation for boost-1.33.1-r1 and half of the
documentation was just missing. Therefore I installed linkckecker to analyze
the problem and reported it. Then I unmasked boost-1.34 and discovered that it
is indeed much better. But there are still broken links. If only boost.png was
added, many of the reported problems would vanish. There are also very many
broken links to [file:///usr/share/doc/boost-1.34.1/html/LICENSE_1_0.txt]. Then
it seems like all the links to source files are broken as well. Just look at
for example [/usr/share/doc/boost-1.34.1/html/libs/format/index.html], which
links to for example
[file:///usr/share/doc/boost-1.34.1/html/boost/format/format_fwd.hpp], which
does not exist. I suppose the link should be changed to point to
[file:///usr/include/boost/format/format_fwd.hpp] instead.

So if you care to fix this, add boost.png, LICENSE_1_0.txt and fix the links to
source files. Then use linkchecker to make sure there are no other problems
left. Then release the new version and remove the old versions with broken
documentation.

Ok, all link-errors fixed besides the ones pointing to boost-build,
regression-tests and examples.

Cheers.