Message 252817 - Python tracker

Message252817

Author	krichter
Recipients	docs@python, krichter
Date	2015-10-11.15:36:26
SpamBayes Score	-1.0
Marked as misclassified	Yes
Message-id	<1444577786.91.0.966567920628.issue25377@psf.upfronthosting.co.za>
In-reply-to

Content
`help(os.chmod)` doesn't explain that it expects an octal number for its `mode` argument. This is very confusing for beginners and people who are not involved with filesystems and permissions every day. It doesn't need to be explained, just mentioned, maybe with a link to an extended explanation. Example for confusion: http://stackoverflow.com/questions/15607903/python-module-os-chmodfile-664-does-not-change-the-permission-to-rw-rw-r-bu

Content

`help(os.chmod)` doesn't explain that it expects an octal number for its `mode` argument. This is very confusing for beginners and people who are not involved with filesystems and permissions every day. It doesn't need to be explained, just mentioned, maybe with a link to an extended explanation.

Example for confusion: http://stackoverflow.com/questions/15607903/python-module-os-chmodfile-664-does-not-change-the-permission-to-rw-rw-r-bu

History
Date	User	Action	Args
2015-10-11 15:36:26	krichter	set	recipients: + krichter, docs@python
2015-10-11 15:36:26	krichter	set	messageid: <1444577786.91.0.966567920628.issue25377@psf.upfronthosting.co.za>
2015-10-11 15:36:26	krichter	link	issue25377 messages
2015-10-11 15:36:26	krichter	create