Soak up stdout/stderr to avoid deadlock.
Fix markup, spelling.
Repeat brief text in the detailed docs.

This should make detailed docs more readable.
Fix capitalization.
Fix docs, spelling.
Fix docs, spelling.