[issue34203] documentation: recommend Python 3 over 2 in faq

2019-02-18 Thread abcdef
abcdef added the comment: Thank you. I understand this is fixed now and I'm marking the ticket as closed. -- resolution: -> fixed stage: patch review -> resolved status: open -> closed ___ Python tracker <https://bugs.pyth

[issue32133] documentation: numbers module nitpick

2017-11-25 Thread abcdef
New submission from abcdef : Documentation of the numbers module: https://docs.python.org/3/library/numbers.html states "None of the types defined in this module can be instantiated." This is true for Complex, Real, Rational, Integral but not for Number: >>> numbers.Number(

[issue32142] heapq.heappop - documentation misleading or doesn't work

2017-11-26 Thread abcdef
abcdef added the comment: > Perhaps heappop could say that the heap invariant is maintained if the heap > is properly sorted before the heappop invocation. Honestly I like this wording less. "Properly sorted" would suggest sorted in the sense of heap.sort() [as the do

[issue34203] documentation: recommend Python 3 over 2 in faq

2018-07-23 Thread abcdef
New submission from abcdef : FAQ "How stable is Python" https://docs.python.org/3/faq/general.html#how-stable-is-python"; states "There are two recommended production-ready versions at this point in time, because at the moment there are two branches of stable releases: 2.

[issue16380] true/proper subset

2012-11-01 Thread abcdef
New submission from abcdef: The documentation http://docs.python.org/2.7/library/stdtypes.html#set-types-set-frozenset http://docs.python.org/3/library/stdtypes.html#set-types-set-frozenset of "<" for sets uses "true subset" and "true superset". The correct

[issue20735] Documentation: mark stringprep as deprecated

2014-02-22 Thread abcdef
New submission from abcdef: This is a nitpick, but the documentation is not clear whether the stringprep module is deprecated or not. It is listed as "Deprecated" on http://docs.python.org/3.3/py-modindex.html#cap-s but there's no information on http://docs.python.

[issue17920] Documentation: "complete ordering" should be "total ordering"

2013-05-06 Thread abcdef
New submission from abcdef: The set documentation [http://docs.python.org/3.4/library/stdtypes.html] states "The subset and equality comparisons do not generalize to a complete ordering function. For example, any two disjoint sets are not equal and are not subsets of each other...&qu

[issue17920] Documentation: "complete ordering" should be "total ordering"

2013-05-06 Thread abcdef
abcdef added the comment: Another small thing: "For example, any two disjoint sets are not equal and are not subsets of each other, so all of the following return False: ab." It should be "any two nonempty disjoint sets". -- __