Mailman 3 November 2017 - docs

Should I download documentation if I downloaded python?
by Nijaz Muratović 23 Nov '17

23 Nov '17

I've seen pyhton has it's help files when installed. Is that enough, meaning are these help files samme as separate documentation? You offer as html in zip or pdf or text, and separate chm...

1 0

poor documentation
by Marco 23 Nov '17

23 Nov '17

To give a couple of examples to my previous message: "Although scopes are determined statically, they are used dynamically." What on earth does this mean? "It is important to realize that scopes are determined textually: the global scope of a function defined in a module is that module’s namespace, no matter from where or by what alias the function is called. On the other hand, the actual search for names is done dynamically, at run time — however, the language definition is evolving towards static name resolution, at “compile” time, so don’t rely on dynamic name resolution! (In fact, local variables are already determined statically.)" What does "determined textually" mean? What is "the global scope of a function"? It just said functions have a separate local scope. Now it's global? I don't get it, what was the person who wrote this smoking? Is this really the tutorial you recommend to people starting your language?

1 0

(no subject)
by Marco 23 Nov '17

23 Nov '17

The documentation on Classes in the latest Python Tutorial is poorly written and confusing, the author seems to be writing it for C++ programmers, this is not an acceptable assumption for a general introduction to a programming language, the majority of people reading this will not be former C++ programmers. In short, it's not up to standards of technical writing in this context. Thank you

1 0

[issue32109] Separated square brackets will generate a tuple instead of a list.
by Berker Peksag 23 Nov '17

23 Nov '17

New submission from Berker Peksag <berker.peksag(a)gmail.com>: Thank you for your report and for the PR, but I think you misunderstood documentation: Using square brackets, separating items with commas: [a], [a, b, c] The comma is used to show two different lists: a list with one item ``[a]`` *and* a list with three items ``[a, b, c]``, not a tuple with two lists ``[a], [a, b, c]`` (In Python, both ``(1,)`` and ``1,`` create a tuple) ---------- nosy: +berker.peksag resolution: -> not a bug stage: patch review -> resolved status: open -> closed _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue32109> _______________________________________

4 4

[issue32109] Separated square brackets will generate a tuple instead of a list.
by YCmove 22 Nov '17

22 Nov '17

Change by YCmove <y8765gd(a)gmail.com>: ---------- keywords: +patch pull_requests: +4435 stage: -> patch review _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue32109> _______________________________________

1 0

[issue32109] Separated square brackets will generate a tuple instead of a list.
by YCmove 22 Nov '17

22 Nov '17

Change by YCmove <y8765gd(a)gmail.com>: ---------- assignee: docs@python components: Documentation nosy: YCmove, docs@python priority: normal severity: normal status: open title: Separated square brackets will generate a tuple instead of a list. type: enhancement versions: Python 2.7, Python 3.4, Python 3.5, Python 3.6, Python 3.7, Python 3.8 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue32109> _______________________________________

1 0

[issue32105] Please add asyncio.BaseEventLoop.connect_accepted_socket Version Added to documentation
by Thomas Eldon Allred 21 Nov '17

21 Nov '17

New submission from Thomas Eldon Allred <e2thenegpii(a)gmail.com>: asyncio.BaseEventLoop.connect_accepted_socket was added in v3.5.3 Please add a note to the documentation. ---------- assignee: docs@python components: Documentation messages: 306650 nosy: Thomas Eldon Allred, docs@python priority: normal severity: normal status: open title: Please add asyncio.BaseEventLoop.connect_accepted_socket Version Added to documentation type: enhancement versions: Python 3.5, Python 3.6, Python 3.7, Python 3.8 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue32105> _______________________________________

4 6

small issue
by Joby John 21 Nov '17

21 Nov '17

https://docs.python.org/2/library/simplehttpserver.html > extensions_map> "The mapping is used case-insensitively, and so should contain only lower-cased keys." statement is contradicting.

1 0

[issue32075] Expose ZipImporter Type Object in the include header files.
by Serhiy Storchaka 20 Nov '17

20 Nov '17

Serhiy Storchaka <storchaka+cpython(a)gmail.com> added the comment: The C API cann't be changed in a bugfix release. Unless for fixing bugs, but even in that case we should be very very careful. There is no a bug. ---------- _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue32075> _______________________________________

1 0

[issue32075] Expose ZipImporter Type Object in the include header files.
by Decorater 20 Nov '17

20 Nov '17

Decorater <seandhunt_7(a)yahoo.com> added the comment: Well since issue25711 might be for 3.7 and newer I guess this patch might actually be for 3.6.4 or something then. And then the rewrite would take over on 3.7 and newer depending on if the rewrite makes it in to 3.7. ---------- versions: +Python 3.6 -Python 3.7, Python 3.8 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue32075> _______________________________________

1 0