[issue46782] Docs error for 3.10

[Éric Araujo]

Éric Araujo  added the comment:

Octal 777 is really the same as decimal 511.
If you are calling mkdir and looking at the permissions on the created 
directory, you may think the mode is wrong because of umask (default permission 
bitmask that’s applied to the mode).  But the numbers are really equivalent, we 
are only talking about a doc presentation issue here, not any problem in code.

--

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue46782] Docs error for 3.10

[sjndlnv brjkbn]

sjndlnv brjkbn  added the comment:

I found out that this issue can be fixed by set ``autodoc_preserve_defaults`` 
to True [(From 
sphinx-doc)](https://www.sphinx-doc.org/en/master/usage/extensions/autodoc.html#confval-autodoc_preserve_defaults)

On the other hand. I test ``Path.mkdir(mode=511)`` on my mac. It's the same as 
``Path.mkdir(mode=0o77)``

But it's not the same on my company's dev linux server.

I will double check this part on Monday.

--

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue46782] Docs error for 3.10

[Terry J. Reedy]

Terry J. Reedy  added the comment:

The conversions from 0o777 to 511 in 3.10 and 3.11 but not in 3.9 are these:

https://docs.python.org/3/library/pathlib.html#pathlib.Path.mkdir
  Path.mkdir(mode=511, parents=False, exist_ok=False)

https://docs.python.org/3/library/os.html#os.mkdir
  os.mkdir(path, mode=511, *, dir_fd=None)

I don't know whether different sphinx versions are used for different versions 
of the docs.

--
nosy: +eric.araujo, mdk, terry.reedy

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue46782] Docs error for 3.10

[sjndlnv brjkbn]

New submission from sjndlnv brjkbn :

Document for 3.10 version seems auto convert 0o777 to 511. And it's correct for 
3.9

(May be due to new version of Sphinx? Seems source code for docs are correct.)

[img]https://i.imgur.com/ByWSJ6A.png[/img]
[img]https://i.imgur.com/rK0romC.png[/img]
[img]https://i.imgur.com/WXYMcrT.png[/img]
[img]https://i.imgur.com/W5YskgQ.png[/img]

It may misleading user. If we use os.mkdir(mode=511), it's not equal to use 
os.mkdir(mode=0o777)

--
assignee: docs@python
components: Documentation
messages: 413425
nosy: docs@python, usetohandletrush
priority: normal
severity: normal
status: open
title: Docs error for 3.10
type: behavior
versions: Python 3.10

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com