small cleanups and doc update

Improve docs.

(0) -30 -10 -2 +2 +10 +30 tip

mercurial