more details and examples in the spec + don't overflow 80 columns