Merge pull request #42 from nbrownus/broker_errors

Better broker errors and some documentation
fix Makefile
fix multiple partitions of the same topic not consumed
Merge pull request #43 from haio/master

Fix multiple partitions of the same topic not consumed