change: order of return values.
change: README.md and example.lua has been updated.