updated doku and quick fixed bug in inverse sampling