Mailman 3 September 2021 - docs

A suggestion for improving the documentation of chapter 10.9. Data Compression
by Guy Goldner May 22, 2024

May 22, 2024

Hello dear Python gods :) I'm new at Python and was going over the documentation . This useful paragraph : https://docs.python.org/3.7/tutorial/stdlib.html#data-compression provides info for compressing text but IMHO some important additional info is needed, without which I expect nearly all users would get stuck just as I have. Moreover, while looking for a solution I noticed a lot of articles with outdated examples which no longer work - this confused me even more to the point I started … [View More]

2 2

SMTPHandler secure argument without credentials
by William Edwards Sept. 15, 2022

Sept. 15, 2022

logging.handlers.SMTPHandler only uses the 'secure' argument when credentials are specified. https://docs.python.org/3/library/logging.handlers.html#logging.handlers.SM… says: "To specify the use of a secure protocol (TLS), pass in a tuple to the secure argument. This will only be used when authentication credentials are supplied." The docstring confirms this, but I can't find an explanation of the intent behind this behaviour. Perhaps it would be a good idea to describe this as well.

1 1

Bug in Python.
by Prakash Mudholkar Feb. 7, 2022

Feb. 7, 2022

Hello - I wish to bring to your kind notice a bug in Python. Given any matrix X. While trying to compute the CoVariance matrix of that matrix X, Python does NOT compute the CoVarianceof the given matrix X. Instead, Python comptes the CoVariance of the Transpose of the given matrix X. This appears to be a bug in Python. Please refer to the below website for a given matrix and what the result should be after the computation of it's CoVariance. And I have provided a screenshot of what Python … [View More]

3 2

Re: <documentation>In section 4.6. Defining Functions, It should be print(a,end==' ') in place of print(a, end=' ') (Ruchi Sharma)
by Twinkle Toes Sept. 26, 2021

Sept. 26, 2021

Hi Rushi Sharma, The documentation is correct, it is print(a, end = ‘ ’). The syntax error is from your code. Regards, Lateefah. On Sun, 26 Sep 2021 at 5:35 PM, <docs-request(a)python.org> wrote: > Send docs mailing list submissions to > docs(a)python.org > > To subscribe or unsubscribe via the World Wide Web, visit > https://mail.python.org/mailman3/lists/docs.python.org/ > or, via email, send a message with subject or body 'help' to > … [View More]docs-request(a)python.org > > You can reach the person managing the list at > docs-owner(a)python.org > > When replying, please edit your Subject line so it is more specific > than "Re: Contents of docs digest..."Today's Topics: > > 1. <documentation>In section 4.6. Defining Functions, It should be > print(a,end==' ') in place of print(a, end=' ') > (Ruchi Sharma) > 2. Re: <documentation>In section 4.6. Defining Functions, It should be > print(a,end==' ') in place of print(a, end=' ') > (Ruchi Sharma) > > > > ---------- Forwarded message ---------- > From: Ruchi Sharma <rohilla.ruchi(a)gmail.com> > To: docs(a)python.org > Cc: > Bcc: > Date: Sat, 25 Sep 2021 22:57:46 +0530 > Subject: [docs] <documentation>In section 4.6. Defining Functions, It > should be print(a,end==' ') in place of print(a, end=' ') > Hi Team, > > I am a beginner in python. I was going through the documentation for the > first time. > > This link: https://docs.python.org/3.8/tutorial/controlflow.html > In section 4.6. Defining Functions, It should be print(a,end==' '). "==" > in place of "=". > Please correct it. Let me correct if I am wrong. > > >>> def fib(n): # write Fibonacci series up to n ... """Print a Fibonacci > series up to n.""" ... a, b = 0, 1 ... while a < n: ... print(a, end=' ') ... > a, b = b, a+b ... print() ... >>> # Now call the function we just defined: ... > fib(2000) > > Regards, > Ruchi Sharma > > > > > ---------- Forwarded message ---------- > From: Ruchi Sharma <rohilla.ruchi(a)gmail.com> > To: docs(a)python.org > Cc: > Bcc: > Date: Sat, 25 Sep 2021 23:10:46 +0530 > Subject: [docs] Re: <documentation>In section 4.6. Defining Functions, It > should be print(a,end==' ') in place of print(a, end=' ') > In the reference to below email : > print(a, end=' ') > I am getting SyntaxError: invalid syntax after the above line code > Kindly help > > On Sat, 25 Sept 2021 at 22:57, Ruchi Sharma <rohilla.ruchi(a)gmail.com> > wrote: > >> Hi Team, >> >> I am a beginner in python. I was going through the documentation for the >> first time. >> >> This link: https://docs.python.org/3.8/tutorial/controlflow.html >> In section 4.6. Defining Functions, It should be print(a,end==' '). "==" >> in place of "=". >> Please correct it. Let me correct if I am wrong. >> >> >>> def fib(n): # write Fibonacci series up to n ... """Print a >> Fibonacci series up to n.""" ... a, b = 0, 1 ... while a < n: ... print(a, >> end=' ') ... a, b = b, a+b ... print() ... >>> # Now call the function >> we just defined: ... fib(2000) >> >> Regards, >> Ruchi Sharma >> >> _______________________________________________ > docs mailing list -- docs(a)python.org > To unsubscribe send an email to docs-leave(a)python.org > https://mail.python.org/mailman3/lists/docs.python.org/ > [View Less]

1 0

<documentation>In section 4.6. Defining Functions, It should be print(a,end==' ') in place of print(a, end=' ')
by Ruchi Sharma Sept. 26, 2021

Sept. 26, 2021

Hi Team, I am a beginner in python. I was going through the documentation for the first time. This link: https://docs.python.org/3.8/tutorial/controlflow.html In section 4.6. Defining Functions, It should be print(a,end==' '). "==" in place of "=". Please correct it. Let me correct if I am wrong. >>> def fib(n): # write Fibonacci series up to n ... """Print a Fibonacci series up to n.""" ... a, b = 0, 1 ... while a < n: ... print(a, end=' ') ... a, b = b, a+b ... print() ... >… [View More]

2 2

RFC: New/update the Docs Sphinx theme: responsive, edit page links,
by Wes Turner Sept. 22, 2021

Sept. 22, 2021

Where would be the best place to discuss or just improve the CPython docs sphinx theme? What would Python need in a {PyData,} Sphinx theme fork: - [ ] ENH: add <edit on github> links to every docs page - [ ] ENH: responsive breakpoints for mobile devices - [ ] ENH: responsive fonts - [ ] ENH: toggle-able dark theme - [ ] ENH: interactive code examples (in WASM with pyodide like JupyterLite) - [ ] ENH?: Two sidebars: {Global TOC} {Content} {Document TOC} The PyData theme [bandwagon, … [View More]

1 0

Re: Typo in contextvars.Token.old_value (Eric Irrgang)
by Twinkle Toes Sept. 21, 2021

Sept. 21, 2021

Hello all, Has anyone fixed it yet? Regards. On Tue, 14 Sep 2021 at 5:00 PM, <docs-request(a)python.org> wrote: > Send docs mailing list submissions to > docs(a)python.org > > To subscribe or unsubscribe via the World Wide Web, visit > https://mail.python.org/mailman3/lists/docs.python.org/ > or, via email, send a message with subject or body 'help' to > docs-request(a)python.org > > You can reach the person managing the list at > … [View More]

1 0

Typo in contextvars.Token.old_value
by Eric Irrgang Sept. 9, 2021

Sept. 9, 2021

For https://docs.python.org/3.7/library/contextvars.html#contextvars.contextvar… and newer, an "is" should be "if". Token.old_value says "It points to Token.MISSING is the variable..." instead of "It points to Token.MISSING if the variable..." (Per https://docs.python.org/3/bugs.html#documentation-bugs, I am "short on time") Cheers.

1 0

Thank you.
by Aaron Essilfie Sept. 6, 2021

Sept. 6, 2021

Hi Python Foundation, I'm from Ghana and I chanced on this beautiful pdf from your foundation on the Internet and I want to say thank you. I'm a beginner and I'm glad to have this material. Thank you so much. I want to use python in automation and chemical engineering so it's a great start for me. Thank you. Regards Aaron

1 0

Epub version
by trimder＠protonmail.com Sept. 5, 2021

Sept. 5, 2021

The epub version of docs is too big and therefore slow to use comfortably with the average e-reader. Maybe it would be better to split up the documentation into separate parts instead of combining it all together.

1 0