Modify sys.doc to replace rst directives

This commit modifies sys.doc so that the rst directives within it look
better on the CLI when the docs are printed to the terminal.
Merge pull request #7252 from terminalmage/sysdoc-rst-replace

Modify sys.doc to replace rst directives