[Boost-build] [Build] Review of documentation

Subject: [Boost-build] [Build] Review of documentation
From: Lee Winter (lee.j.i.winter_at_[hidden])
Date: 2009-04-18 21:18:01

As a potential new user I spent some time reviewing all of the
documentation that I could find for bjam and Boost Build.  Frustrated
by that effort, I annotated the user doc with potential corrections
and improvements.  It was my intention to do so while my eyes were
still "virgin" and not biased by experience with using the tools.
After I have some experience in using the tools I plan a second review
aimed more at content than at clarity of presentation.  Is this an
appropriate forum to submit those annotations?  If not then where?

As I being using the tools there is one question that I cannot resolve
by inspection of the documentation.  That question is how to get one
jam file to suck in another as #include allows c files to suck in h
files.  I'm morally certain that such a capability exists, but I have
not found any existential proof to support my opinion.  Is there such
a capability and, if so, how is it exercised?

Lee Winter
NP Engineering
Nashua, New Hampshire