Message 379797 - Python tracker

Message379797

Author	macrakis
Recipients	Dean Morin, docs@python, macrakis, r.david.murray
Date	2020-10-27.19:42:50
SpamBayes Score	-1.0
Marked as misclassified	Yes
Message-id	<1603827770.58.0.941961479557.issue33896@roundup.psfhosted.org>
In-reply-to

Content
I agree completely that the documentation should be more explicit. The concept of "os.stat signature" is not defined anywhere as far as I can tell. The naive reader (like me) might mistakenly assume that the "os.stat signature" is a "digital signature" (i.e. a hash) of all of os.stat, and in particular that it includes the st_ino. I would suggest that the documentation be updated to read "If shallow is true, files with the same length, modification time, and mode are taken to be equal."

Content

I agree completely that the documentation should be more explicit. The concept of "os.stat signature" is not defined anywhere as far as I can tell. The naive reader (like me) might mistakenly assume that the "os.stat signature" is a "digital signature" (i.e. a hash) of all of os.stat, and in particular that it includes the st_ino.

I would suggest that the documentation be updated to read "If shallow is true, files with the same length, modification time, and mode are taken to be equal."

History
Date	User	Action	Args
2020-10-27 19:42:50	macrakis	set	recipients: + macrakis, r.david.murray, docs@python, Dean Morin
2020-10-27 19:42:50	macrakis	set	messageid: <1603827770.58.0.941961479557.issue33896@roundup.psfhosted.org>
2020-10-27 19:42:50	macrakis	link	issue33896 messages
2020-10-27 19:42:50	macrakis	create