clarify shorthand codes
update readme