change to reflect method signature
overhauled mapper, added a bunch of settings behaviour, changed signature of module
reflect changes, better doc
add an example file