DOC: attempt to fix docstring markup for references but this is not tested