[docs] [issue8996] Add a default role to allow writing bare `len` instead of :func:`len`
report at bugs.python.org
Wed Sep 19 03:49:19 CEST 2012
Ezio Melotti added the comment:
I think I'm -1 on this, for the following reasons:
* it's less explicit;
* it gives you less control (I'm thinking e.g. at the () added by :func:/:meth: but not :class:, so that :func:`int` and :class:`int` are rendered in different ways);
* even though this might have been OK if we used it from the beginning, now we are using specific roles everywhere, and changing them will either result in a mass update or in a mixed style -- none of which are desirable;
* if the mass update is done and later on we change our mind, it's difficult to switch back from `...` to :role:`...`.
Disabling `...` sounds OK to me (I don't think we have many left, if any).
Python tracker <report at bugs.python.org>
More information about the docs