Generating README automatically from sources
Problem: README is out of date

Fixed this by generating .doc file for each class, which simplifies
the editing in README.txt and makes it easier to keep up to date.

I also split out the V2 and V3 APIs to make it clear where CZMQ is
going.