Como faço referência a um parâmetro documentado da função Python usando a marcação Sphinx?
Gostaria de referenciar um parâmetro de função documentado anteriormente em outro lugar em um docstring do Python. Considere o seguinte exemplo (reconhecidamente completamente artificial):
def foo(bar):
"""Perform foo action
:param bar: The bar parameter
"""
def nested():
"""Some nested function that depends on enclosing scope's bar parameter.
I'd like to reference function foo's bar parameter here
with a link, is that possible?"""
return bar * bar
# ...
return nested()
Existe uma maneira simples de incorporar uma referência de parâmetro usando a marcação Sphinx ou isso acontecerá automaticamente?
(Eu sou um completo novato da Esfinge. Eu tenho escaneado os documentos da Esfinge e não encontrei uma resposta para esta pergunta, ou um exemplo demonstrando marcação apropriada.)