some more docu enhancements