[issue33869] doc Add set, frozen set, and tuple entries to Glossary

2018-06-17 Thread Andrés Delfino
Andrés Delfino added the comment: Sorry, INADA, you are right. -- ___ Python tracker <https://bugs.python.org/issue33869> ___ ___ Python-bugs-list mailin

[issue33892] doc Add a couple of "or she/her"

2018-06-17 Thread Andrés Delfino
Andrés Delfino added the comment: Yeap, Ammar just told me the same suggestion on GitHub :) PR will be a little more ambitious now, as I'm replacing all he/him/she/her mentions. -- ___ Python tracker <https://bugs.python.org/issue33

[issue33892] doc Add a couple of "or she/her"

2018-06-17 Thread Andrés Delfino
Change by Andrés Delfino : -- keywords: +patch pull_requests: +7378 stage: -> patch review ___ Python tracker <https://bugs.python.org/issue33892> ___ ___ Py

[issue33892] doc Add a couple of "or she/her"

2018-06-17 Thread Andrés Delfino
New submission from Andrés Delfino : PR adds some "or she/her". -- assignee: docs@python components: Documentation messages: 319840 nosy: adelfino, docs@python priority: normal severity: normal status: open title: doc Add a couple of "or she/her" type: enhancement

[issue33876] doc Mention the MicroPython implementation in Introduction

2018-06-17 Thread Andrés Delfino
Andrés Delfino added the comment: I have updated the PR with a FAQ that mentions all implementations mentioned here, except Cython and Stackless Python. I added RapydScript as it's used by VPython for Web visualization, in the category of client-side scripting pythonesque languages

[issue33889] doc Mention Python on-line shell in Tutorial

2018-06-17 Thread Andrés Delfino
Change by Andrés Delfino : -- keywords: +patch pull_requests: +7377 stage: -> patch review ___ Python tracker <https://bugs.python.org/issue33889> ___ ___ Py

[issue33889] doc Mention Python on-line shell in Tutorial

2018-06-17 Thread Andrés Delfino
New submission from Andrés Delfino : If having a link to that specific console is not deemed appropriate, perhaps we can point to PythonAnywhere. IMHO, it's good to let users know that they can try Python right away without needing to install. -- assignee: docs@python components

[issue33888] Use CPython instead of Python when talking about implementation details

2018-06-17 Thread Andrés Delfino
Change by Andrés Delfino : -- keywords: +patch pull_requests: +7375 stage: -> patch review ___ Python tracker <https://bugs.python.org/issue33888> ___ ___ Py

[issue33888] Use CPython instead of Python when talking about implementation details

2018-06-17 Thread Andrés Delfino
New submission from Andrés Delfino : The FAQ talks about list and dictionary implementation details using "Python". I believe this should be changed to CPython. -- assignee: docs@python components: Documentation messages: 319825 nosy: adelfino, docs@python priority: norma

[issue33887] doc Add TOC in Design and History FAQ

2018-06-17 Thread Andrés Delfino
Change by Andrés Delfino : -- keywords: +patch pull_requests: +7374 stage: -> patch review ___ Python tracker <https://bugs.python.org/issue33887> ___ ___ Py

[issue33887] doc Add TOC in Design and History FAQ

2018-06-17 Thread Andrés Delfino
New submission from Andrés Delfino : IHMO, having all questions put together is really useful. -- assignee: docs@python components: Documentation messages: 319824 nosy: adelfino, docs@python priority: normal severity: normal status: open title: doc Add TOC in Design and History FAQ type

[issue33885] doc Replace "hook function" with "callable" in urllib.request.urlretrieve

2018-06-17 Thread Andrés Delfino
Change by Andrés Delfino : -- keywords: +patch pull_requests: +7373 stage: -> patch review ___ Python tracker <https://bugs.python.org/issue33885> ___ ___ Py

[issue33885] doc Replace "hook function" with "callable" in urllib.request.urlretrieve

2018-06-17 Thread Andrés Delfino
New submission from Andrés Delfino : The reporthook of urllib.request.urlretrieve is treated as a function hook, while the right term is "callable". PR fixes this. -- assignee: docs@python components: Documentation messages: 319822 nosy: adelfino, docs@python priority: norma

[issue33872] doc Add list access time to list definition

2018-06-17 Thread Andrés Delfino
Andrés Delfino added the comment: IMHO, if we deem it useful for users not to expect the time complexity of a linked list for list elements access to the extent of adding a comment in the glossary, there's no reason it isn't useful to someone who is reading the actual list definition

[issue33872] doc Add list access time to list definition

2018-06-17 Thread Andrés Delfino
Andrés Delfino added the comment: INADA, I believe that piece of information is on the Glossary just to make the difference with a "linked list", but in that case, it should be in the list definition too, as it's fair to think people can learn what a list is by reading its defini

[issue33872] doc Add list access time to list definition

2018-06-16 Thread Andrés Delfino
Andrés Delfino added the comment: If O(1) time complexity for element access is not a requirement (which it seems it's not), I agree that this PR as it is should be closed, and the Glossary entry should have this detail removed. In that case, can I edit the PR or should I open a new one

[issue33883] doc Mention mypy, pytype and PyAnnotate in FAQ

2018-06-16 Thread Andrés Delfino
Change by Andrés Delfino : -- keywords: +patch pull_requests: +7368 stage: -> patch review ___ Python tracker <https://bugs.python.org/issue33883> ___ ___ Py

[issue33883] doc Mention mypy, pytype and PyAnnotate in FAQ

2018-06-16 Thread Andrés Delfino
New submission from Andrés Delfino : As far as I know, mypy and pytype are more advanced that any of the other tools mentioned in the FAQ for static analysis, however we are not touching them. PR adds mentions. -- assignee: docs@python components: Documentation messages: 319798 nosy

[issue33882] doc Mention breakpoint() in debugger-related FAQ

2018-06-16 Thread Andrés Delfino
Change by Andrés Delfino : -- keywords: +patch pull_requests: +7367 stage: -> patch review ___ Python tracker <https://bugs.python.org/issue33882> ___ ___ Py

[issue33882] doc Mention breakpoint() in debugger-related FAQ

2018-06-16 Thread Andrés Delfino
New submission from Andrés Delfino : IMHO, it's a good opportunity to advertise the convenience of breakpoint(). PR adds a mention. -- assignee: docs@python components: Documentation messages: 319796 nosy: adelfino, docs@python priority: normal severity: normal status: open title: doc

[issue33876] doc Mention the MicroPython implementation in Introduction

2018-06-16 Thread Andrés Delfino
Andrés Delfino added the comment: What do you think about also mentioning Skulpt and Brython? On one hand, they -like MicroPython/CirtcuitPython- cover a focus no other implementation does (and a special one: client side Web scripting); but on the other hand, we shouldn't make space

[issue33876] doc Mention the MicroPython implementation in Introduction

2018-06-16 Thread Andrés Delfino
Andrés Delfino added the comment: Sorry, I didn't knew that :) I'll update the PR adding an entry in the FAQ. With "CPython" in "pythonesque implementation like MicroPython, CircuitPython, CPython" did you mean Cython? -- __

[issue33877] doc Mention Windows along UNIX for script running instructions

2018-06-15 Thread Andrés Delfino
Change by Andrés Delfino : -- keywords: +patch pull_requests: +7352 stage: -> patch review ___ Python tracker <https://bugs.python.org/issue33877> ___ ___ Py

[issue33877] doc Mention Windows along UNIX for script running instructions

2018-06-15 Thread Andrés Delfino
New submission from Andrés Delfino : Reference 9.1. says: "Under Unix, a complete program can be passed to the interpreter in three forms...". This also applies to Windows. PR fixes this. -- assignee: docs@python components: Documentation messages: 319703 nosy: adelfino, d

[issue33876] doc Mention the MicroPython implementation in Introduction

2018-06-15 Thread Andrés Delfino
Change by Andrés Delfino : -- keywords: +patch pull_requests: +7349 stage: -> patch review ___ Python tracker <https://bugs.python.org/issue33876> ___ ___ Py

[issue33876] doc Mention the MicroPython implementation in Introduction

2018-06-15 Thread Andrés Delfino
New submission from Andrés Delfino : IMHO, mentioning MicroPython is a plus because it's a mature project with a focus not covered by any of the other mentioned implementations. PR adds the mention. -- assignee: docs@python components: Documentation messages: 319700 nosy: adelfino

[issue33872] doc Add list access time to list definition

2018-06-15 Thread Andrés Delfino
Change by Andrés Delfino : -- keywords: +patch pull_requests: +7341 stage: -> patch review ___ Python tracker <https://bugs.python.org/issue33872> ___ ___ Py

[issue33872] doc Add list access time to list definition

2018-06-15 Thread Andrés Delfino
New submission from Andrés Delfino : Glossary talks about list access complexity, but the actual list definition doesn't. I think glossary entries should have more information than actual definitions. PR adds list access complexity to list definition. -- assignee: docs@python

[issue33869] doc Add set, frozen set, and tuple entries to Glossary

2018-06-15 Thread Andrés Delfino
Andrés Delfino added the comment: I thought since dictionary and list is there, tuple/set/frozenset should be, too. But I think you are right. I'd keep the link to the list definition, though. I didn't add a link to the dictionary definition as "dictionary" seems to be a very

[issue33832] Make "magic methods" a little more discoverable in the docs

2018-06-15 Thread Andrés Delfino
Andrés Delfino added the comment: Sorry, for some reason the PR doesn't show the intended changes. I'm working on fixing it. -- ___ Python tracker <https://bugs.python.org/issue33

[issue33852] doc Remove parentheses from sequence subscription description

2018-06-15 Thread Andrés Delfino
Change by Andrés Delfino : -- pull_requests: +7331 ___ Python tracker <https://bugs.python.org/issue33852> ___ ___ Python-bugs-list mailing list Unsubscribe:

[issue33832] Make "magic methods" a little more discoverable in the docs

2018-06-15 Thread Andrés Delfino
Andrés Delfino added the comment: For context, I opened this issue after Raymond's reasoning in #33825 (which I agreed with). -- ___ Python tracker <https://bugs.python.org/issue33

[issue33832] Make "magic methods" a little more discoverable in the docs

2018-06-15 Thread Andrés Delfino
Andrés Delfino added the comment: Terry: I have updated the PR with the original intention. You'll see it is much simpler. Pablo: Don't worry! I take it as a mistake of my own. Fred: I believe synonyms aren't the best things to have, but, if used consistently, they don't pose a real problem

[issue33832] Make "magic methods" a little more discoverable in the docs

2018-06-15 Thread Andrés Delfino
Andrés Delfino added the comment: I'll update the PR so that it shows what the original intention was. -- ___ Python tracker <https://bugs.python.org/issue33

[issue33832] Make "magic methods" a little more discoverable in the docs

2018-06-15 Thread Andrés Delfino
Andrés Delfino added the comment: The original intention of the PR, as shown in this issue, was to add "magic method" in the Glossary as a synonym for "special method", and add "magic method" in Data model (so that people reading Data Model would understand what

[issue33869] doc Add set, frozen set, and tuple entries to Glossary

2018-06-15 Thread Andrés Delfino
Change by Andrés Delfino : -- keywords: +patch pull_requests: +7322 stage: -> patch review ___ Python tracker <https://bugs.python.org/issue33869> ___ ___ Py

[issue33869] doc Add set, frozen set, and tuple entries to Glossary

2018-06-15 Thread Andrés Delfino
New submission from Andrés Delfino : PR adds entries for these three terms and a link to the list definition. -- assignee: docs@python components: Documentation messages: 319619 nosy: adelfino, docs@python priority: normal severity: normal status: open title: doc Add set, frozen set

[issue33863] Enum doc correction relating to __members__

2018-06-14 Thread Andrés Delfino
Andrés Delfino added the comment: Something I forgot: we shouldn't write documentation that expects the user *not* to know that dictionaries are ordered now. It's described in What's New and in Built-in Types. That's why "ordered dictionaries" seems so w

[issue33863] Enum doc correction relating to __members__

2018-06-14 Thread Andrés Delfino
Andrés Delfino added the comment: The problem here is that while the historical issue is real, new programmers will come and they won't see a "non-ordered" dict, and having this "dictionaries" vs "ordered dictionaries" that aren't actual OrderedDict object

[issue33863] Enum doc correction relating to __members__

2018-06-14 Thread Andrés Delfino
Andrés Delfino added the comment: To be a little more clear about this: I don't think one implements a dict-like object by reading the Glossary reference. At least, we shouldn't expect nor encourage this. -- ___ Python tracker <ht

[issue33860] doc Avoid "ordered dictionary" references now that dictionaries are ordered

2018-06-14 Thread Andrés Delfino
Andrés Delfino added the comment: Perhaps we can continue the discussion on #33863 as there are more argumnets there, from all points of view, and when a decision is taken there, we can apply it here too. -- ___ Python tracker <ht

[issue33863] Enum doc correction relating to __members__

2018-06-14 Thread Andrés Delfino
Andrés Delfino added the comment: IMHO, the Glossary is just a quick & dirty reference. I wouldn't search for hard definitions in there. See Built-in Types: "dictionary" is used specifically for dict. I believe we should make clear use of definitions so users known exactly wha

[issue33860] doc Avoid "ordered dictionary" references now that dictionaries are ordered

2018-06-14 Thread Andrés Delfino
Andrés Delfino added the comment: I believe the discussion in #33863 is relevant. Depending on what the API the user can rely on, perhaps "an ordered mapping" fits here too. -- ___ Python tracker <https://bugs.python.o

[issue33863] Enum doc correction relating to __members__

2018-06-14 Thread Andrés Delfino
Andrés Delfino added the comment: What do you mean by "a generic dictionary"? If it's a dict-like object, then it *must* be ordered starting with 3.7. I believe we should make it clear that a dictionary is always a dict object. If you refer to a mapping with no specific API, then &

[issue33863] Enum doc correction relating to __members__

2018-06-14 Thread Andrés Delfino
Andrés Delfino added the comment: What about "a dictionary-like object" for master/3.7, and "a dictionary-like object with insertion order preservation" for 3.6 (or something like that). I'd avoid "ordered dictionary" altogether as that's the

[issue33863] Enum doc correction relating to __members__

2018-06-14 Thread Andrés Delfino
Andrés Delfino added the comment: What about "a dictionary-like object"? -- ___ Python tracker <https://bugs.python.org/issue33863> ___ ___ Python-b

[issue33863] Enum doc correction relating to __members__

2018-06-14 Thread Andrés Delfino
Andrés Delfino added the comment: It doesn't seem right to me to change a term's meaning. Plus, saying "ordered dictionary" makes me think a "dictionary" isn't ordered. -- ___ Python tracker <https://bug

[issue33863] Enum doc correction relating to __members__

2018-06-14 Thread Andrés Delfino
Andrés Delfino added the comment: I'm not sure "ordered dictionary" is the right term. To me, "ordered dictionary" and "OrderedDict" are synonyms, just like "dictionary" and "dict" are. Documentation follows this path in several places. You

[issue33862] doc Fix Enum __members__ type

2018-06-14 Thread Andrés Delfino
Andrés Delfino added the comment: I can't really say if it the return of __members__ is an implementation detail as there's no mention of that in the doc, but from reading the doc I think it's reasonable to think this is allowed: import enum class Colors(enum.Enum): RED = enum.auto

[issue33862] doc Fix Enum __members__ type

2018-06-14 Thread Andrés Delfino
Change by Andrés Delfino : -- keywords: +patch pull_requests: +7309 stage: -> patch review ___ Python tracker <https://bugs.python.org/issue33862> ___ ___ Py

[issue33862] doc Fix Enum __members__ type

2018-06-14 Thread Andrés Delfino
New submission from Andrés Delfino : Documentation says __members__ attribute returns an "ordered dictionary" but it returns a mappingproxy instead. PR fixes this. -- assignee: docs@python components: Documentation messages: 319532 nosy: adelfino, docs@python priority: norma

[issue33860] doc Avoid "ordered dictionary" references now that dictionaries are ordered

2018-06-14 Thread Andrés Delfino
Andrés Delfino added the comment: Please note that DictReader already mentions "OrderedDict" as a type it returns now. I do see the issue you raise though and I'm not proposing to guarantee that type for next versions. I see the benefits of using weak names, but "dictionary

[issue33860] doc Avoid "ordered dictionary" references now that dictionaries are ordered

2018-06-14 Thread Andrés Delfino
New submission from Andrés Delfino : IMHO, using "ordered dictionaries" references is somewhat confusing now that dictionaries preserve insertion order. PR changes this references to "OrderedDict object". -- assignee: docs@python components: Documentation m

[issue33854] doc Add PEP title in seealso of Built-in Types

2018-06-13 Thread Andrés Delfino
Change by Andrés Delfino : -- keywords: +patch pull_requests: +7302 stage: -> patch review ___ Python tracker <https://bugs.python.org/issue33854> ___ ___ Py

[issue33854] doc Add PEP title in seealso of Built-in Types

2018-06-13 Thread Andrés Delfino
New submission from Andrés Delfino : Add PEP 461 title to Built-in Types seealso. -- assignee: docs@python components: Documentation messages: 319493 nosy: adelfino, docs@python priority: normal severity: normal status: open title: doc Add PEP title in seealso of Built-in Types type

[issue33726] Add short descriptions to PEP references in seealso

2018-06-13 Thread Andrés Delfino
Andrés Delfino added the comment: Yeah, I think you are right. The motivation for this PR was to not have two PEPs references in the same line, because, IMHO, it looks somewhat weird. Now, they look like: "See also: PEP 3115 - Metaclasses in Python 3 PEP 3129 - Class Decorators&qu

[issue33852] doc Remove parentheses from sequence subscription description

2018-06-13 Thread Andrés Delfino
Andrés Delfino added the comment: Thanks, Serhiy! Didn't know I should trace the LaTeX version. Guido, I'm adding you because it seems you authored or at least agreed on the current wording. Do you believe this proposal for improvement makes sense? -- nosy: +gvanrossum

[issue33852] doc Remove parentheses from sequence subscription description

2018-06-13 Thread Andrés Delfino
Change by Andrés Delfino : -- title: doc Remove parentheses from -> doc Remove parentheses from sequence subscription description ___ Python tracker <https://bugs.python.org/issu

[issue33852] doc Remove parentheses from

2018-06-13 Thread Andrés Delfino
New submission from Andrés Delfino : I think the idea of having "list" inside parentheses is to document that in case of sequences, only "one-expression" expression lists are legal. That being said, IMHO, explaining that in actual prose would be better, but removing the

[issue33845] Update Doc\make.bat on 2.7 to bring it on par to master version

2018-06-12 Thread Andrés Delfino
Andrés Delfino added the comment: I think I wasn't clear: I see no reason to not merge this right now. -- ___ Python tracker <https://bugs.python.org/issue33

[issue33845] Update Doc\make.bat on 2.7 to bring it on par to master version

2018-06-12 Thread Andrés Delfino
Andrés Delfino added the comment: Not really. I name all my first commits "Initial commit" as you gals/guys rename it anyways, and, also, it's usual to be asked for changes :) I might change my mind after my initial commit, but I only make pull requests when the first commit _se

[issue33847] doc: Add '@' operator entry to index

2018-06-12 Thread Andrés Delfino
Change by Andrés Delfino : -- keywords: +patch pull_requests: +7284 stage: -> patch review ___ Python tracker <https://bugs.python.org/issue33847> ___ ___ Py

[issue33847] doc: Add '@' operator entry to index

2018-06-12 Thread Andrés Delfino
New submission from Andrés Delfino : Currently, the index only refers to decorators for the @ symbol. PR adds entry for the matrix multiplication operator. -- assignee: docs@python components: Documentation messages: 319398 nosy: adelfino, docs@python priority: normal severity: normal

[issue33845] Update Doc\make.bat on 2.7 to bring it on par to master version

2018-06-12 Thread Andrés Delfino
Change by Andrés Delfino : -- keywords: +patch pull_requests: +7282 stage: -> patch review ___ Python tracker <https://bugs.python.org/issue33845> ___ ___ Py

[issue33845] Update Doc\make.bat on 2.7 to bring it on par to master version

2018-06-12 Thread Andrés Delfino
New submission from Andrés Delfino : PR makes the necessary changes to make Doc\make.bat the same as the master version, except some small differences. This should help backports. -- components: Windows messages: 319392 nosy: adelfino, paul.moore, steve.dower, tim.golden, zach.ware

[issue33831] Make htmlview work in make.bat

2018-06-11 Thread Andrés Delfino
Andrés Delfino added the comment: Thanks, Steve! -- resolution: -> fixed stage: patch review -> resolved status: open -> closed ___ Python tracker <https://bugs.python.or

[issue33832] Make "magic methods" a little more discoverable in the docs

2018-06-11 Thread Andrés Delfino
Change by Andrés Delfino : -- keywords: +patch pull_requests: +7249 stage: -> patch review ___ Python tracker <https://bugs.python.org/issue33832> ___ ___ Py

[issue33832] Make "magic methods" a little more discoverable in the docs

2018-06-11 Thread Andrés Delfino
New submission from Andrés Delfino : PR adds "magic method" to the glossary, and adds a mention in Data Model 3.3. Special method names. -- assignee: docs@python components: Documentation messages: 319300 nosy: adelfino, docs@python priority: normal severity: normal status:

[issue33831] Make htmlview work in make.bat

2018-06-11 Thread Andrés Delfino
Change by Andrés Delfino : -- keywords: +patch pull_requests: +7247 stage: -> patch review ___ Python tracker <https://bugs.python.org/issue33831> ___ ___ Py

[issue33831] Make htmlview work in make.bat

2018-06-11 Thread Andrés Delfino
New submission from Andrés Delfino : The start command understands the first quoted string as the window title, so nothing is being executed right now. PR fixes this. -- components: Windows messages: 319298 nosy: adelfino, paul.moore, steve.dower, tim.golden, zach.ware priority

[issue33825] Change mentions of "magic" attributes to "special"

2018-06-11 Thread Andrés Delfino
Andrés Delfino added the comment: ok :) -- resolution: -> not a bug stage: patch review -> resolved status: open -> closed ___ Python tracker <https://bugs.python.or

[issue33825] Change mentions of "magic" attributes to "special"

2018-06-10 Thread Andrés Delfino
New submission from Andrés Delfino : PR makes all documentation use the same term. -- assignee: docs@python components: Documentation messages: 319263 nosy: adelfino, docs@python priority: normal severity: normal status: open title: Change mentions of "magic" attributes t

[issue33825] Change mentions of "magic" attributes to "special"

2018-06-10 Thread Andrés Delfino
Change by Andrés Delfino : -- keywords: +patch pull_requests: +7231 stage: -> patch review ___ Python tracker <https://bugs.python.org/issue33825> ___ ___ Py

[issue33819] Mention "ordered mapping" instead of "ordered dictionary" in email module

2018-06-10 Thread Andrés Delfino
Change by Andrés Delfino : -- keywords: +patch pull_requests: +7208 stage: -> patch review ___ Python tracker <https://bugs.python.org/issue33819> ___ ___ Py

[issue33819] Mention "ordered mapping" instead of "ordered dictionary" in email module

2018-06-10 Thread Andrés Delfino
New submission from Andrés Delfino : IMHO, we should replace the "ordered dictionary" with "ordered mapping" now that regular dictionaries are ordered. I'm proposing "ordered mapping" instead of "dictionary" because there's no actual dictionary beh

[issue33816] New metaclass example for Data Model topic

2018-06-09 Thread Andrés Delfino
Change by Andrés Delfino : -- keywords: +patch pull_requests: +7197 stage: -> patch review ___ Python tracker <https://bugs.python.org/issue33816> ___ ___ Py

[issue33816] New metaclass example for Data Model topic

2018-06-09 Thread Andrés Delfino
Andrés Delfino added the comment: To what section are you refering by "the entire section"? On a side note: I'll make a PR to remove the example. IMHO, there should be an example to give some idea of what a metaclass can do, but the current example is no longer useful and it's

[issue33816] New metaclass example for Data Model topic

2018-06-09 Thread Andrés Delfino
Andrés Delfino added the comment: I'm talking about the example in Data Model, 3.3.3.6. -- ___ Python tracker <https://bugs.python.org/issue33816> ___ ___ Pytho

[issue33816] New metaclass example for Data Model topic

2018-06-09 Thread Andrés Delfino
New submission from Andrés Delfino : Since Python 3.6, when PEP 520 was accepted, class attribute definition order is preserved. That alone is sufficient to replace the example, but then 3.7 came with guaranteed dictionary insertion order. The metaclass example uses OrderedDict, what may

[issue33799] Remove non-ordered dicts comments from FAQ

2018-06-08 Thread Andrés Delfino
Change by Andrés Delfino : -- resolution: -> fixed stage: patch review -> resolved status: open -> closed type: -> enhancement ___ Python tracker <https://bugs.python

[issue33804] Document the default value of the size parameter of io.TextIOBase.read

2018-06-07 Thread Andrés Delfino
Change by Andrés Delfino : -- keywords: +patch pull_requests: +7138 stage: -> patch review ___ Python tracker <https://bugs.python.org/issue33804> ___ ___ Py

[issue33804] Document the default value of the size parameter of io.TextIOBase.read

2018-06-07 Thread Andrés Delfino
New submission from Andrés Delfino : Documentation of io.TextIOBase.read makes it look like the size parameter is required. Attached PR fixes this. -- assignee: docs@python components: Documentation messages: 319003 nosy: adelfino, docs@python priority: normal severity: normal status

[issue33801] Remove non-ordered dict comment from plistlib

2018-06-07 Thread Andrés Delfino
Change by Andrés Delfino : -- keywords: +patch pull_requests: +7120 stage: -> patch review ___ Python tracker <https://bugs.python.org/issue33801> ___ ___ Py

[issue33801] Remove non-ordered dict comment from plistlib

2018-06-07 Thread Andrés Delfino
New submission from Andrés Delfino : plistlib documentation says: "The exact structure of the plist can be recovered by using collections.OrderedDict (although the order of keys shouldn't be important in plist files)" This is no longer necessary, since dict objects preserve inser

[issue33800] Fix default argument for parameter dict_type of ConfigParser/RawConfigParser

2018-06-07 Thread Andrés Delfino
Change by Andrés Delfino : -- keywords: +patch pull_requests: +7119 stage: -> patch review ___ Python tracker <https://bugs.python.org/issue33800> ___ ___ Py

[issue33800] Fix default argument for parameter dict_type of ConfigParser/RawConfigParser

2018-06-07 Thread Andrés Delfino
New submission from Andrés Delfino : Default argument of parameter dict_type of ConfigParser/RawConfigParser is shown as "collections.OrderedDict", while it recently migrated to "dict". PR fixes this, documents the change to dict, and fixes a versionchanged changed

[issue33799] Remove non-ordered dicts comments from FAQ

2018-06-07 Thread Andrés Delfino
Change by Andrés Delfino : -- keywords: +patch pull_requests: +7117 stage: -> patch review ___ Python tracker <https://bugs.python.org/issue33799> ___ ___ Py

[issue33799] Remove non-ordered dicts comments from FAQ

2018-06-07 Thread Andrés Delfino
New submission from Andrés Delfino : Both Design and Programming sections have comments related to the non-ordered dict implementation. PR removes those comments. -- assignee: docs@python components: Documentation messages: 318964 nosy: adelfino, docs@python priority: normal severity

[issue33798] Fix csv module comment regarding dict insertion order

2018-06-07 Thread Andrés Delfino
Change by Andrés Delfino : -- keywords: +patch pull_requests: +7115 stage: -> patch review ___ Python tracker <https://bugs.python.org/issue33798> ___ ___ Py

[issue33798] Fix csv module comment regarding dict insertion order

2018-06-07 Thread Andrés Delfino
New submission from Andrés Delfino : The csv module says "Python’s dict objects are not ordered". PR fixes this , leaving a comment on the rationale. -- assignee: docs@python components: Documentation messages: 318961 nosy: adelfino, docs@python priority: normal severity: nor

[issue33696] Install python-docs-theme even if SPHINXBUILD is defined

2018-06-02 Thread Andrés Delfino
Change by Andrés Delfino : -- resolution: -> fixed stage: patch review -> resolved status: open -> closed ___ Python tracker <https://bugs.python.or

[issue33726] Add short descriptions to PEP references in seealso

2018-05-31 Thread Andrés Delfino
Change by Andrés Delfino : -- keywords: +patch pull_requests: +6922 stage: -> patch review ___ Python tracker <https://bugs.python.org/issue33726> ___ ___ Py

[issue33726] Add short descriptions to PEP references in seealso

2018-05-31 Thread Andrés Delfino
New submission from Andrés Delfino : There are a couple of PEP references with no description in Simple/Compound Statements. Attached PR fixes this. -- assignee: docs@python components: Documentation messages: 318359 nosy: adelfino, docs@python priority: normal severity: normal status

[issue33702] Add some missings links in production lists and a little polish

2018-05-30 Thread Andrés Delfino
Change by Andrés Delfino : -- keywords: +patch pull_requests: +6886 stage: -> patch review ___ Python tracker <https://bugs.python.org/issue33702> ___ ___ Py

[issue33702] Add some missings links in production lists and a little polish

2018-05-30 Thread Andrés Delfino
New submission from Andrés Delfino : There are some missing links in production lists (try, with, from __future__ import), and function and coroutines definitions production lists have too long lines. PR fixes this and does some polish on whitespace. -- assignee: docs@python

[issue33699] Don't describe try's else clause in a footnote

2018-05-30 Thread Andrés Delfino
Change by Andrés Delfino : -- keywords: +patch pull_requests: +6881 stage: -> patch review ___ Python tracker <https://bugs.python.org/issue33699> ___ ___ Py

[issue33699] Don't describe try's else clause in a footnote

2018-05-30 Thread Andrés Delfino
New submission from Andrés Delfino : This behavior has not changed in 11 years so I think it's safe to describe the "else" clause along the rest of the "try" clause. Attached PR fixes this. -- assignee: docs@python components: Documentation messages: 318205 nosy: a

[issue33696] Install python-docs-theme even if SPHINXBUILD is defined

2018-05-30 Thread Andrés Delfino
Change by Andrés Delfino : -- keywords: +patch pull_requests: +6868 stage: -> patch review ___ Python tracker <https://bugs.python.org/issue33696> ___ ___ Py

[issue33696] Install python-docs-theme even if SPHINXBUILD is defined

2018-05-30 Thread Andrés Delfino
New submission from Andrés Delfino : On bug 33673, I fixed python-docs-theme only getting installed if SPHINXBUILD was not defined and Sphinx was not installed, which was an improvement, but not the correct fix for python-docs-theme installation. Now, python-docs-theme is getting installed

[issue33670] Use errorlevel of Sphinx main() in Doc\make.bat

2018-05-29 Thread Andrés Delfino
Change by Andrés Delfino : -- pull_requests: +6836 stage: backport needed -> patch review ___ Python tracker <https://bugs.python.org/issue33670> ___ ___ Py

<    1   2   3   >