docs June 2022

docs@python.org

14 participants
9 discussions

SMTPHandler secure argument without credentials
by William Edwards 15 Sep '22

15 Sep '22

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

Requested Update in Slicing Method help files & Documentation
by outbox training info 27 Jun '22

27 Jun '22

Dear Team, Greetings about your tremendous work in the Python project. Here, we noticed Slicing methods syntax and its help doc may be confusing some people. *Default Slicing method syntax :* *[start:stop:step]* start : start position / indices value in the list. stop : stop position / indices value in the list. step : step up value here, we thought as stop position will be calculated as n-1. it is good for (positive) indexing. but, in negative indexing it will make some confusion. so, we think that, following would be best for everyone to be clear about slicing method syntax. *Requested Slicing method syntax update:* *[start_at:stop_before:step_up_jump]* start_at : start at the position / indices value in the list. stop_before : stop before the position / indices value in the list. step_up_jump : step up jump as per given value

1 0

Python 3.9.1 Documentation - Compressed documentation packages absent
by Lenina Lopez 25 Jun '22

25 Jun '22

To Python's Documentation team: Hi there! I've been trying to download Python 3.9.1 documentation set in pdf format at https://docs.python.org/release/3.9.1/download.html but the link is not working and returns an HTTP error 404 with the legend _The archive you're trying to download has not been built yet_. Thought you might wanna know. Cheers! L.// -- ·º·.·º·.·º·.[¥]__/*/º¨º¨Lenina Luciana V. Lopez /[¥] --=akt=-- //* LU 0xf8/0x04 *// (\__/) (='.'=)This is Bunny. Copy and paste bunny into (")_(")your signature to help him gain world domination.

1 0

Using Python on a Mac page out of date and erroneous
by Mark Woodman 18 Jun '22

18 Jun '22

Hi I’m sorry I don’t yet know what a sensible replacement description would be or I would suggest a fix, but the page on Python on a Mac is badly out of date: 3.10.5 Documentation » Python Setup and Usage » Using Python on a Mac It wrongly states that Python is pre-installed on MacOS (it’s not now), and thinks the Intel-based Macs are “new”, and that universal binaries are for Intel and Power PC, rather than Apple Silicon and Intel. I was hoping to set up a set of virtual environments for development on a Mac, with PC-style selectable interpreters, but the package installer from Python.org will not allow a location to be selected for installation, implying that only one instance of the interpreter is allowed, which seems a very backward step. Best regards ––– Prof. Mark Woodman, PhD Director, IT Changes Ltd. | Co-founder Digital Acumen linkedin.com/in/mark-woodman

3 2

Python 3.10.5 and OpenCV Bug
by Jathin Pranav Singaraju 18 Jun '22

18 Jun '22

To whom it may concern: I hope you are doing well! I have found a bug. Please see the details below: OpenCV Package's latest version (4.6.0.66) is incompatible with both Python 3.8.10 and Python 3.10.5. One of the OpenCV Package's previous versions (4.5.4.60) is also incompatible with Python 3.10.5. Therefore, I downgraded my Python from 3.10.5 to 3.8.10 and the OpenCV Package from 4.6.0.66 to 4.5.4.60. After that, it worked! All this occurs when I am trying to use Pyinstaller to convert my python file to an application. I believe that by making both Python and OpenCV latest versions compatible, this issue would be resolved. This is my first time reporting a bug, so I don't really know the process. Please resolve it so that I can continue with my project using the latest technology! Please let me know if you need anything else. Thank you, Pranav Singaraju

2 1

(RSVP)Python docs / PDF files / Licence question /
by Silpiö Kari 09 Jun '22

09 Jun '22

Hi At Haaga-Helia University of Applied Sciences (www.haaga-helia.fi), we are developing a new Python course that starts soon. We have a question regading the PDF versions of the Python documentation files. The PDF versions of the language reference etc. are available in a ZIP file on https://docs.python.org/3/download.html Therefore, the PDF files cannot be linked directly to our course pages. We are not sure about the copyright licence regarding those PDF files. That is, would we be allowed to extract the languge reference, library reference and tutorial from the ZIP file and add them to our course's home page. Or, are those files available for direct linking somewhere else? Kind regards, Kari Silpiö Senior lecturer Haaga-Helia University of Applied Sciences Finland

2 1

GEO-blocked link
by Grob Grobmann 08 Jun '22

08 Jun '22

Hi! I was reading the curses HOWTO <https://docs.python.org/3/howto/curses.html> and I realized that one of the links in the "for more information" section is set by the owner to block my country, Argentina (and who knows how many other countries). See attachment I don't think python should be redirecting traffic to a site that imposes arbitrary bans on IPs from an entire nation, for no good reason. Yours truly, Grob Grobmann

1 0

document download error
by Jack W Hallmark 06 Jun '22

06 Jun '22

I keep getting error 403 ' Forbidden' every time I try to download the version 3.10.4 documentation. Thanks! JW

2 1

Confusing documentation at cpython-test-docs.readthedocs.io
by Justin Su 06 Jun '22

06 Jun '22

Hi there, While Googling for "python 2 enum" (to see if Enums are available in Python 2), I found this strange result at the top: [image: Screen Shot 2022-06-03 at 4.10.50 PM.png] The link goes to https://cpython-test-docs.readthedocs.io/en/latest/library/enum.html. This seems like a pretty outdated (test?) version of the docs, given that the homepage is versioned at Python 2.7.6. However, the contents seem to be documentation for Python 3, which is a little confusing. Is there some way this could be updated or entirely removed? Best, Justin

3 2

2023

2022

2021

2020

2019

2018

2017

2016

2015

2014

2013

2012

2011

2010

docs June 2022