DOC ignoring gen_rst's parsing errors

closes #1759