some docu fixes and additions