[Boost-build] [doc] b2 headers

Subject: [Boost-build] [doc] b2 headers
From: Mateusz Loskot (mateusz_at_[hidden])
Date: 2018-04-09 13:35:38

Hi,

TL;TR: A rant

I've been looking for documentation about purpose of command

b2 headers

Greping for headers or modular inside  /tools/build/doc and
/doc gives me nothing, so I blindly assume the unsearchable
https://www.boost.org/build/ does not explain it either.

The magic of https://www.google.com/search?q="b2+headers"
brought this page to my attention:
https://www.boost.org/doc/libs/master/tools/boostdep/doc/html/
where, to my surprise, I find one of best intro to the concept
of modular Boost including very helpful explanation of the virtual
/boost directory and role of b2 headers command.

Why this kind of information is presented in docs for somewhat
exotic to Boost (end)users command, I have no idea.
But, as long-time Boost.Build users, I dare to judge this is an
excellent example of why peole hate this awesome build system :)

Best regards,
-- 
Mateusz Loskot, http://mateusz.loskot.net