Doc strings added by Mitch Chapman.

Also got rid of some inconsistent change log comments near the top.