Mostly updates to the comments and docs from Pull Request #1537.
Partly fixes issue #1510. "rustc --pretty=typed" fails.