diff options
author | kj <28750310+Fidget-Spinner@users.noreply.github.com> | 2020-11-10 23:56:55 (GMT) |
---|---|---|
committer | GitHub <noreply@github.com> | 2020-11-10 23:56:55 (GMT) |
commit | 78ba7c69ada2f7eefd4e3ea375337d78dc2ce721 (patch) | |
tree | 88d49a0a8ee549d019116c322d566fa917919bc2 /Doc/glossary.rst | |
parent | 7e5ef0a5713f968f6e942566c78bf57ffbef01de (diff) | |
download | cpython-78ba7c69ada2f7eefd4e3ea375337d78dc2ce721.zip cpython-78ba7c69ada2f7eefd4e3ea375337d78dc2ce721.tar.gz cpython-78ba7c69ada2f7eefd4e3ea375337d78dc2ce721.tar.bz2 |
bpo-42294: Grammar fixes in doc glossary strong/weak refs (GH-23227)
Diffstat (limited to 'Doc/glossary.rst')
-rw-r--r-- | Doc/glossary.rst | 10 |
1 files changed, 5 insertions, 5 deletions
diff --git a/Doc/glossary.rst b/Doc/glossary.rst index b410585..0661c82 100644 --- a/Doc/glossary.rst +++ b/Doc/glossary.rst @@ -159,14 +159,14 @@ Glossary :class:`str` objects. borrowed reference - In the Python's C API, a borrowed reference is a reference to an object. + In Python's C API, a borrowed reference is a reference to an object. It does not modify the object reference count. It becomes a dangling pointer if the object is destroyed. For example, a garbage collection can remove the last :term:`strong reference` to the object and so destroy it. Calling :c:func:`Py_INCREF` on the :term:`borrowed reference` is recommended to convert it to a :term:`strong reference` in-place, except - if the object cannot be destroyed before the last usage of the borrowed + when the object cannot be destroyed before the last usage of the borrowed reference. The :c:func:`Py_NewRef` function can be used to create a new :term:`strong reference`. @@ -1113,9 +1113,9 @@ Glossary as :keyword:`if`, :keyword:`while` or :keyword:`for`. strong reference - In the Python's C API, a strong reference is a reference to an object - which increments object reference count when it is created and - decrements the object reference count when it is deleted. + In Python's C API, a strong reference is a reference to an object + which increments the object's reference count when it is created and + decrements the object's reference count when it is deleted. The :c:func:`Py_NewRef` function can be used to create a strong reference to an object. Usually, the :c:func:`Py_DECREF` function must be called on |