Mailman 3 March 2019 - docs

[issue30903] IPv4Network's hostmask attribute doesn't returns string value as mentioned in Documentation.
by Abhijit Mamarde March 21, 2019

March 21, 2019

New submission from Abhijit Mamarde: documentation mentions hostmask attribute of IPv4Network class returns a `string`, but in actual it is returning the object of class IPv4Address URL to official doc: https://docs.python.org/3/library/ipaddress.html#ipaddress.IPv4Network.host… PFA program file to show the actual issue. ---------- assignee: docs@python components: Documentation files: ipaddress_doc_bug.py messages: 298153 nosy: Abhijit Mamarde, docs@python priority: normal severity: normal status: open title: IPv4Network's hostmask attribute doesn't returns string value as mentioned in Documentation. type: behavior versions: Python 3.6 Added file: http://bugs.python.org/file47007/ipaddress_doc_bug.py _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue30903> _______________________________________

2 1

[issue36391] XSS in bugs.python.org 404 error page
by Hanno Boeck March 21, 2019

March 21, 2019

New submission from Hanno Boeck <hanno(a)hboeck.de>: There's an XSS on the 404 error page: https://bugs.python.org/%3Cimg%20src=x%20onerror=alert(1)%3E (For lack of a webpage / bug tracker category I chose "Documentation" as the closest category I could find) ---------- assignee: docs@python components: Documentation messages: 338543 nosy: docs@python, hanno priority: normal severity: normal status: open title: XSS in bugs.python.org 404 error page type: security _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue36391> _______________________________________

1 0

[issue36355] Remove documentation and internal use of the RESTRICTED constants for PyMemberDef's flags field
by Josh Rosenberg March 21, 2019

March 21, 2019

New submission from Josh Rosenberg <shadowranger+python(a)gmail.com>: While looking up background info for #36347, I noticed that the docs for PyMemberDef ( https://docs.python.org/3/extending/newtypes.html#generic-attribute-managem… ) define the following flags: * READONLY * READ_RESTRICTED * WRITE_RESTRICTED * RESTRICTED Of those, WRITE_RESTRICTED has been documented incorrectly since Python 3.0a2 (it got renamed to PY_WRITE_RESTRICTED in structmember.h, apparently due to a name clash with VS 2008 on Windows). Luckily, the constants are useless; AFAICT they were there solely to support restricted mode (via the rexec and Bastion modules). The modules were apparently disabled in Python 2.3 "due to various known and not readily fixable security holes" ( https://docs.python.org/2/library/restricted.html ), and the modules themselves officially deprecated in 2.6, and removed completely in 3.0. Rather than fixing up the docs, maybe it's time to kill these constants for good? Probably shouldn't remove the definitions in structmember.h (if someone wrote code using them, we shouldn't needlessly break compilation), but the interpreter and standard library should stop setting them, and the documentation for them should be removed. ---------- assignee: docs@python components: Documentation, Extension Modules, Interpreter Core messages: 338282 nosy: docs@python, josh.r priority: normal severity: normal status: open title: Remove documentation and internal use of the RESTRICTED constants for PyMemberDef's flags field versions: Python 3.8 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue36355> _______________________________________

2 4

[issue26103] Contradiction in definition of "data descriptor" between (dotted lookup behavior/datamodel documentation) and (inspect lib/descriptor how-to)
by Aaron Hall March 20, 2019

March 20, 2019

Change by Aaron Hall <aaronchall(a)yahoo.com>: ---------- stage: patch review -> resolved status: open -> closed _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue26103> _______________________________________

1 0

[issue14944] Setup & Usage documentation for pydoc
by Nick Coghlan March 20, 2019

March 20, 2019

New submission from Nick Coghlan <ncoghlan(a)gmail.com>: pydoc is installed as a script by Python. It should be documented under http://docs.python.org/dev/using/index.html. ---------- assignee: docs@python components: Documentation messages: 161831 nosy: docs@python, ncoghlan priority: normal severity: normal stage: needs patch status: open title: Setup & Usage documentation for pydoc type: enhancement versions: Python 2.7, Python 3.2, Python 3.3 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue14944> _______________________________________

7 13

[issue35564] [DOC] Sphinx 2.0 will require master_doc variable set in conf.py
by jfbu March 20, 2019

March 20, 2019

New submission from jfbu <jfbu(a)free.fr>: When building CPython doc with master branch of dev repo of Sphinx (future Sphinx 2.0) one gets this warning: WARNING: Since v2.0, Sphinx uses "index" as master_doc by default. Please add "master_doc = 'contents'" to your conf.py. Fix will be to do as Sphinx says :) ---------- assignee: docs@python components: Documentation messages: 332371 nosy: docs@python, jfbu priority: normal severity: normal status: open title: [DOC] Sphinx 2.0 will require master_doc variable set in conf.py _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue35564> _______________________________________

4 12

[issue26103] Contradiction in definition of "data descriptor" between (dotted lookup behavior/datamodel documentation) and (inspect lib/descriptor how-to)
by Cheryl Sabella March 20, 2019

March 20, 2019

Cheryl Sabella <cheryl.sabella(a)gmail.com> added the comment: It looks like this issue can be closed now that it's merged? ---------- nosy: +cheryl.sabella _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue26103> _______________________________________

1 0

[issue36359] contextvars documentation unclear on thread-locality
by Hameer Abbasi March 19, 2019

March 19, 2019

New submission from Hameer Abbasi <habbasi(a)quansight.com>: The documentation here: https://docs.python.org/3/library/contextvars.html does not mention anything about context-variables being thread-local or not. It should definitely make that more clear. I was told by Freenode user njs (I strongly suspect its Nathaniel J. Smith) that they are. ---------- assignee: docs@python components: Documentation messages: 338322 nosy: Hameer Abbasi2, docs@python, yselivanov priority: normal severity: normal status: open title: contextvars documentation unclear on thread-locality type: enhancement versions: Python 3.7, Python 3.8 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue36359> _______________________________________

1 0

[issue36327] Remove EOLed Py34 from "Status of Python branches"
by Christian Clauss March 18, 2019

March 18, 2019

New submission from Christian Clauss <cclauss(a)me.com>: Remove Python 3.4 https://devguide.python.org/#branchstatus Add Python 3.4 https://devguide.python.org/devcycle/#end-of-life-branches ---------- assignee: docs@python components: Documentation messages: 338131 nosy: cclauss, docs@python priority: normal severity: normal status: open title: Remove EOLed Py34 from "Status of Python branches" versions: Python 3.4 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue36327> _______________________________________

3 2

[issue12622] failfast argument to TextTestRunner not documented
by Cheryl Sabella March 18, 2019

March 18, 2019

Cheryl Sabella <cheryl.sabella(a)gmail.com> added the comment: I agree with @xtreak. Closing this as a duplicate. ---------- nosy: +cheryl.sabella resolution: -> duplicate stage: needs patch -> resolved status: open -> closed superseder: -> Wrong signature of TextTestRunner's init function _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue12622> _______________________________________

1 0