diff options
| author | Adam Turner <9087854+AA-Turner@users.noreply.github.com> | 2023-08-20 19:01:13 (GMT) |
|---|---|---|
| committer | GitHub <noreply@github.com> | 2023-08-20 19:01:13 (GMT) |
| commit | 6323bc33ff9f445a947adf4af42b8be7e44c730c (patch) | |
| tree | b4d220376b35b3d69a3e9f78264a094ac7c344ff | |
| parent | 92815cc7cf3df8ab702c7cea4efaef349a4b0480 (diff) | |
| download | cpython-6323bc33ff9f445a947adf4af42b8be7e44c730c.zip cpython-6323bc33ff9f445a947adf4af42b8be7e44c730c.tar.gz cpython-6323bc33ff9f445a947adf4af42b8be7e44c730c.tar.bz2 | |
Resolve reference warnings in faq/library.rst (#108149)
Co-authored-by: Erlend E. Aasland <erlend.aasland@protonmail.com>
Co-authored-by: Hugo van Kemenade <hugovk@users.noreply.github.com>
| -rw-r--r-- | Doc/faq/library.rst | 13 | ||||
| -rw-r--r-- | Doc/tools/.nitignore | 1 |
2 files changed, 8 insertions, 6 deletions
diff --git a/Doc/faq/library.rst b/Doc/faq/library.rst index 9e37274..476a43d 100644 --- a/Doc/faq/library.rst +++ b/Doc/faq/library.rst @@ -111,7 +111,7 @@ Is there an equivalent to C's onexit() in Python? ------------------------------------------------- The :mod:`atexit` module provides a register function that is similar to C's -:c:func:`onexit`. +:c:func:`!onexit`. Why don't my signal handlers work? @@ -397,7 +397,7 @@ These aren't:: D[x] = D[x] + 1 Operations that replace other objects may invoke those other objects' -:meth:`__del__` method when their reference count reaches zero, and that can +:meth:`~object.__del__` method when their reference count reaches zero, and that can affect things. This is especially true for the mass updates to dictionaries and lists. When in doubt, use a mutex! @@ -730,14 +730,17 @@ The :mod:`select` module is commonly used to help with asynchronous I/O on sockets. To prevent the TCP connect from blocking, you can set the socket to non-blocking -mode. Then when you do the :meth:`socket.connect`, you will either connect immediately +mode. Then when you do the :meth:`~socket.socket.connect`, +you will either connect immediately (unlikely) or get an exception that contains the error number as ``.errno``. ``errno.EINPROGRESS`` indicates that the connection is in progress, but hasn't finished yet. Different OSes will return different values, so you're going to have to check what's returned on your system. -You can use the :meth:`socket.connect_ex` method to avoid creating an exception. It will -just return the errno value. To poll, you can call :meth:`socket.connect_ex` again later +You can use the :meth:`~socket.socket.connect_ex` method +to avoid creating an exception. +It will just return the errno value. +To poll, you can call :meth:`~socket.socket.connect_ex` again later -- ``0`` or ``errno.EISCONN`` indicate that you're connected -- or you can pass this socket to :meth:`select.select` to check if it's writable. diff --git a/Doc/tools/.nitignore b/Doc/tools/.nitignore index 0262a0a..9475e88 100644 --- a/Doc/tools/.nitignore +++ b/Doc/tools/.nitignore @@ -25,7 +25,6 @@ Doc/c-api/unicode.rst Doc/extending/extending.rst Doc/extending/newtypes.rst Doc/faq/gui.rst -Doc/faq/library.rst Doc/glossary.rst Doc/howto/descriptor.rst Doc/howto/enum.rst |