cfunction scope and roles

[shimizukawa]

It would great if the cfunction directive was aware of its scope. I.e. if cfunction was declared inside of a ctype (as its child), then it should automatically prepend the name of that type to its id. Similar for the references (via func role) within that type. It should not, however, prepend the type name within the visible name in the output. I.e. I'm hoping for the behavior similar to the method behavior for Python documention.

So for example if one wrote:

.. ctype:: class A

   Some description of type A.

   .. cfunction:: f()

      Description of f.

  .. cfunction:: g()

      Calls :func:`f`.

Another reference to :func:`A::f`.

then ideally it would generate the same ids as if one wrote

.. ctype:: class A

   Some description of type A.

   .. cfunction:: A::f()

      Description of f.

  .. cfunction:: A::g()

      Calls :func:`A::f`.

Another reference to :func:`A::f`.

but without the confusing A:: within the class itself.

---

• Bitbucket: https://bitbucket.org/birkenfeld/sphinx/issue/139
• Originally reported by: Dmitriy Morozov
• Originally created at: 2009-04-02T03:55:00.801

[shimizukawa]

From Georg Brandl on 2010-08-25 11:50:14+00:00

This is fixed by using the C++ domain, new in Sphinx 1.0, instead.