mapff fixes + doc + unit tests