Update README

Add usage, examples, requirements and return codes