doc
bug fixes & pysam retro-compatibility