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

Ezio Melotti 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 mailing list