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:
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:
MyClass.run <MyClass.run( Foo a )>
Where the method signature can be provided and possibly the text that appears for the link.