-- extended readme with examples of usage