[boost] [build] Broken doc links

Subject: [boost] [build] Broken doc links
From: Gavin Lambert (gavinl_at_[hidden])
Date: 2018-04-10 05:27:37

Prompted by the thread "Toolset version for Visual Studio 2017 15.6.3" 
over in the user list, I was looking through some Boost.Build 
documentation when I found some dead links and other weirdness.

Boost.Build's github page links to https://www.boost.org/build/, which 
appears to be fully working.

On 
https://www.boost.org/doc/libs/1_66_0/more/getting_started/windows.html, 
under "5.2.1 Install Boost.Build" it links to 
https://www.boost.org/doc/libs/1_66_0/tools/build/index.html, which 
appears to be a versioned clone of the above.

But at that page, the "Documentation" link points at 
https://www.boost.org/doc/libs/1_66_0/tools/build/doc/html/index.html, 
which 404s.

Back in "Getting Started", in "5.2.2 Identify Your Toolset" it first 
links directly to 
https://www.boost.org/build/doc/html/bbv2/reference/tools.html (which is 
now an unversioned link, but does work), and then to 
https://www.boost.org/doc/libs/1_66_0/doc/html/bbv2/installation.html 
(which is a versioned link that also works).

So it's not very consistent.

Putting these things together, it looks like the "right" root page for 
the versioned documentation should be 
https://www.boost.org/doc/libs/1_66_0/doc/html/bbv2.html, although that 
lacks some user-friendliness.

(And it also links to https://www.boost.org/boost-build2 for yet another 
URL variation... although that does redirect to 
https://www.boost.org/build/ at least.)