gh-96265: Formatting changes for faq/programming#98242
gh-96265: Formatting changes for faq/programming#98242ezio-melotti merged 6 commits intopython:mainfrom
Conversation
CAM-Gerlach
left a comment
There was a problem hiding this comment.
Thanks. Could you also fix the warnings? Some of them I address below and the rest are similar to before, e.g. :meth:`__del__` when they should be :meth:`~object.__del__`, and the rest are correct, but the targets just don't exist as they should yet, and will be fixed as discussed in #86272.
List of warnings
C:\Users\C. A. M. Gerlach\Documents\dev\Python\cpython\test\Doc\faq\programming.rst:455: WARNING: py:meth reference target not found: list.append
C:\Users\C. A. M. Gerlach\Documents\dev\Python\cpython\test\Doc\faq\programming.rst:1017: WARNING: c:func reference target not found: sscanf
C:\Users\C. A. M. Gerlach\Documents\dev\Python\cpython\test\Doc\faq\programming.rst:1342: WARNING: py:meth reference target not found: __iadd__
C:\Users\C. A. M. Gerlach\Documents\dev\Python\cpython\test\Doc\faq\programming.rst:1342: WARNING: py:meth reference target not found: list.extend
C:\Users\C. A. M. Gerlach\Documents\dev\Python\cpython\test\Doc\faq\programming.rst:1342: WARNING: py:meth reference target not found: list.extend
C:\Users\C. A. M. Gerlach\Documents\dev\Python\cpython\test\Doc\faq\programming.rst:1373: WARNING: py:meth reference target not found: __iadd__
C:\Users\C. A. M. Gerlach\Documents\dev\Python\cpython\test\Doc\faq\programming.rst:1550: WARNING: py:meth reference target not found: __setattr__
C:\Users\C. A. M. Gerlach\Documents\dev\Python\cpython\test\Doc\faq\programming.rst:1561: WARNING: py:meth reference target not found: __setattr__
C:\Users\C. A. M. Gerlach\Documents\dev\Python\cpython\test\Doc\faq\programming.rst:1699: WARNING: py:meth reference target not found: __del__
C:\Users\C. A. M. Gerlach\Documents\dev\Python\cpython\test\Doc\faq\programming.rst:1703: WARNING: py:meth reference target not found: __del__
C:\Users\C. A. M. Gerlach\Documents\dev\Python\cpython\test\Doc\faq\programming.rst:1703: WARNING: py:meth reference target not found: __del__
C:\Users\C. A. M. Gerlach\Documents\dev\Python\cpython\test\Doc\faq\programming.rst:1714: WARNING: py:meth reference target not found: __del__
C:\Users\C. A. M. Gerlach\Documents\dev\Python\cpython\test\Doc\faq\programming.rst:1714: WARNING: py:meth reference target not found: __del__
C:\Users\C. A. M. Gerlach\Documents\dev\Python\cpython\test\Doc\faq\programming.rst:1734: WARNING: py:meth reference target not found: __del__
C:\Users\C. A. M. Gerlach\Documents\dev\Python\cpython\test\Doc\faq\programming.rst:1849: WARNING: py:meth reference target not found: collections.abc.Sequence.__contains__
CAM-Gerlach
left a comment
There was a problem hiding this comment.
A few more minor tweaks, some more than possibilities than anything, otherwise LGTM
Co-authored-by: C.A.M. Gerlach <[email protected]>
Thanks for the detailed reviews too! |
|
@ezio-melotti Could you take a peek at this one? I think it should be good to go |
|
Thanks @slateny for the PR, and @ezio-melotti for merging it 🌮🎉.. I'm working now to backport this PR to: 3.10, 3.11. |
|
Sorry, @slateny and @ezio-melotti, I could not cleanly backport this to |
* Formatting changes for faq/programming * Add missing method formatting, use non-literal formatting * Fix sphinx warnings * Some extra formatting missed earlier * More formatting suggestions from review Co-authored-by: C.A.M. Gerlach <[email protected]> * Add missing colon, avoid referening external module (cherry picked from commit 0689b99) Co-authored-by: Stanley <[email protected]> Co-authored-by: C.A.M. Gerlach <[email protected]>
|
GH-98991 is a backport of this pull request to the 3.11 branch. |
|
Thanks @slateny for the PR, and @ezio-melotti for merging it 🌮🎉.. I'm working now to backport this PR to: 3.10. |
|
Sorry @slateny and @ezio-melotti, I had trouble checking out the |
* Formatting changes for faq/programming * Add missing method formatting, use non-literal formatting * Fix sphinx warnings * Some extra formatting missed earlier * More formatting suggestions from review Co-authored-by: C.A.M. Gerlach <[email protected]> * Add missing colon, avoid referening external module (cherry picked from commit 0689b99) Co-authored-by: Stanley <[email protected]> Co-authored-by: C.A.M. Gerlach <[email protected]>
…GH-98242) * Formatting changes for faq/programming * Add missing method formatting, use non-literal formatting * Fix sphinx warnings * Some extra formatting missed earlier * More formatting suggestions from review Co-authored-by: C.A.M. Gerlach <[email protected]> * Add missing colon, avoid referening external module Co-authored-by: C.A.M. Gerlach <[email protected]>. (cherry picked from commit 0689b99) Co-authored-by: Stanley <[email protected]>
|
GH-98994 is a backport of this pull request to the 3.10 branch. |
…98994) * Formatting changes for faq/programming * Add missing method formatting, use non-literal formatting * Fix sphinx warnings * Some extra formatting missed earlier * More formatting suggestions from review Co-authored-by: C.A.M. Gerlach <[email protected]> * Add missing colon, avoid referening external module Co-authored-by: C.A.M. Gerlach <[email protected]>. (cherry picked from commit 0689b99) Co-authored-by: Stanley <[email protected]>
| print(config.x) | ||
|
|
||
| Note that using a module is also the basis for implementing the Singleton design | ||
| Note that using a module is also the basis for implementing the singleton design |
There was a problem hiding this comment.
This change was not useful: classic design patterns are commonly title cased.
But not worth changing back now.
https://docs.python.org/dev/faq/programming.html
faq/design.rstrst markup #96265