Fix issues after syncing with upstream

.github/workflows/build-and-deploy.yml

@@ -50,7 +50,7 @@ jobs:
         uses: sphinx-doc/github-problem-matcher@v1.1
 
       - name: Build documentation
-        run: make -e SPHINXOPTS="--color -D language='fa' -D gettext_allow_fuzzy_translations=1 -D suppress_warnings=misc.highlighting_failure -D html_theme_options.is_rtl=true --keep-going" html
+        run: make -e SPHINXOPTS="--color -D language='fa' -D gettext_allow_fuzzy_translations=1 -D html_theme_options.is_rtl=true --keep-going" html
         working-directory: ./Doc
 
       - name: Setup Pages

.readthedocs.yml

@@ -16,7 +16,6 @@ build:
         -d $READTHEDOCS_OUTPUT/doctrees
         -D language=fa
         -D gettext_allow_fuzzy_translations=1
-        -D suppress_warnings=misc.highlighting_failure
         -D gettext_compact=0
         -D html_theme_options.is_rtl=true
         --keep-going

c-api/code.po

@@ -101,9 +101,8 @@ msgstr "معادل کد پایتون ``getattr(co, 'co_varnames')`` است. یک
 msgid "Equivalent to the Python code ``getattr(co, 'co_cellvars')``. Returns a new reference to a :c:type:`PyTupleObject` containing the names of the local variables that are referenced by nested functions. On error, ``NULL`` is returned and an exception is raised."
 msgstr "معادل کد پایتونِ ``getattr(co, 'co_cellvars')`` است. یک ارجاع جدید به :c:type:`PyTupleObject` حاوی نام متغیرهای محلی‌ای که توابع تودرتو به آن‌ها ارجاع می‌دهند، برمی‌گرداند. در صورت خطا، ``NULL`` برگردانده می‌شود و یک استثنا مطرح می‌شود."
 
-#, fuzzy
 msgid "Equivalent to the Python code ``getattr(co, 'co_freevars')``. Returns a new reference to a :c:type:`PyTupleObject` containing the names of the :term:`free (closure) variables <closure variable>`. On error, ``NULL`` is returned and an exception is raised."
-msgstr "معادل کد پایتونِ `getattr(co, 'co_freevars')` است. یک ارجاع جدید به :c:type:`PyTupleObject` برمی‌گرداند که نام‌های :term:`متغیرهای آزاد (بستار) <closure variable>` را در بر می‌گیرد. در صورت خطا، `NULL` برگردانده می‌شود و یک استثنا مطرح می‌شود."
+msgstr "معادل کد پایتونِ ``getattr(co, 'co_freevars')`` است. یک ارجاع جدید به :c:type:`PyTupleObject` برمی‌گرداند که نام‌های :term:`متغیرهای آزاد (بستار) <closure variable>` را در بر می‌گیرد. در صورت خطا، ``NULL`` برگردانده می‌شود و یک استثنا پرتاب می‌شود."
 
 msgid "Register *callback* as a code object watcher for the current interpreter. Return an ID which may be passed to :c:func:`PyCode_ClearWatcher`. In case of error (e.g. no more watcher IDs available), return ``-1`` and set an exception."
 msgstr "*callback* را به‌عنوان دیده‌بان (watcher) شیء کد برای مفسر فعلی ثبت می‌کند. شناسه‌ای برمی‌گرداند که می‌توان آن را به :c:func:`PyCode_ClearWatcher` ارسال کرد. در صورت بروز خطا (مثلاً وقتی دیگر هیچ شناسه‌ی دیده‌بانی در دسترس نیست)، مقدار ``-1`` را برمی‌گرداند و یک استثنا تنظیم می‌کند."

c-api/frame.po

@@ -52,25 +52,25 @@ msgid "Create a new frame object. This function returns a :term:`strong referenc
 msgstr "یک شیء فریم جدید ایجاد می‌کند. این تابع در صورت موفقیت، یک :term:`ارجاع قوی <strong reference>` به شیء فریم جدید برمی‌گرداند و در صورت شکست، ``NULL`` را همراه با یک استثنای تنظیم‌شده برمی‌گرداند."
 
 msgid "Return non-zero if *obj* is a frame object."
-msgstr "اگر *obj* یک شیء فریم باشد، مقدار غیر صفر برمی‌گرداند."
+msgstr "اگر \*obj\* یک شیء فریم باشد، مقدار غیر صفر برمی‌گرداند."
 
 msgid "Previously, this function was only available after including ``<frameobject.h>``."
 msgstr "پیش‌تر، این تابع تنها پس از گنجاندن ``<frameobject.h>`` در دسترس بود."
 
 msgid "Get the *frame* next outer frame."
-msgstr "گرفتن فریم بیرونی بعدیِ *frame*."
+msgstr "گرفتن فریم بیرونی بعدیِ \*frame\*."
 
 msgid "Return a :term:`strong reference`, or ``NULL`` if *frame* has no outer frame. This raises no exceptions."
-msgstr "یک :term:`ارجاع قوی <strong reference>` برمی‌گرداند، یا اگر *frame* فریم بیرونی نداشته باشد، ``NULL``. این تابع هیچ استثنایی ایجاد نمی‌کند."
+msgstr "یک :term:`ارجاع قوی <strong reference>` برمی‌گرداند، یا اگر \*frame\* فریم بیرونی نداشته باشد، ``NULL``. این تابع هیچ استثنایی ایجاد نمی‌کند."
 
 msgid "Get the *frame*'s :attr:`~frame.f_builtins` attribute."
-msgstr "ویژگی :attr:`~frame.f_builtins` *فریم* را دریافت می‌کند."
+msgstr "ویژگی :attr:`~frame.f_builtins` \*فریم\* را دریافت می‌کند."
 
 msgid "Return a :term:`strong reference`. The result cannot be ``NULL``."
 msgstr "یک :term:`strong reference` برمی‌گرداند. نتیجه نمی‌تواند ``NULL`` باشد."
 
 msgid "Get the *frame* code."
-msgstr "دریافت کد *فریم* ."
+msgstr "دریافت کد \*فریم\* ."
 
 msgid "Return a :term:`strong reference`."
 msgstr "یک :term:`strong reference` را برمی‌گرداند."
@@ -85,16 +85,16 @@ msgid "Return a :term:`strong reference`, or ``NULL``."
 msgstr "یک :term:`ارجاع قوی <strong reference>` یا ``NULL`` برمی‌گرداند."
 
 msgid "Get the *frame*'s :attr:`~frame.f_globals` attribute."
-msgstr "گرفتن ویژگی :attr:`~frame.f_globals` از *فریم*."
+msgstr "گرفتن ویژگی :attr:`~frame.f_globals` از \*فریم\*."
 
 msgid "Get the *frame*'s :attr:`~frame.f_lasti` attribute."
-msgstr "ویژگی :attr:`~frame.f_lasti` *فریم * را دریافت کنید."
+msgstr "ویژگی :attr:`~frame.f_lasti` \*فریم \* را دریافت کنید."
 
 msgid "Returns -1 if ``frame.f_lasti`` is ``None``."
 msgstr "اگر ``frame.f_lasti`` برابر با ``None`` باشد، مقدار -1 را برمی‌گرداند."
 
 msgid "Get the variable *name* of *frame*."
-msgstr "متغیر *name* را از *frame* می‌گیرد."
+msgstr "متغیر \*name\* را از \*frame\* می‌گیرد."
 
 msgid "Return a :term:`strong reference` to the variable value on success."
 msgstr "در صورت موفقیت، یک :term:`ارجاع قوی <strong reference>` به مقدار متغیر برمی‌گرداند."
@@ -106,19 +106,19 @@ msgid "Raise an exception and return ``NULL`` on error."
 msgstr "در صورت خطا، یک استثنا ایجاد کرده و ``NULL`` را برمی‌گرداند."
 
 msgid "*name* type must be a :class:`str`."
-msgstr "نوع *name* باید :class:`str` باشد."
+msgstr "نوع \*name\* باید :class:`str` باشد."
 
 msgid "Similar to :c:func:`PyFrame_GetVar`, but the variable name is a C string encoded in UTF-8."
 msgstr "مشابه :c:func:`PyFrame_GetVar`، اما نام متغیر یک رشته C کدگذاری‌شده با UTF-8 است."
 
 msgid "Get the *frame*'s :attr:`~frame.f_locals` attribute. If the frame refers to an :term:`optimized scope`, this returns a write-through proxy object that allows modifying the locals. In all other cases (classes, modules, :func:`exec`, :func:`eval`) it returns the mapping representing the frame locals directly (as described for :func:`locals`)."
-msgstr "ویژگی :attr:`~frame.f_locals` *فریم* را دریافت می‌کند. اگر فریم به یک :term:`محدوده بهینه‌شده <optimized scope>` اشاره کند، یک شیء پراکسی نوشتن‌همزمان برمی‌گرداند که امکان تغییر متغیرهای محلی را فراهم می‌کند. در تمام موارد دیگر (کلاس‌ها، ماژول‌ها، :func:`exec`، :func:`eval`) نگاشتی را برمی‌گرداند که متغیرهای محلی فریم را به‌طور مستقیم نمایش می‌دهد (همان‌طور که برای :func:`locals` توضیح داده شده است)."
+msgstr "ویژگی :attr:`~frame.f_locals` \*فریم\* را دریافت می‌کند. اگر فریم به یک :term:`محدوده بهینه‌شده <optimized scope>` اشاره کند، یک شیء پراکسی نوشتن‌همزمان برمی‌گرداند که امکان تغییر متغیرهای محلی را فراهم می‌کند. در تمام موارد دیگر (کلاس‌ها، ماژول‌ها، :func:`exec`، :func:`eval`) نگاشتی را برمی‌گرداند که متغیرهای محلی فریم را به‌طور مستقیم نمایش می‌دهد (همان‌طور که برای :func:`locals` توضیح داده شده است)."
 
 msgid "As part of :pep:`667`, return an instance of :c:var:`PyFrameLocalsProxy_Type`."
 msgstr "به عنوان بخشی از :pep:`667`، یک نمونه از :c:var:`PyFrameLocalsProxy_Type` را برمی‌گرداند."
 
 msgid "Return the line number that *frame* is currently executing."
-msgstr "شماره سطری که *frame* هم‌اکنون در حال اجرای آن است را بازمی‌گرداند."
+msgstr "شماره سطری که \*frame\* هم‌اکنون در حال اجرای آن است را بازمی‌گرداند."
 
 msgid "Frame locals proxies"
 msgstr "پراکسی‌های متغیرهای محلی فریم"
@@ -133,7 +133,7 @@ msgid "The type of frame :func:`locals` proxy objects."
 msgstr "نوع شیءهای پراکسی :func:`locals` در فریم."
 
 msgid "Return non-zero if *obj* is a frame :func:`locals` proxy."
-msgstr "اگر *obj* یک پراکسی :func:`locals` فریم باشد، مقدار غیر صفر را برمی‌گرداند."
+msgstr "اگر \*obj\* یک پراکسی :func:`locals` فریم باشد، مقدار غیر صفر را برمی‌گرداند."
 
 msgid "Legacy local variable APIs"
 msgstr "APIهای قدیمی متغیر محلی"
@@ -142,13 +142,13 @@ msgid "These APIs are :term:`soft deprecated`. As of Python 3.13, they do nothin
 msgstr "این API‌ها :term:`soft deprecated` هستند. از پایتون 3.13 به بعد، آن‌ها هیچ کاری انجام نمی‌دهند. آن‌ها صرفاً برای سازگاری با نسخه‌های قبلی وجود دارند."
 
 msgid "Prior to Python 3.13, this function would copy the :attr:`~frame.f_locals` attribute of *f* to the internal \"fast\" array of local variables, allowing changes in frame objects to be visible to the interpreter. If *clear* was true, this function would process variables that were unset in the locals dictionary."
-msgstr "پیش از پایتون 3.13، این تابع ویژگی :attr:`~frame.f_locals` از *f* را به آرایه‌ی داخلی «سریع» (fast) متغیرهای محلی کپی می‌کرد، به‌طوری‌که تغییرات در اشیاء فریم برای مفسر قابل مشاهده می‌شدند. اگر *clear* درست بود، این تابع متغیرهایی را که در دیکشنری متغیرهای محلی تنظیم نشده بودند پردازش می‌کرد."
+msgstr "پیش از پایتون 3.13، این تابع ویژگی :attr:`~frame.f_locals` از \*f\* را به آرایه‌ی داخلی «سریع» (fast) متغیرهای محلی کپی می‌کرد، به‌طوری‌که تغییرات در اشیاء فریم برای مفسر قابل مشاهده می‌شدند. اگر \*clear\* درست بود، این تابع متغیرهایی را که در دیکشنری متغیرهای محلی تنظیم نشده بودند پردازش می‌کرد."
 
 msgid "This function now does nothing."
 msgstr "این تابع اکنون کاری انجام نمی‌دهد."
 
 msgid "Prior to Python 3.13, this function would copy the internal \"fast\" array of local variables (which is used by the interpreter) to the :attr:`~frame.f_locals` attribute of *f*, allowing changes in local variables to be visible to frame objects."
-msgstr "پیش از پایتون 3.13، این تابع آرایه داخلی «سریع» متغیرهای محلی (که توسط مفسر استفاده می‌شود) را به ویژگی :attr:`~frame.f_locals` از *f* کپی می‌کرد، به‌طوری که تغییرات در متغیرهای محلی برای اشیاء فریم قابل مشاهده باشند."
+msgstr "پیش از پایتون 3.13، این تابع آرایه داخلی «سریع» متغیرهای محلی (که توسط مفسر استفاده می‌شود) را به ویژگی :attr:`~frame.f_locals` از \*f\* کپی می‌کرد، به‌طوری که تغییرات در متغیرهای محلی برای اشیاء فریم قابل مشاهده باشند."
 
 msgid "Prior to Python 3.13, this function was similar to :c:func:`PyFrame_FastToLocals`, but would return ``0`` on success, and ``-1`` with an exception set on failure."
 msgstr "پیش از پایتون 3.13، این تابع مشابه :c:func:`PyFrame_FastToLocals` بود، اما در صورت موفقیت ``0`` و در صورت شکست ``-1`` به همراه استثنای تنظیم‌شده برمی‌گرداند."

c-api/unicode.po

@@ -822,9 +822,9 @@ msgid ""
 "*byteorder == 0:  native order\n"
 "*byteorder == 1:  big endian"
 msgstr ""
-"*byteorder == -1: کوچک‌اندیان\n"
-"*byteorder == 0:  ترتیب بومی\n"
-"*byteorder == 1:  بزرگ‌اندیان"
+"*byteorder == -1: little endian\n"
+"*byteorder == 0:  native order\n"
+"*byteorder == 1:  big endian"
 
 msgid "If ``*byteorder`` is zero, and the first four bytes of the input data are a byte order mark (BOM), the decoder switches to this byte order and the BOM is not copied into the resulting Unicode string.  If ``*byteorder`` is ``-1`` or ``1``, any byte order mark is copied to the output."
 msgstr "اگر ``*byteorder`` صفر باشد و چهار بایت نخست داده‌های ورودی، نشانگر ترتیب بایت (BOM) باشند، کدگشا به این ترتیب بایت تغییر می‌کند و BOM در رشته یونیکد حاصل کپی نمی‌شود.  اگر ``*byteorder`` برابر ``-1`` یا ``1`` باشد، هر نشانگر ترتیب بایتی به خروجی کپی می‌شود."

faq/programming.po

@@ -1623,7 +1623,7 @@ msgstr ""
 "['foo', 'item']"
 
 msgid "To see why this happens, you need to know that (a) if an object implements an :meth:`~object.__iadd__` magic method, it gets called when the ``+=`` augmented assignment is executed, and its return value is what gets used in the assignment statement; and (b) for lists, :meth:`!__iadd__` is equivalent to calling :meth:`~sequence.extend` on the list and returning the list. That's why we say that for lists, ``+=`` is a \"shorthand\" for :meth:`list.extend`::"
-msgstr "برای این‌که ببینید چرا این اتفاق می‌افتد، باید بدانید که (الف) اگر یک شیء متد ویژه :meth:`~object.__iadd__` را پیاده‌سازی کرده باشد، هنگامی که انتساب تقویت‌شده‌ی ``+=`` اجرا شود، آن متد فراخوانی می‌شود و مقدار بازگشتی آن چیزی است که در دستور انتساب به کار می‌رود؛ و (ب) برای فهرست‌ها، :meth:`!__iadd__` معادل فراخوانی :meth:`~sequence.extend` روی فهرست و برگرداندن فهرست است. به همین دلیل است که می‌گوییم برای فهرست‌ها، ``+=`` «میان‌بر» برای :meth:`list.extend` است::"
+msgstr "برای این‌که ببینید چرا این اتفاق می‌افتد، باید بدانید که (الف) اگر یک شیء متد جادویی :meth:`~object.__iadd__` را پیاده‌سازی کرده باشد، هنگامی که انتساب تقویت‌شده‌ی ``+=`` اجرا شود، آن متد فراخوانی می‌شود و مقدار بازگشتی آن چیزی است که در دستور انتساب به کار می‌رود؛ و (ب) برای فهرست‌ها، :meth:`!__iadd__` معادل فراخوانی :meth:`~sequence.extend` روی فهرست و برگرداندن فهرست است. به همین دلیل است که می‌گوییم برای فهرست‌ها، ``+=`` «میان‌بر» برای :meth:`list.extend` است::"
 
 msgid ""
 ">>> a_list = []\n"