AFAIK reference numbers are re-assigned by the documentation tools, so references only work in a single function docstring.