a bit of readme changes
interface change concerning mode argument