more docu and fixes