Message 137890 - Python tracker (original) (raw)

What if in the functions.rst page we specify the current module for all the functions (or even just for int/float/etc) as builtin and use the function directive, and in the stdtypes.rst (or elsewhere) we use the class directive? The idea is to pretend that 'builtin.int' is a function in the builtin module whereas 'int' is a global object. In this way :func/class:int will probably link to the stdtypes.rst page, and :func/class:~__builtin__.int can be used to link to the functions.rst page (or the other way around if we want to link to the functions.rst page more often). This is only a workaround though (assuming that it works), changing Sphinx to be smarter might be a better option.