Update translation from Transifex

Author: GitHub Action's update-translation job

README.en.md

@@ -17,7 +17,7 @@ f'''[![build](https://github.com/python/python-docs-pl/actions/workflows/update-
 ]]] -->
 [![build](https://github.com/python/python-docs-pl/actions/workflows/update-and-build.yml/badge.svg)](https://github.com/python/python-docs-pl/actions/workflows/update-and-build.yml)
 [![core 100.00%](https://img.shields.io/badge/core-100.00%25-0.svg)](https://translations.python.org/#pl)
-[![Total Translation of Documentation](https://img.shields.io/badge/total_words-5.70%25-0.svg)](https://translations.python.org/#pl)
+[![Total Translation of Documentation](https://img.shields.io/badge/total_words-5.69%25-0.svg)](https://translations.python.org/#pl)
 [![Total Translation of Documentation](https://img.shields.io/badge/total_strings-12.47%25-0.svg)](https://translations.python.org/#pl)
 [![lint errors count](https://shields.io/badge/dynamic/xml?url=https%3A%2F%2Ftranslations.python.org%2Fbuild-details.html&query=%2F%2Ftr%5Btd%5B%40data-label%3D%27language%27%20and%20contains%28.%2C%20%27%28pl%29%27%29%5D%5D%20%20%20%2F%2Ftd%5B%40data-label%3D%27lint%27%5D%2Fa%2Ftext()&label=lint%20errors)](https://github.com/python/python-docs-pl/actions/workflows/lint.yml)
 

README.md

@@ -17,7 +17,7 @@ f'''[![build](https://github.com/python/python-docs-pl/actions/workflows/update-
 ]]] -->
 [![build](https://github.com/python/python-docs-pl/actions/workflows/update-and-build.yml/badge.svg)](https://github.com/python/python-docs-pl/actions/workflows/update-and-build.yml)
 [![podstawowe artykuły 100.00%](https://img.shields.io/badge/podstawowe_artykuły-100.00%25-0.svg)](https://translations.python.org/#pl)
-[![postęp tłumaczenia całości dokumentacji](https://img.shields.io/badge/całość_słów-5.70%25-0.svg)](https://translations.python.org/#pl)
+[![postęp tłumaczenia całości dokumentacji](https://img.shields.io/badge/całość_słów-5.69%25-0.svg)](https://translations.python.org/#pl)
 [![postęp tłumaczenia całości dokumentacji](https://img.shields.io/badge/całość_napisów-12.47%25-0.svg)](https://translations.python.org/#pl)
 [![liczba błędów lintowania](https://shields.io/badge/dynamic/xml?url=https%3A%2F%2Ftranslations.python.org%2Fbuild-details.html&query=%2F%2Ftr%5Btd%5B%40data-label%3D%27language%27%20and%20contains%28.%2C%20%27%28pl%29%27%29%5D%5D%20%20%20%2F%2Ftd%5B%40data-label%3D%27lint%27%5D%2Fa%2Ftext()&label=b%C5%82%C4%99dy%20lintowania)](https://github.com/python/python-docs-pl/actions/workflows/lint.yml)
 

c-api/bytes.po

@@ -11,7 +11,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: Python 3.15\n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2026-06-19 16:29+0000\n"
+"POT-Creation-Date: 2026-07-03 15:50+0000\n"
 "PO-Revision-Date: 2025-09-16 00:00+0000\n"
 "Last-Translator: python-doc bot, 2025\n"
 "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n"
@@ -257,10 +257,11 @@ msgstr ""
 
 msgid ""
 "Create a new bytes object in *\\*bytes* containing the contents of *newpart* "
-"appended to *bytes*; the caller will own the new reference.  The reference "
-"to the old value of *bytes* will be stolen.  If the new object cannot be "
-"created, the old reference to *bytes* will still be discarded and the value "
-"of *\\*bytes* will be set to ``NULL``; the appropriate exception will be set."
+"appended to *bytes*; the caller will own the new reference. The reference to "
+"the old value of *bytes* will be \":term:`stolen <steal>`\". If the new "
+"object cannot be created, the old reference to *bytes* will still be "
+"\"stolen\", the value of *\\*bytes* will be set to ``NULL``, and the "
+"appropriate exception will be set."
 msgstr ""
 
 msgid ""

c-api/dict.po

@@ -11,7 +11,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: Python 3.15\n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2026-06-21 15:47+0000\n"
+"POT-Creation-Date: 2026-07-03 15:50+0000\n"
 "PO-Revision-Date: 2025-09-16 00:00+0000\n"
 "Last-Translator: python-doc bot, 2025\n"
 "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n"
@@ -112,8 +112,8 @@ msgstr "Zwraca nowy słownik zawierający te same pary klucz-wartość co *p*."
 msgid ""
 "Insert *val* into the dictionary *p* with a key of *key*.  *key* must be :"
 "term:`hashable`; if it isn't, :exc:`TypeError` will be raised. Return ``0`` "
-"on success or ``-1`` on failure.  This function *does not* steal a reference "
-"to *val*."
+"on success or ``-1`` on failure. This function *does not* \":term:`steal`\" "
+"a reference to *val*."
 msgstr ""
 
 msgid ""

c-api/exceptions.po

@@ -11,7 +11,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: Python 3.15\n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2026-06-23 16:23+0000\n"
+"POT-Creation-Date: 2026-07-03 15:50+0000\n"
 "PO-Revision-Date: 2025-09-16 00:00+0000\n"
 "Last-Translator: python-doc bot, 2025\n"
 "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n"
@@ -474,7 +474,9 @@ msgid ""
 "exception if one is set."
 msgstr ""
 
-msgid "This call steals a reference to *exc*, which must be a valid exception."
+msgid ""
+"This call \":term:`steals <steal>`\" a reference to *exc*, which must be a "
+"valid exception."
 msgstr ""
 
 msgid "Use :c:func:`PyErr_GetRaisedException` instead."
@@ -597,10 +599,10 @@ msgstr ""
 msgid ""
 "Set the exception info, as known from ``sys.exc_info()``.  This refers to an "
 "exception that was *already caught*, not to an exception that was freshly "
-"raised.  This function steals the references of the arguments. To clear the "
-"exception state, pass ``NULL`` for all three arguments. This function is "
-"kept for backwards compatibility. Prefer using :c:func:"
-"`PyErr_SetHandledException`."
+"raised.  This function \":term:`steals <steal>`\" the references of the "
+"arguments. To clear the exception state, pass ``NULL`` for all three "
+"arguments. This function is kept for backwards compatibility. Prefer using :"
+"c:func:`PyErr_SetHandledException`."
 msgstr ""
 
 msgid ""
@@ -613,7 +615,8 @@ msgstr ""
 msgid ""
 "The ``type`` and ``traceback`` arguments are no longer used and can be NULL. "
 "The interpreter now derives them from the exception instance (the ``value`` "
-"argument). The function still steals references of all three arguments."
+"argument). The function still \":term:`steals <steal>`\" references of all "
+"three arguments."
 msgstr ""
 
 msgid "Signal Handling"
@@ -811,7 +814,7 @@ msgstr ""
 msgid ""
 "Set the context associated with the exception to *ctx*.  Use ``NULL`` to "
 "clear it.  There is no type check to make sure that *ctx* is an exception "
-"instance. This steals a reference to *ctx*."
+"instance. This \":term:`steals <steal>`\" a reference to *ctx*."
 msgstr ""
 
 msgid ""
@@ -824,7 +827,8 @@ msgstr ""
 msgid ""
 "Set the cause associated with the exception to *cause*.  Use ``NULL`` to "
 "clear it.  There is no type check to make sure that *cause* is either an "
-"exception instance or ``None``.  This steals a reference to *cause*."
+"exception instance or ``None``. This \":term:`steals <steal>`\" a reference "
+"to *cause*."
 msgstr ""
 
 msgid ""

c-api/intro.po

@@ -11,7 +11,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: Python 3.15\n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2026-06-21 15:47+0000\n"
+"POT-Creation-Date: 2026-07-03 15:50+0000\n"
 "PO-Revision-Date: 2025-09-16 00:00+0000\n"
 "Last-Translator: python-doc bot, 2025\n"
 "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n"
@@ -864,15 +864,15 @@ msgstr ""
 msgid ""
 "Conversely, when a calling function passes in a reference to an  object, "
 "there are two possibilities: the function *steals* a  reference to the "
-"object, or it does not.  *Stealing a reference* means that when you pass a "
-"reference to a function, that function assumes that it now owns that "
-"reference, and you are not responsible for it any longer."
-msgstr ""
-"Idąc dalej, gdy wywołujące zadanie przekazuje odniesienie do przedmiotu, "
-"istnieją dwie możliwości: zadanie *kradnie* odniesienie do przedmiotu, lub "
-"nie kradnie go. *Kradnięcie odniesienia* oznacza, że gdy przekazujesz "
-"odniesienie do zadania, to zadanie przyjmuje, że teraz ono posiada "
-"odniesienie i nie jesteś za nie odpowiedzialny ani chwili dłużej."
+"object, or it does not."
+msgstr ""
+
+msgid ""
+"*Stealing a reference* means that when you pass a reference to a function, "
+"that function assumes that it now owns that reference. Since the new owner "
+"can use :c:func:`!Py_DECREF` at its discretion, you (the caller) must not "
+"use that reference after the call."
+msgstr ""
 
 msgid ""
 "Few functions steal references; the two notable exceptions are :c:func:"

c-api/list.po

@@ -11,7 +11,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: Python 3.15\n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2026-06-21 15:47+0000\n"
+"POT-Creation-Date: 2026-07-03 15:50+0000\n"
 "PO-Revision-Date: 2025-09-16 00:00+0000\n"
 "Last-Translator: python-doc bot, 2025\n"
 "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n"
@@ -93,8 +93,9 @@ msgid ""
 msgstr ""
 
 msgid ""
-"This function \"steals\" a reference to *item* and discards a reference to "
-"an item already in the list at the affected position."
+"This function \":term:`steals <steal>`\" a reference to *item*, even on "
+"error. On success, it discards a reference to an item already in the list at "
+"the affected position (unless it was ``NULL``)."
 msgstr ""
 
 msgid ""
@@ -108,9 +109,9 @@ msgid ""
 msgstr ""
 
 msgid ""
-"This macro \"steals\" a reference to *item*, and, unlike :c:func:"
-"`PyList_SetItem`, does *not* discard a reference to any item that is being "
-"replaced; any reference in *list* at position *i* will be leaked."
+"This macro \":term:`steals <steal>`\" a reference to *item*, and, unlike :c:"
+"func:`PyList_SetItem`, does *not* discard a reference to any item that is "
+"being replaced; any reference in *list* at position *i* will be leaked."
 msgstr ""
 
 msgid ""

c-api/memory.po

@@ -11,7 +11,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: Python 3.15\n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2026-06-11 17:33+0000\n"
+"POT-Creation-Date: 2026-07-01 16:21+0000\n"
 "PO-Revision-Date: 2025-09-16 00:00+0000\n"
 "Last-Translator: python-doc bot, 2025\n"
 "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n"

c-api/sequence.po

@@ -11,7 +11,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: Python 3.15\n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2026-06-21 15:47+0000\n"
+"POT-Creation-Date: 2026-07-03 15:50+0000\n"
 "PO-Revision-Date: 2025-09-16 00:00+0000\n"
 "Last-Translator: python-doc bot, 2025\n"
 "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n"
@@ -75,8 +75,8 @@ msgstr ""
 msgid ""
 "Assign object *v* to the *i*\\ th element of *o*.  Raise an exception and "
 "return ``-1`` on failure; return ``0`` on success.  This is the equivalent "
-"of the Python statement ``o[i] = v``.  This function *does not* steal a "
-"reference to *v*."
+"of the Python statement ``o[i] = v``.  This function *does not* \":term:"
+"`steal`\" a reference to *v*."
 msgstr ""
 
 msgid ""

c-api/threads.po

@@ -12,7 +12,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: Python 3.15\n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2026-07-01 16:21+0000\n"
+"POT-Creation-Date: 2026-07-03 15:50+0000\n"
 "PO-Revision-Date: 2026-02-25 14:46+0000\n"
 "Last-Translator: python-doc bot, 2026\n"
 "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n"
@@ -999,8 +999,8 @@ msgstr ""
 msgid ""
 "To prevent naive misuse, you must write your own C extension to call this. "
 "This function must be called with an :term:`attached thread state`. This "
-"function does not steal any references to *exc*. This function does not "
-"necessarily interrupt system calls such as :py:func:`~time.sleep`."
+"function does not :term:`steal` any references to *exc*. This function does "
+"not necessarily interrupt system calls such as :py:func:`~time.sleep`."
 msgstr ""
 
 msgid ""