Author sandro.tosi
Recipients docs@python, sandro.tosi
Date 2011-02-17.19:03:18
SpamBayes Score 1.57042e-06
Marked as misclassified No
Message-id <1297969399.53.0.187875867799.issue11233@psf.upfronthosting.co.za>
In-reply-to
Content
Hi, following up http://mail.python.org/pipermail/docs/2011-February/003083.html we have a chat on #python-dev on the topic, the situation is

- all started with os.lchmod() and as.lchflags() methods not available on a Debian system
- that's because POSIX does not require those functions and then Linux systems don't provide them 
- so we then thought about clarifying, only for those 2 methods, that they might not be available with a format like "availability: some unix systems"
- then we noticed that on top of os doc there's a notice "An “Availability: Unix” note means that this function is commonly found on Unix systems. It does not make any claims about its existence on a specific operating system." and so we thought about linking every 'Availability: Unix' to that note
- or transform that not in a footnote and link every 'Availability: Unix' for functions that might not be present to that footnote.

It's enough for the conversation dump: ideas/suggestions? :)
History
Date User Action Args
2011-02-17 19:03:19sandro.tosisetrecipients: + sandro.tosi, docs@python
2011-02-17 19:03:19sandro.tosisetmessageid: <1297969399.53.0.187875867799.issue11233@psf.upfronthosting.co.za>
2011-02-17 19:03:18sandro.tosilinkissue11233 messages
2011-02-17 19:03:18sandro.tosicreate