Fix warnings in the documentation.
Minor syntactic and stylistic corrections.