[boost] Re: Namespaces vs. directory placement

David Abrahams wrote:

Jonathan Turkanis wrote:

...

I know how I would explain the convention; I'm just afraid people won't notice it, and will copy and paste from the examples and find they don't work. It's a bit easier in a printed book, in which there's some expectation that the material will be read from the beginning, than in a heavily hyperlinked web document, where reader are known to skip immediately to somewhere in the middle.

Then use some automated processing to ensure that every one of your examples begins with the single line:

namespace io = boost::iostreams;

And then your examples will become much more readable: io::foo instead of boost::io::foo.

This sounds reasonable. Jonathan