more documention, use tr/// instead of s/// where possible, add leading and trailing spaces