Fixed docs issues found by Niall Douglas, the review manager.
* Fixed a lot of typos
* Added info about type_id_rtti_only behaviour without RTTI
* Added a BOOST_ASSERT_MESSAGE foe a more user friendly error output
* Added `Code bloat` section and refactored the `Performance` section
* More verbose examples
And also:
* Added missing headers
* Fixed Jamfile (now ALL the examples run)
* Added some more BOOST_NOEXCEPT