[docs] [issue8996] Add a default role to allow writing bare `len` instead of :func:`len`

[Éric Araujo]

Éric Araujo <merwok at netwok.org> added the comment:

> for example, as a result of documentation merge it both
> :func:`someref` and :class:`someref` can appear
I think this would cause a warning from Sphinx, as all class/meth/func/mod/etc roles look up in the same namespace (what Georg said).

Benjamin is -1 for explicitness
I am -0 because of the ` vs. `` possible ambiguity—I prefer disabling the default role altogether
Georg, are you still +1 or should we reject this?

----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue8996>
_______________________________________