The library is weakly motivated -- the motivation boils down to a less expensive alternative to throwing exceptions. A stronger motivation would have been to mention use cases were errors cannot be propagated by throwing exceptions. Here are two examples:
Thanks for the review. You may be interested to know than an earlier edition of the tutorial made use of ASIO as an example, it attracted a lot of criticism for being too hard to understand. I also had an example using concurrency, I was told to ditch that as well. What remains is a very simple threadpool implementation in the tutorial. I am also mindful in all these reviews suggesting things for the documentation that the average end user is not a Boost library developer. A tutorial aimed at the likes of us is considered far too terse and dense for say the average Reddit /r/cpp developer. But thank you anyway for the review and suggestions. I'll see what I can do. Niall -- ned Productions Limited Consulting http://www.nedproductions.biz/ http://ie.linkedin.com/in/nialldouglas/