documentation: improve readability; line length, indentation, highlighting.