Cross-Reference roles only link to first instance
I have the following situation. I have a class promoted into Python using the Python/C API. This class has methods. Some of these methods are overloaded. In my documentation I have something like the following:
.. class:: MyClass This is my class. .. method run( Foo a ) -> string Run on a Foo object. .. method run( Bar b, Bug c ) -> string Run on Bar and Bug objects.
Now when I reference the methods there is no way to specify which one I want:
In order to run using a :class:`Foo` then use the :meth:`MyClass.run` method.
This will always resolve to the first class method. It seems that what is needed is an interface much like the ':ref:' role. Something where we can do the following:
:meth:`MyClass.run <MyClass.run( Foo a )>`
Where the method signature can be provided and possibly the text that appears for the link.