[issue10960] os.stat() does not mention that it follow symlinks by default

2011-01-24 Thread R. David Murray
R. David Murray added the comment: Thanks. Committed a modified version of the patch in r88164. I extended your breakout of the attributes to the other paragraphs, and reorganized the order of the paragraphs in the stat docs to put things into a more logical order (I hope). I decided to ch

[issue10960] os.stat() does not mention that it follow symlinks by default

2011-01-24 Thread R. David Murray
Changes by R. David Murray : -- assignee: docs@python -> r.david.murray ___ Python tracker ___ ___ Python-bugs-list mailing list Unsub

[issue10960] os.stat() does not mention that it follow symlinks by default

2011-01-23 Thread Michal Nowikowski
Michal Nowikowski added the comment: The patch v2: - in description of os.stat function added information about following symlinks, - made list of returned attributes by os.stat function more readable, - fixed links to os.stat function in whole document. -- Added file: http://bugs.pytho

[issue10960] os.stat() does not mention that it follow symlinks by default

2011-01-23 Thread R. David Murray
R. David Murray added the comment: I don't think Georg considers it a bug in Sphinx, it's just how the disambiguation machinery works. You can write :func:`~os.stat` if you want the link text to just be 'stat' but the link to be to 'os.stat'. I don't think the addition to lstat is either hel

[issue10960] os.stat() does not mention that it follow symlinks by default

2011-01-22 Thread godfryd
godfryd added the comment: I improved a little bit lstat function description and added note to stat function. I see that links :func:`stat` do not lead to stat function but to stat module. Is it Sphinx bug? In my changes I made explicit link to os.stat function. -- keywords: +patch

[issue10960] os.stat() does not mention that it follow symlinks by default

2011-01-22 Thread Марк Коренберг
Марк Коренберг added the comment: Yes, os.stat and os.lstat should be one after next in docs. Also IMHO, they should have cross-references. See excellent php docs for example. -- ___ Python tracker __

[issue10960] os.stat() does not mention that it follow symlinks by default

2011-01-21 Thread R. David Murray
R. David Murray added the comment: I almost closed this as invalid, since the name is, after all 'os.stat' and the docs clearly say that it calls the 'stat' system call. However, I see that our docs do not contain the more explicit language used by the 'stat' system call docs: "stats the fil

[issue10960] os.stat() does not mention that it follow symlinks by default

2011-01-20 Thread Марк Коренберг
New submission from Марк Коренберг : Documentation should say about 'following symlink' in this function. Documentation should advice to use os.lstat() in case when it needed. -- assignee: docs@python components: Documentation messages: 126631 nosy: docs@python, mmarkk priority: normal