On 03/11/2010 10:41 PM, John Bytheway wrote:
Andrey Semashev wrote:
On 03/10/2010 08:52 PM, Roland Bock wrote:
- none of the code examples is complete. They are missing the namespace declarations documented in the introduction, at least. While brevity is good, it would be very helpful to have complete, compiling examples in the tutorial
I don't think adding namespaces and includes to examples in the readable documentation is a good idea. As you noted, these examples should be brief and free of such noise. However, I will reorganize the docs, so that the code samples will be taken from compilable external files.
Other boost docs have extracts but also links to the full source code. I think that works well.
Agreed, that seems to be the best solution.