¿Cómo puedo hacer referencia a un parámetro documentado de la función Python usando el marcado Sphinx?
Me gustaría hacer referencia a un parámetro de función previamente documentado en otra parte de una cadena de documentación de Python. Considere el siguiente ejemplo (ciertamente 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 una forma sencilla de incrustar una referencia de parámetro mediante el marcado Sphinx, o esto sucederá de forma automática?
(Soy un novato completo de Sphinx. He estado escaneando los documentos de Sphinx y no he encontrado una respuesta a esta pregunta, o un ejemplo que demuestre el marcado adecuado).