minor fixes and more docu