R. David Murray <rdmurray@bitdance.com> added the comment: I think you are correct that the Availability can be removed, since the actual limits of the support are exactly as complicated as the code that supports them, and should give *some* result on most (all?) platforms. However, OS/X is certainly covered by the current one, since OS/X is a unix flavor. At this point in time it might be worth doing a sweep through the docs to remove all occurrences of 'Macintosh', since we don't support OS/9 any more. There look to be less than a dozen such references in the Python3 docs. I'm adding Gregory to nosy to see if he thinks it is appropriate to remove the 'availability' entirely, since he implemented the fallback. ---------- nosy: +gregory.p.smith, r.david.murray versions: -Python 2.6, Python 3.1, Python 3.4 _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue12243> _______________________________________

Georg Brandl <georg@python.org> added the comment: Well, let's make it clear then. What about replacing the text-only "Availability" with a directive that renders into a link that displays what the individual values mean? ---------- nosy: +georg.brandl _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue12243> _______________________________________

R. David Murray <rdmurray@bitdance.com> added the comment: Georg: our post seem to have crossed despite Roundup's attempts at locking. +1 to your idea about the directive. ---------- _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue12243> _______________________________________

R. David Murray <rdmurray@bitdance.com> added the comment: It requires adding code to support a new Sphinx directive. I'm not sure if it should be a generic Sphinx directive (in which case we should open an issue on the Sphinx bug tracker) or Python specific. If the latter, I can't at the moment tell you where the python-specific Sphinx code lives, but someone will know. ---------- _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue12243> _______________________________________

Ronald Oussoren added the comment: The issue still is present, wouldn't it be better to just remove the availability annotation from the docs (2.7, 3.4 and trunk) while waiting for a better solution? That would at least remove confusion for these docs. At the very least the "Macintosh" availability note should be removed, that was used to document that a function is available on MacOS 9, which hasn't been supported in a long time now. ---------- nosy: +ronaldoussoren versions: +Python 3.4, Python 3.5 -Python 3.2, Python 3.3 _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue12243> _______________________________________

Berker Peksag added the comment: See issue 11233 for the availability directive patch. Thanks for the patch, Bryce. ---------- nosy: +berker.peksag resolution: -> fixed stage: -> resolved status: open -> closed type: -> behavior versions: +Python 3.6 -Python 3.4 _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue12243> _______________________________________