R. David Murray added the comment: I like the footnote idea. I wonder if it would also be worth marking which functions are Posix (Availability: posix) and therefore likely to be available on all unix systems. ---------- nosy: +r.david.murray _______________________________________ Python tracker http://bugs.python.org/issue11233 _______________________________________

R. David Murray added the comment: Good point :( ---------- _______________________________________ Python tracker http://bugs.python.org/issue11233 _______________________________________

R. David Murray added the comment: Yes, but when you jump directly to one of the functions, you don't see that bullet list. Whereas if it were a footnote on the 'avaiability: unix" statement, the natural thing would be to follow the footnote and thus learn the limitations on that statement. Thus I think the footnote would be better than the bullet list at the top. ---------- status: pending -> open _______________________________________ Python tracker http://bugs.python.org/issue11233 _______________________________________

Changes by Ezio Melotti : ---------- nosy: +ezio.melotti _______________________________________ Python tracker http://bugs.python.org/issue11233 _______________________________________

Changes by Sandro Tosi : ---------- Removed message: http://bugs.python.org/msg130754 _______________________________________ Python tracker http://bugs.python.org/issue11233 _______________________________________

Éric Araujo added the comment: If no-one else has started on this, I’m interested in making a patch to introduce an availability directive. ---------- nosy: +eric.araujo resolution: works for me -> stage: -> needs patch _______________________________________ Python tracker http://bugs.python.org/issue11233 _______________________________________

Antoine Pitrou added the comment: I can't comment on the Sphinx extension code but this is a good idea. ---------- _______________________________________ Python tracker http://bugs.python.org/issue11233 _______________________________________

STINNER Victor added the comment: I like the idea of a single place where the Availability is described, and adding a link to this place. availability-directive.patch LGTM. ---------- nosy: +haypo _______________________________________ Python tracker http://bugs.python.org/issue11233 _______________________________________

Fred L. Drake, Jr. added the comment: A PR for this would be good, and would certainly accelerate getting this accomplished. Thanks, Cheryl! ---------- nosy: +fdrake _______________________________________ Python tracker https://bugs.python.org/issue11233 _______________________________________

Cheryl Sabella added the comment: Thanks, Fred. I've submitted the PR. ---------- _______________________________________ Python tracker https://bugs.python.org/issue11233 _______________________________________

STINNER Victor added the comment: New changeset 2d6097d027e0dd3debbabc702aa9c98d94ba32a3 by Victor Stinner (Cheryl Sabella) in branch 'master': bpo-11233: Create availability directive for documentation (GH-9692) https://github.com/python/cpython/commit/2d6097d027e0dd3debbabc702aa9c98d94b... ---------- _______________________________________ Python tracker https://bugs.python.org/issue11233 _______________________________________

STINNER Victor added the comment: New changeset b248a8c9a5e7cf6b8e84a3efda493fccfc511316 by Victor Stinner (Cheryl Sabella) in branch '3.7': [3.7] bpo-11233: Create availability directive for documentation (GH-9692) (GH-9830) https://github.com/python/cpython/commit/b248a8c9a5e7cf6b8e84a3efda493fccfc5... ---------- _______________________________________ Python tracker https://bugs.python.org/issue11233 _______________________________________

Cheryl Sabella added the comment: And thank you, Victor, for reviewing and merging! :-) ---------- _______________________________________ Python tracker https://bugs.python.org/issue11233 _______________________________________