[Boost-build] notes about user manual

From: Gennadiy Rozental (rogeeff_at_[hidden])
Date: 2007-10-14 02:11:50

Hi,

I am reading user's manual and want ot share some notes:

1.  Page 7 introduced Dependant target. I might make sense to emphasize that 
double // is intentional

2. Page 8: Tip on the bottom refer to the <library>... in the text and 
<source>... in the example. What is correct?

3. Page 8: "Testing ... " title is broken in 2 lines for no reason IMO

4. What you introduce reference qualification it might make sense to explain 
wht syntax is in general and how it stacks with multiple qualifications

5. Page 9: Library dependency tip: if core is shared library on *nix like OS 
you don;t need to link with it at all. While if you want to ensure all 
resolved symbols you can and need additional arguments, but this may 
encrease link time. On NT DLL build will require all the references to be 
resolved. What options is used by Boost.Build, why, and how to configure 
this behavior.

6. Page 10: alternatives example first comment is shifted

7. Page 17: Invocation section missing most critical piece of information: 
how to invoke concrete version of the tool. For example how to invoke msvc 
7.1 compilation if default is 8.0

8. Page 46: Several words scrambled together.

Still reading,

Gennadiy