Add SPHINX_WARNINGS_AS_ERRORS CMake option to allow warnings to not be
treated as errors (which is still the default). This is useful when
working on documentation that has existing errors.
Make message about building sphinx documentation with CMake more
informative by stating where the output is going.