DOC ignoring gen_rst's parsing errors

closes #1759

And pep8!