minor fixes, doc stuff
fix generate_h5