fixed, also some other improvements to the doc string