Fix sphinx-build errors due to improper indentation

This commit fixes some build errors and also formats the list of flags
as a bulleted list. The previous way this list was formatted did not
have any line breaks.
Merge pull request #6852 from terminalmage/docs

Fix sphinx-build errors due to improper indentation