Mailman 3 April 2020 - docs

[issue40269] Inconsistent complex behavior with (-1j)
by Mark Dickinson April 13, 2020

April 13, 2020

Mark Dickinson <dickinsm(a)gmail.com> added the comment: > The Imaginary type could help to solve other "gotchas". Yes, it's an attractive proposition from many angles: e.g., multiplying by 1j could do the correct quarter-turn rotation in the complex plane, keeping all signs correct, so that multiplying a complex number z by 1j 4 times exactly recovers z, regardless of nans, infinities and signed zeros. C99's specification of (optional) imaginary types was supposed to solve exactly … [View More]

1 0

[issue40269] Inconsistent complex behavior with (-1j)
by Serhiy Storchaka April 13, 2020

April 13, 2020

Serhiy Storchaka <storchaka+cpython(a)gmail.com> added the comment: The Imaginary type could help to solve other "gotchas". For example, in Python >>> complex(0, float('inf')) * 1 (nan+infj) But in C++ you will get the real component 0, because multiplication of complex and real numbers is component wise. With the Imaginary type we could get that 1j * x == complex(0, x) for all float x, including infinity and NaN. Returning to the repr, the other way to correctly represent … [View More]

1 0

[issue40269] Inconsistent complex behavior with (-1j)
by Mark Dickinson April 13, 2020

April 13, 2020

Mark Dickinson <dickinsm(a)gmail.com> added the comment: See also #25839, #22548; there's lot of discussion of the core issue on those tickets. As Serhiy says, the only reasonable "true" fix would be to have 1j be a genuine imaginary literal, but that's a lot of work and potential disruption (not just to core Python, but to 3rd party libraries that care about complex numbers) for not a lot of gain. A documentation improvement as suggested by Raymond sounds good. I'm not keen on messing … [View More]

1 0

[issue13743] xml.dom.minidom.Document class is not documented
by Sandro Tosi April 12, 2020

April 12, 2020

New submission from Sandro Tosi <sandro.tosi(a)gmail.com>: Hello, following up http://mail.python.org/pipermail/docs/2012-January/007026.html I noticed the whole Document class (and relative methods) is not documented. Maybe it is a choice to not document it, or maybe it's just a missing doc, dunno, the's why I'm opening this :) ---------- assignee: docs@python components: Documentation messages: 150935 nosy: docs@python, sandro.tosi priority: normal severity: normal stage: needs patch … [View More]

6 9

[issue21760] inspect documentation describes module type inaccurately
by Eric Snow April 11, 2020

April 11, 2020

New submission from Eric Snow: In the documentation for the inspect module, the module type is described with just 2 of its potential 7 attributes. The language reference[2] and importlib docs[3] both provide an accurate list of module attributes. Furthermore, the description for __file__ should be fixed. It should be clear that __file__ reflects the location from which the module was loaded, that location is not necessarily a filename, and the attribute may not exist if the module was not … [View More]

4 5

About documentation
by jeevan Tutorial April 11, 2020

April 11, 2020

Your documentation is very helpful.so I am thanking you to make the documentation.

1 0

[issue40249] __import__ doesn't honour globals
by Stefan Seefeld April 11, 2020

April 11, 2020

Stefan Seefeld <stefan(a)seefeld.name> added the comment: OK, thanks for the clarification. I think this is obscure enough to warrant at least a paragraph or two to clarify the semantics of these arguments. I changed the issue "components" and "type" to reflect that. ---------- assignee: -> docs@python components: +Documentation -Interpreter Core nosy: +docs@python type: behavior -> enhancement _______________________________________ Python tracker <report(a)bugs.python.org&… [View More]

1 0

[issue40205] Profile 'builtins' parameter documentation missing
by Bar Harel April 11, 2020

April 11, 2020

New submission from Bar Harel <bzvi7919(a)gmail.com>: Profile and cProfile's documentation does not say anything about the builtins parameter. Also, it exists only on cProfile, which means Profile is not a drop-in replacement. Lastly, enable() method, that exists on cProfile, also accepts params, and are undocumented. ---------- assignee: docs@python components: Documentation, Library (Lib) messages: 365859 nosy: bar.harel, docs@python priority: normal severity: normal status: open … [View More]

2 1

[issue40197] Add microseconds to timing table in What's new python 3.8
by Morten Hels April 10, 2020

April 10, 2020

New submission from Morten Hels <morten(a)hels.dk>: It is not immediately obvious to me what the units are in the timing table here: https://docs.python.org/3/whatsnew/3.8.html#demos-and-tools Clicking through to https://bugs.python.org/issue35884 shows that the unit is microseconds, but I think it would be helpful to many readers to put that information in the docs itself, e.g., "Here’s a summary of performance improvements since Python 3.3 (timings are in microseconds):" ---------- … [View More]

5 11

[issue40245] Add description meta tags to docs.python.org
by Andrew Zhou April 10, 2020

April 10, 2020

New submission from Andrew Zhou <andrewfzhou(a)gmail.com>: This isn't a particularly high priority, but it would be nice to have the first paragraph of docs pages show up when searched or posted in Slack, Discord, Twitter, etc. This is done through the description meta tag, as well as Open Graph, etc. As the description meta tag covers most of the potential use cases, the others can wait. What implementing this would entail is either manual addition of meta tags, or an automatic … [View More]

2 1