DOC/BUG : fixed sphinx markup

 - issue introduced in #2836
 - closes #2982
Merge pull request #2983 from tacaswell/doc_format_fix

DOC/BUG : fixed sphinx markup