Some refactoring of doc/userguide.txt.

Fix some typos and punctuation.
Move the "Diagnostic hooks" section from "Hooks" to "Expansion internals."
Rename `key_hash` to `hashv` since that's what it really is in the source code.