Mailman 3 April 2021 - docs

[issue35114] ssl.RAND_status docs describe it as returning True/False; actually returns 1/0
by Josh Rosenberg April 23, 2021

April 23, 2021

New submission from Josh Rosenberg <shadowranger+python(a)gmail.com>: The ssl.RAND_status online docs say (with code format on True/False): "Return True if the SSL pseudo-random number generator has been seeded with ‘enough’ randomness, and False otherwise." This is incorrect; the function actually returns 1 or 0 (and the docstring agrees). Fix can be one of: 1. Update docs to be less specific about the return type (use true/false, not True/False) 2. Update docs to match docstring (… [View More]

4 4

Problems with the documentation
by Tamás Gombos April 23, 2021

April 23, 2021

Hi, I've been trying to upload the documentation to Google Play Books and I can't. I tried every file format that you have posted here: https://docs.python.org/3/download.html Every time, it just hangs for a long time then says Upload Failed. I also tried to convert them to other formats and then to .epub and the conversions failed too. This is why I suspect that something might be wrong with the files themselves. Can you help, please? Regards, Tamas

2 1

[issue11977] Document int.conjugate, .denominator, ...
by Jonas H. April 23, 2021

April 23, 2021

New submission from Jonas H. <jonas(a)lophus.org>: Various `int` attributes and methods seem undocumented (at least it does not work to intersphinx them): * .conjugate * .denominator * .imag * .numerator * .real ---------- assignee: docs@python components: Documentation messages: 134926 nosy: docs@python, jonash priority: normal severity: normal status: open title: Document int.conjugate, .denominator, ... versions: Python 2.7 _______________________________________ Python tracker … [View More]

6 8

[issue32133] documentation: numbers module nitpick
by abcdef April 23, 2021

April 23, 2021

New submission from abcdef <x(a)mailinator.com>: 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() <numbers.Number object at 0x7fcccc71f3c0> >>> numbers.Real() Traceback (most recent call last): File "<stdin>", line 1, in <module> TypeError: Can't … [View More]

2 1

[issue43804] Add more info about building C/C++ Extensions on Windows using MSVC
by Shreyan Avigyan April 23, 2021

April 23, 2021

New submission from Shreyan Avigyan <shreyan.avigyan(a)gmail.com>: In the context of Docs/extending/windows.rst, the command provided, for compiling the source code and linking the libraries to create a DLL, only works for Python 32-bit versions. But the documentation doesn't inform anything about that. The PR linked with this issue adds a note section with the text :- """ The above commands are only applicable for Python 32-bit versions. """ This PR is against the master branch and … [View More]

3 12

[issue43602] Include Decimal's in numbers.Real
by Sergey B Kirpichev April 23, 2021

April 23, 2021

New submission from Sergey B Kirpichev <skirpichev(a)gmail.com>: Commit 82417ca9b2 includes Decimal's in the numbers tower, but only as an implementation of the abstract numbers.Number. The mentioned reason is "Decimals are not interoperable with floats" (see comments in the numbers.py as well), i.e. there is no lossless conversion (in general, in both directions). While this seems to be reasonable, there are arguments against: 1) The numbers module docs doesn't assert there should be … [View More]

4 13

[issue43877] Logging Cookbook ambiguity
by Gene Ratzlaff April 23, 2021

April 23, 2021

New submission from Gene Ratzlaff <generatz(a)gmail.com>: In the section titled "Logging to a single file from multiple processes" I am puzzled by the second example, as follows: The first example has the listener/logger is in a separate >process< and the listener/logger process is (as I would anticipate) started >before< the worker/sender processes. In the 2nd example, the listener/logger is in a separate >thread< and the listener/logger thread is (oddly) started >… [View More]

3 4

[issue43917] An error in classmethod example in the documentation of descriptor
by Egor April 23, 2021

April 23, 2021

New submission from Egor <pixel.egor(a)gmail.com>: In this section https://docs.python.org/3/howto/descriptor.html#class-methods in the example of python implementation of ClassMethod inside __get__ method I think that we should check hasattr(self.f, "__get__") instead of hasattr(obj, "__get__"). ---------- assignee: docs@python components: Documentation messages: 391638 nosy: docs@python, rhettinger, titanolodon priority: normal severity: normal status: open title: An error in … [View More]

4 8

[issue39572] [typing] TypedDict's 'total' argument is undocumented
by Brett Cannon April 23, 2021

April 23, 2021

New submission from Brett Cannon <brett(a)python.org>: The docs mention __total__, but there's no mention of how to actually set that attribute, nor what it actually represents. P.S. https://github.com/python/cpython/blob/master/Lib/typing.py#L16 says TypedDict "may be added soon"; I think that's outdated. ;) ---------- assignee: docs@python components: Documentation messages: 361503 nosy: brett.cannon, docs@python, gvanrossum, levkivskyi priority: normal severity: normal stage: needs … [View More]

5 16

[issue21352] improve indexing
by bob gailer April 22, 2021

April 22, 2021

New submission from bob gailer: Inconsistencies / confusion with documentation Index Tab. Example (line numbers added for comments that follow): 1 max 2 built-in function 3 max (datetime.date attribute) 4 (datetime.datetime attribute) 5 (datetime.time attribute) 6 max() built-in function 7 (decimal.Context method) 8 (decimal.Decimal method) 9 (in module audioloop) The following all lead to confusion and frustration: Having 3 rows (1, 3, 6)that begin with max. Having an entry (1)… [View More]

7 6