DOC: fix docstrings so Latex finishes

with these changes pdflatex finishes the pdf build without stopping on errors see issue #1033