Add diagnostic output to manual build.

When documentation generation fails in the manual, include query profile
information in the failure output. This will help debugging queries that
fail in the documentation generation.
Fixes AsciiDoc syntax and tweaks the content for shell docs.
Added instructions for upgrading a database/ cluster of databases from 1.9 to 2.0