[issue27036] Mark up of references in different form

[Martin Panter]

Martin Panter added the comment:

It _would_ be nice to sort out the SyntaxErrors problem as well, but don’t let that stop fixing the easier problems. I would be interested in other people’s thoughts.

My problem with things like :func:`evaluated <eval>` is that the meaning is less clear, and it is not obvious what the hyperlink is for. If you print the sentence out, or casually look in a browser, there is not much indication that the function eval() is specified. Ugly as it is, “eval()uated” is more obvious.

Other options that I would be happier with, if you want to avoid the repeated “evaluated with eval()”, etc:

Level values are passed through :func:`eval`
list of channels waited with select() or poll()
The ``args`` entry, after passing through :func:`eval`
and :meth:`~Thread.join` cannot be called on them [dummy threads]
Module objects now support :mod:`weakref`.

----------

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