Fix doctests in comments2rst.py

Added optional tags and fixed a couple spacing/newline things.