How to see the issue:
1. Open "library.pdf" (part of "python-3.9.1-docs-pdf-a4.zip" archive).
2. Search for the heading "strftime() and strptime() Format Codes".
3. Scroll to the end of the table; it is truncated. Also, the 8.1
heading is "superimposed" on the table towards the end, although it
actually appears much earlier in this document.
I have attached a screenshot of the issue.
=== MiniLockId ===
New submission from Luciano Ramalho <luciano(a)ramalho.org>:
functools.cached_property is a great addition to the standard library, thanks!
However, the docs do not say that @cached_property produces a non-overriding descriptor, in contrast with @property.
If a user replaces a @property with a @cached_property, her code may or may not break depending on the existence of an instance attribute with the same name as the decorated method. This is surprising and may affect correctness, so it deserves even more attention than the possible performance loss already mentioned in the docs, related to the shared-dict optimization.
In the future, perhaps we can add an argument to @cached_property to optionally make it produce overriding descriptors.
nosy: docs@python, ramalho
title: functools.cached_property docs should explain that it is non-overriding
versions: Python 3.10, Python 3.8, Python 3.9
Python tracker <report(a)bugs.python.org>