Boost Documentation

Now I like the boost libraries, they let you do almost anything in C++ and make most things an order of magnitude easier, iff you know how the library works.

void rant() {

Some libraries have brilliant documentation but most provide just the wrong level of detail. Enough information to know that you’re almost doing it right but it still won’t compile and/or it segs in the most obscure way. The Interprocess library is my latest target - it has a lot of examples and a lot of hints and seemingly lots of functionality, I’m not saying that I want the authors to leave a breadcrumb trail for every possible way of using the library but if you’re going to give examples, explain them properly! And tell me what the functions do on the same pages that you talk about them.  Tell me how memory mapped files differ from shared memory, it doesn’t have to be overly simple - I’m using boost, I probably know what I’m doing!

I’m not even going to mention the python docs (though they have improved massively in the last few versions).

}

Good Hunting

24 Nov 2009, 10:54pm
by Neil Roberts


No amount of documentation is going to make any library in C++ sane, it’s a completely ridiculous language!

Just enough rope lying around everywhere in handy nooses ;)

*name

*e-mail

web site

leave a comment


 
  • Categories

  • Recent Tweets

  • Comments