link to r-value
update readme to cover example usage better, and explain common gotchas
5.5.16