[issue33518] Add PEP to glossary

2018-05-17 Thread Andrés Delfino
Change by Andrés Delfino : -- pull_requests: +6605 ___ Python tracker <https://bugs.python.org/issue33518> ___ ___ Python-bugs-list mailing list Unsubscribe:

[issue33518] Add PEP to glossary

2018-05-17 Thread Andrés Delfino
Change by Andrés Delfino : -- pull_requests: +6606 ___ Python tracker <https://bugs.python.org/issue33518> ___ ___ Python-bugs-list mailing list Unsubscribe:

[issue33459] Fix "tuple display" mention in Expressions

2018-05-17 Thread Andrés Delfino
Andrés Delfino added the comment: I'm restoring the original title since we are not sure it was incorrect after all. I have also updated the PR to remove the tuple display entry from the index. -- title: Define "tuple display" in the docs -> Fix "tu

[issue33571] Add triple quotes to list of delimiters that trigger '...' prompt

2018-05-18 Thread Andrés Delfino
Change by Andrés Delfino : -- assignee: docs@python components: Documentation nosy: adelfino, docs@python priority: normal severity: normal status: open title: Add triple quotes to list of delimiters that trigger '...' prompt type: enhancement versions: Python 2.7, Python 3

[issue33571] Add triple quotes to list of delimiters that trigger '...' prompt

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

[issue33580] Make binary/text file glossary entries follow most common "see also" style

2018-05-19 Thread Andrés Delfino
New submission from Andrés Delfino : While most entries don't show "see also" as a separate block, binary/text file entries do. I'm proposing to change this. -- assignee: docs@python components: Documentation messages: 317135 nosy: adelfino, docs@python prior

[issue33580] Make binary/text file glossary entries follow most common "see also" style

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

[issue33595] FIx references to lambda "arguments"

2018-05-21 Thread Andrés Delfino
New submission from Andrés Delfino : There a couple of references to lambda parameters mentioned as arguments. I'm proposing fixing them. -- assignee: docs@python components: Documentation messages: 317255 nosy: adelfino, docs@python priority: normal severity: normal status: open

[issue33595] FIx references to lambda "arguments"

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

[issue33580] Make binary/text file glossary entries follow most common "see also" style

2018-05-22 Thread Andrés Delfino
Andrés Delfino added the comment: This one can be closed, right? -- ___ Python tracker <https://bugs.python.org/issue33580> ___ ___ Python-bugs-list mailin

[issue33602] Remove set and queue references from Data Types

2018-05-22 Thread Andrés Delfino
New submission from Andrés Delfino : Data Types mentions sets (which are now built-in) and synchronized queues (now mentioned in Concurrent Execution). I'm proposing fixing this. PR also adds mention to bytearray. -- assignee: docs@python components: Documentation messages: 3

[issue33602] Remove set and queue references from Data Types

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

[issue32769] Add 'annotations' to the glossary

2018-05-26 Thread Andrés Delfino
Change by Andrés Delfino : -- pull_requests: +6762 ___ Python tracker <https://bugs.python.org/issue32769> ___ ___ Python-bugs-list mailing list Unsubscribe:

[issue32769] Add 'annotations' to the glossary

2018-05-26 Thread Andrés Delfino
Change by Andrés Delfino : -- pull_requests: +6763 ___ Python tracker <https://bugs.python.org/issue32769> ___ ___ Python-bugs-list mailing list Unsubscribe:

[issue32769] Add 'annotations' to the glossary

2018-05-26 Thread Andrés Delfino
Change by Andrés Delfino : -- pull_requests: +6765 ___ Python tracker <https://bugs.python.org/issue32769> ___ ___ Python-bugs-list mailing list Unsubscribe:

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

2018-05-28 Thread Andrés Delfino
New submission from Andrés Delfino : Doc\make.bat is exiting without exposing Sphinx's main() return value, showing weird things like: C:\Users\adelfino\Desktop\Personal\repos\cpython\Doc>make venv Using py -3.6 (found with py.exe) Merging Misc/NEWS with py -3.6 -m blurb Running Sphin

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

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

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

2018-05-28 Thread Andrés Delfino
Andrés Delfino added the comment: After the PR: C:\Users\adelfino\Desktop\Personal\repos\cpython\Doc>make venv Using py -3.6 (found with py.exe) Merging Misc/NEWS with py -3.6 -m blurb Running Sphinx v1.7.4 Sphinx error: Builder name venv not registered or available through entry point Bu

[issue33673] Install python-docs-theme even if Sphinx is already installed

2018-05-28 Thread Andrés Delfino
New submission from Andrés Delfino : python-docs-theme is being installed only if Sphinx is not installed too. PR fixes this. -- components: Demos and Tools messages: 317892 nosy: adelfino priority: normal severity: normal status: open title: Install python-docs-theme even if Sphinx is

[issue33673] Install python-docs-theme even if Sphinx is already installed

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

[issue33673] Install python-docs-theme even if Sphinx is already installed

2018-05-28 Thread Andrés Delfino
Andrés Delfino added the comment: This applies to Windows's make.bat. -- ___ Python tracker <https://bugs.python.org/issue33673> ___ ___ Python-bugs-list m

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

2018-05-28 Thread Andrés Delfino
Andrés Delfino added the comment: Np! I'll take care of the backport :) -- ___ Python tracker <https://bugs.python.org/issue33670> ___ ___ Python-bugs-list m

[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

[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

[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

[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 no

[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

[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

[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

[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

[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

[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

[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

[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

[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

[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

[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 direc

[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

[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

[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

[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

[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

[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

[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

[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> ___ ___

[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

[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

[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 dict

[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

[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

[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

[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

[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

[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:

[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

[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

[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

[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

[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

[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

[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 _

[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/is

[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

[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 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: +

[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"

[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

[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

[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

[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 "dicti

[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

[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
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):

[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.

[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

[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: 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&#

[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, t

[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: 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 exactl

[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: 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 track

[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 OrderedD

[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 dictionar

[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

[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

[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

[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/is

[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

[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/is

[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: Sorry, for some reason the PR doesn't show the intended changes. I'm working on fixing it. -- ___ Python tracker <https://bugs.python.o

[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

[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@p

[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

[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: ade

[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

[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

[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

<    1   2   3   >