Final touches

Author: sepehr-rs

c-api/curses.po

@@ -95,7 +95,7 @@ msgid ""
 "See also the convenience macros :c:macro:`PyCursesSetupTermCalled`, "
 ":c:macro:`PyCursesInitialised`, and :c:macro:`PyCursesInitialisedColor`."
 msgstr ""
-"همچنین ماکروهای راحتی :c:macro:`PyCursesSetupTermCalled`، "
+"همچنین ماکروهای کمکی :c:macro:`PyCursesSetupTermCalled`، "
 ":c:macro:`PyCursesInitialised` و :c:macro:`PyCursesInitialisedColor` را "
 "ببینید."
 
@@ -130,7 +130,7 @@ msgid ""
 "particular, they can only be used as ``macro;`` or ``macro``, but not "
 "``macro()`` or ``macro();``."
 msgstr ""
-"ماکروهای زیر ماکروهایی برای راحتی کار هستند که به دستورهای C بسط می‌یابند. "
+"ماکروهای زیر ماکروهای کمکی هستند که به دستورهای C بسط می‌یابند. "
 "به‌طور خاص، این ماکروها را فقط می‌توان به شکل ``macro;`` یا ``macro`` به کار"
 " برد، اما نه به شکل ``macro()`` یا ``macro();``."
 

c-api/exceptions.po

@@ -310,7 +310,7 @@ msgid ""
 msgstr ""
 "این تابع برای راحتی کار فراهم شده است تا در زمانی که یک تابع کتابخانه‌ی C "
 "خطا برگردانده و متغیر C یعنی :c:data:`errno` را تنظیم کرده است، یک استثنا "
-"برافرازد. این تابع یک شیء تاپل می‌سازد که آیتم نخست آن، مقدار عدد "
+"پرتاب کند. این تابع یک شیء تاپل می‌سازد که آیتم نخست آن، مقدار عدد "
 "صحیح :c:data:`errno`، و آیتم دوم آن، پیام خطای مربوطه (گرفته‌شده "
 "از :c:func:`!strerror`) است، و سپس ``PyErr_SetObject(type, object)`` را "
 "فراخوانی می‌کند. در یونیکس، هنگامی که مقدار :c:data:`errno` برابر :c:macro:`!"
@@ -362,7 +362,7 @@ msgid ""
 "``PyErr_SetObject(PyExc_OSError, object)``. This function always returns "
 "``NULL``."
 msgstr ""
-"این یک تابع راحتی برای برافراختن :exc:`OSError` است. اگر با مقدار ``0`` "
+"این یک تابع کمکی برای پرتاب :exc:`OSError` است. اگر با مقدار ``0`` "
 "برای *ierr* فراخوانی شود، به‌جای آن از کد خطایی که فراخوانی :c:func:`!"
 "GetLastError` برمی‌گرداند استفاده می‌شود. این تابع برای بازیابی توضیح ویندوز "
 "برای کد خطای داده‌شده توسط *ierr* یا :c:func:`!GetLastError`، تابع Win32 "
@@ -427,7 +427,7 @@ msgid ""
 "be ``NULL``, will be set as the :exc:`ImportError`'s respective ``name`` "
 "and ``path`` attributes."
 msgstr ""
-"این یک تابع راحتی برای ایجاد استثنای :exc:`ImportError` است. *msg* به‌عنوان "
+"این یک تابع کمکی برای ایجاد استثنای :exc:`ImportError` است. *msg* به‌عنوان "
 "رشته‌ی پیام استثنا تنظیم می‌شود. *name* و *path*، که هر دو می‌توانند ``NULL`` "
 "باشند، به‌ترتیب به‌عنوان ویژگی‌های ``name`` و ``path`` مربوط "
 "به :exc:`ImportError` تنظیم می‌شوند."

c-api/import.po

@@ -432,7 +432,7 @@ msgid ""
 "before :c:func:`Py_Initialize`."
 msgstr ""
 "یک ماژول تکی را به جدول موجود ماژول‌های توکار اضافه می‌کند. این تابع یک پوشش "
-"راحتی حول :c:func:`PyImport_ExtendInittab` است که در صورتی که نتوان جدول را "
+"کمکی حول :c:func:`PyImport_ExtendInittab` است که در صورتی که نتوان جدول را "
 "گسترش داد، مقدار ``-1`` را برمی‌گرداند. ماژول جدید را می‌توان با نام *name* "
 "ایمپورت کرد و از تابع *initfunc* به عنوان تابع مقداردهی اولیه‌ای که در "
 "نخستین تلاش برای ایمپورت فراخوانی می‌شود، استفاده می‌کند. این تابع باید پیش "

c-api/module.po

@@ -834,14 +834,14 @@ msgid ""
 " exception set on error, ``0`` on success."
 msgstr ""
 "یک ثابت عدد صحیح را با نام *name* به *module* اضافه می‌کند. می‌توان از این "
-"تابع راحتی در تابع مقداردهی اولیه‌ی ماژول استفاده کرد. در صورت خطا، ``-1`` "
+"تابع کمکی در تابع مقداردهی اولیه‌ی ماژول استفاده کرد. در صورت خطا، ``-1`` "
 "همراه با تنظیم یک استثنا و در صورت موفقیت ``0`` برمی‌گرداند."
 
 msgid ""
 "This is a convenience function that calls :c:func:`PyLong_FromLong` and "
 ":c:func:`PyModule_AddObjectRef`; see their documentation for details."
 msgstr ""
-"این یک تابع راحتی است که :c:func:`PyLong_FromLong` و "
+"این یک تابع کمکی است که :c:func:`PyLong_FromLong` و "
 ":c:func:`PyModule_AddObjectRef` را فراخوانی می‌کند؛ برای جزئیات به مستندات "
 "آن‌ها مراجعه کنید."
 
@@ -851,7 +851,7 @@ msgid ""
 "be ``NULL``-terminated. Return ``-1`` with an exception set on error, ``0`` "
 "on success."
 msgstr ""
-"یک ثابت رشته‌ای را با نام *name* به *module* اضافه می‌کند. از این تابع راحتی"
+"یک ثابت رشته‌ای را با نام *name* به *module* اضافه می‌کند. از این تابع کمکی"
 " می‌توان در تابع مقداردهی اولیه‌ی ماژول استفاده کرد. رشته‌ی *value* باید با "
 "``NULL`` پایان یابد. در صورت خطا ``-1`` همراه با تنظیم یک استثنا، و در صورت "
 "موفقیت ``0`` برمی‌گرداند."
@@ -861,7 +861,7 @@ msgid ""
 ":c:func:`PyUnicode_InternFromString` and :c:func:`PyModule_AddObjectRef`; "
 "see their documentation for details."
 msgstr ""
-"این یک تابع راحتی است که :c:func:`PyUnicode_InternFromString` و "
+"این یک تابع کمکی است که :c:func:`PyUnicode_InternFromString` و "
 ":c:func:`PyModule_AddObjectRef` را فراخوانی می‌کند؛ برای جزئیات به مستندات "
 "آن‌ها مراجعه کنید."
 

extending/extending.po

@@ -2489,7 +2489,7 @@ msgid ""
 "convention.  This behavior gives C API users a high degree of certainty that"
 " the Capsule they load contains the correct C API."
 msgstr ""
-"تابع راحتی :c:func:`PyCapsule_Import` بارگذاری یک C API که از طریق یک کپسول "
+"تابع کمکی :c:func:`PyCapsule_Import` بارگذاری یک C API که از طریق یک کپسول "
 "ارائه شده را آسان می‌کند، اما تنها در صورتی که نام کپسول با این قرارداد "
 "مطابقت داشته باشد.  این رفتار به کاربران C API درجه بالایی از اطمینان می‌دهد"
 " که کپسولی که بارگذاری می‌کنند، C API صحیح را در بر دارد."

faq/design.po

@@ -1515,7 +1515,7 @@ msgstr ""
 "('a', 'b', 'c',)\n"
 "d = {\n"
 "    \"A\": [1, 5],\n"
-"    \"B\": [6, 7],  # آخرین ویرگول پایانی اختیاری است، اما سبک خوبی است\n"
+"    \"B\": [6, 7],  # last trailing comma is optional but good style\n"
 "}"
 
 msgid "There are several reasons to allow this."

faq/library.po

@@ -919,7 +919,7 @@ msgstr ""
 "برای خواندن و نوشتن داده‌های دودویی، باز کردن پرونده در حالت دودویی الزامی است "
 "(در اینجا، با ارسال ``\"rb\"`` به :func:`open`). اگر به‌جای آن از ``\"r\"`` "
 "استفاده کنید (پیش‌فرض)، پرونده در حالت متنی باز خواهد شد و ``f.read()`` به‌جای "
-"اشیای :class:`bytes <str>`، اشیای :class:`str <bytes>` را برمی‌گرداند."
+"اشیای :class:`bytes`، اشیای :class:`str` را برمی‌گرداند."
 
 msgid "I can't seem to use os.read() on a pipe created with os.popen(); why?"
 msgstr ""

faq/programming.po

@@ -663,7 +663,7 @@ msgid ""
 msgstr ""
 "def foo(mydict=None):\n"
 "    if mydict is None:\n"
-"        mydict = {}  # ایجاد یک دیکشنری جدید برای فضای نام محلی"
+"        mydict = {}  # create a new dict for local namespace"
 
 msgid ""
 "This feature can be useful.  When you have a function that's time-consuming to "
@@ -689,15 +689,15 @@ msgid ""
 "    _cache[(arg1, arg2)] = result           # Store result in the cache\n"
 "    return result"
 msgstr ""
-"# فراخوانندگان فقط می‌توانند دو پارامتر ارائه دهند و _cache را به‌صورت اختیاری با "
-"کلیدواژه ارسال کنند\n"
+"# Callers can only provide two parameters and optionally pass _cache by "
+"keyword\n"
 "def expensive(arg1, arg2, *, _cache={}):\n"
 "    if (arg1, arg2) in _cache:\n"
 "        return _cache[(arg1, arg2)]\n"
 "\n"
-"    # مقدار را محاسبه کنید\n"
+"    # Calculate the value\n"
 "    result = ... expensive computation ...\n"
-"    _cache[(arg1, arg2)] = result           # نتیجه را در نهانگاه ذخیره کنید\n"
+"    _cache[(arg1, arg2)] = result           # Store result in the cache\n"
 "    return result"
 
 msgid ""
@@ -1405,27 +1405,27 @@ msgid ""
 msgstr ""
 "from functools import reduce\n"
 "\n"
-"# اعداد اول کوچک‌تر از ۱۰۰۰\n"
+"# Primes < 1000\n"
 "print(list(filter(None,map(lambda y:y*reduce(lambda x,y:x*y!=0,\n"
 "map(lambda x,y=y:y%x,range(2,int(pow(y,0.5)+1))),1),range(2,1000)))))\n"
 "\n"
-"# نخستین ۱۰ عدد فیبوناچی\n"
+"# First 10 Fibonacci numbers\n"
 "print(list(map(lambda x,f=lambda x,f:(f(x-1,f)+f(x-2,f)) if x>1 else 1:\n"
 "f(x,f), range(10))))\n"
 "\n"
-"# مجموعه‌ی مندل‌برو\n"
+"# Mandelbrot set\n"
 "print((lambda Ru,Ro,Iu,Io,IM,Sx,Sy:reduce(lambda x,y:x+'\\n'+y,map(lambda y,\n"
 "Iu=Iu,Io=Io,Ru=Ru,Ro=Ro,Sy=Sy,L=lambda yc,Iu=Iu,Io=Io,Ru=Ru,Ro=Ro,i=IM,\n"
 "Sx=Sx,Sy=Sy:reduce(lambda x,y:x+y,map(lambda x,xc=Ru,yc=yc,Ru=Ru,Ro=Ro,\n"
 "i=i,Sx=Sx,F=lambda xc,yc,x,y,k,f=lambda xc,yc,x,y,k,f:(k<=0)or (x*x+y*y\n"
 ">=4.0) or 1+f(xc,yc,x*x-y*y+xc,2.0*x*y+yc,k-1,f):f(xc,yc,x,y,k,f):chr(\n"
 "64+F(Ru+x*(Ro-Ru)/Sx,yc,0,0,i)),range(Sx))):L(Iu+y*(Io-Iu)/Sy),range(Sy\n"
 "))))(-2.1, 0.7, -1.2, 1.2, 30, 80, 24))\n"
-"#    \\___ ___/  \\___ ___/  |   |   |__ سطرهای صفحه\n"
-"#        V          V      |   |______ ستون‌های صفحه\n"
-"#        |          |      |__________ بیشینه‌ی «تکرارها»\n"
-"#        |          |_________________ بازه‌ی محور y\n"
-"#        |____________________________ بازه‌ی محور x"
+"#    \\___ ___/  \\___ ___/  |   |   |__ lines on screen\n"
+"#        V          V      |   |______ columns on screen\n"
+"#        |          |      |__________ maximum of \"iterations\"\n"
+"#        |          |_________________ range on y axis\n"
+"#        |____________________________ range on x axis"
 
 msgid "Don't try this at home, kids!"
 msgstr "بچه‌ها، این کار را در خانه امتحان نکنید!"
@@ -1752,9 +1752,9 @@ msgstr ""
 "def b():\n"
 "    pass\n"
 "\n"
-"dispatch = {'go': a, 'stop': b}  # توجه: نبود پرانتز برای توابع\n"
+"dispatch = {'go': a, 'stop': b}  # Note lack of parens for funcs\n"
 "\n"
-"dispatch[get_input()]()  # توجه: پرانتز پایانی برای فراخوانی تابع"
+"dispatch[get_input()]()  # Note trailing parens to call function"
 
 msgid "Use the built-in function :func:`getattr`::"
 msgstr "از تابع توکار :func:`getattr` استفاده کنید::"

glossary.po

@@ -252,9 +252,8 @@ msgid ""
 "An asynchronous generator function may contain :keyword:`await` expressions "
 "as well as :keyword:`async for`, and :keyword:`async with` statements."
 msgstr ""
-"یک تابع تولیدگر ناهمگام ممکن است علاوه بر عبارت‌های :keyword:`async for "
-"<await>` و دستورهای :keyword:`async with <async for>`، شامل عبارت‌های "
-":keyword:`await <async with>` نیز باشد."
+"یک تابع تولیدگر ناهمگام ممکن است علاوه بر عبارت‌های :keyword:`async for` و د"
+"ستورهای :keyword:`async with`، شامل عبارت‌های :keyword:`await` نیز باشد."
 
 msgid "asynchronous generator iterator"
 msgstr "پیمایش‌گر تولیدگر ناهمگام"
@@ -887,7 +886,7 @@ msgstr ""
 " دست‌کم یکی از دسترسی‌ها نوشتن است و نخ‌ها برای کنترل دسترسی خود از هیچ "
 "همگام‌سازی‌ای استفاده نمی‌کنند. رقابت‌های داده به رفتار :term:`غیرقطعی <non-"
 "deterministic>` منجر می‌شوند و می‌توانند باعث خرابی داده شوند. استفاده‌ی درست"
-" از :term:`قفل <lock>` و دیگر :term:`اولیه <synchronization primitive>` از "
+" از :term:`قفل <lock>` و دیگر :term:`اولیه همگام‌سازی <synchronization primitive>` از "
 "رقابت‌های داده جلوگیری می‌کند. توجه داشته باشید که رقابت‌های داده فقط در کد "
 "بومی رخ می‌دهند، اما آن :term:`کد بومی <native code>` ممکن است در یک API "
 "پایتون در معرض استفاده قرار گرفته باشد. همچنین :term:`شرط رقابت <race "
@@ -927,7 +926,7 @@ msgid ""
 msgstr ""
 "تابعی که تابع دیگری را بازمی‌گرداند و معمولاً با استفاده از سینتکس "
 "``@wrapper`` به‌عنوان یک تبدیل تابع اعمال می‌شود. نمونه‌های رایج دکوراتورها "
-":func:`classmethod` و :func:`staticmethod` هستند."
+":deco:`classmethod` و :deco:`staticmethod` هستند."
 
 msgid ""
 "The decorator syntax is merely syntactic sugar, the following two function "
@@ -1509,7 +1508,7 @@ msgid ""
 ":deco:`functools.singledispatch` decorator, and :pep:`443`."
 msgstr ""
 "همچنین به ورودی واژه‌نامه‌ای :term:`توزیع تک‌گانه <single dispatch>`، "
-"دکوریتور :func:`functools.singledispatch` و :pep:`443` مراجعه کنید."
+"دکوراتور :deco:`functools.singledispatch` و :pep:`443` مراجعه کنید."
 
 msgid "generic type"
 msgstr "نوع عام"
@@ -2084,7 +2083,7 @@ msgid ""
 " patterns, and thread-local state. See also :term:`deadlock`, and "
 ":term:`reentrant`."
 msgstr ""
-"یک :term:`اولیه <synchronization primitive>` که در هر زمان فقط به یک نخ "
+"یک :term:`اولیه همگام‌سازی <synchronization primitive>` که در هر زمان فقط به یک نخ "
 "اجازه‌ی دسترسی به یک منبع اشتراکی را می‌دهد. یک نخ باید پیش از دسترسی به منبع"
 " محافظت‌شده، یک قفل را به‌دست آورد و پس از آن آن را آزاد کند. اگر یک نخ تلاش"
 " کند قفلی را به‌دست آورد که پیش‌تر توسط نخ‌ای دیگر در اختیار گرفته شده است، "
@@ -2347,11 +2346,11 @@ msgid ""
 ">>> isinstance(sys.float_info, tuple)   # kind of tuple\n"
 "True"
 msgstr ""
-">>> sys.float_info[1]                   # دسترسی با اندیس\n"
+">>> sys.float_info[1]                   # indexed access\n"
 "1024\n"
-">>> sys.float_info.max_exp              # دسترسی به فیلد نام‌گذاری‌شده\n"
+">>> sys.float_info.max_exp              # named field access\n"
 "1024\n"
-">>> isinstance(sys.float_info, tuple)   # نوعی تاپل\n"
+">>> isinstance(sys.float_info, tuple)   # kind of tuple\n"
 "True"
 
 msgid ""
@@ -2493,7 +2492,7 @@ msgstr ""
 "یکسان متفاوت باشد. در برنامه‌های چندنخی، رفتار غیرقطعی اغلب از :term:`شرط "
 "رقابت <race condition>` ناشی می‌شود که در آن زمان‌بندی نسبی یا درهم‌تنیدگی "
 "نخ‌ها بر نتیجه تأثیر می‌گذارد. همگام‌سازی مناسب با استفاده از :term:`قفل "
-"<lock>` و دیگر :term:`اولیه <synchronization primitive>` به تضمین رفتار قطعی"
+"<lock>` و دیگر :term:`اولیه همگام‌سازی <synchronization primitive>` به تضمین رفتار قطعی"
 " کمک می‌کند."
 
 msgid "object"
@@ -2985,7 +2984,7 @@ msgstr ""
 "دشوار است. یک :term:`رقابت داده <data race>` نوع خاصی از شرط رقابت است که "
 "شامل دسترسی بدون همگام‌سازی به حافظه‌ی اشتراکی می‌شود. سبک کدنویسی "
 ":term:`LBYL <LBYL>` در کد چندنخی به‌طور ویژه در برابر شرایط رقابت آسیب‌پذیر "
-"است. استفاده از :term:`قفل <lock>` و دیگر :term:`اولیه <synchronization "
+"است. استفاده از :term:`قفل <lock>` و دیگر :term:`اولیه‌های همگام‌سازی <synchronization "
 "primitive>` به جلوگیری از شرایط رقابت کمک می‌کند."
 
 msgid "reference count"
@@ -3329,7 +3328,7 @@ msgstr ""
 "<sequence>`، به آن :term:`اندیس <index>` گفته می‌شود."
 
 msgid "synchronization primitive"
-msgstr "اولیه"
+msgstr "اولیه همگام‌سازی"
 
 msgid ""
 "A basic building block for coordinating (synchronizing) the execution of "
@@ -3484,7 +3483,7 @@ msgid ""
 ":term:`data races <data race>` when used in multi-threaded programs."
 msgstr ""
 "یک ماژول، تابع یا کلاس که هنگام استفاده‌ی همزمان توسط چند نخ اجرایی، "
-"به‌درستی رفتار می‌کند. کد ایمن برای نخ‌های اجرایی از :term:`اولیه "
+"به‌درستی رفتار می‌کند. کد ایمن برای نخ‌های اجرایی از :term:`اولیه همگام‌سازی "
 "<synchronization primitive>` مناسب، مانند :term:`قفل <lock>`، برای محافظت از"
 " وضعیت تغییرپذیر مشترک استفاده می‌کند یا به‌گونه‌ای طراحی شده است که به‌طور "
 "کامل از وضعیت تغییرپذیر مشترک اجتناب کند. در ساخت :term:`نخ‌گذاری آزاد <free"

glossary.tsv

@@ -562,7 +562,7 @@ indented	دارای تورفتگی، فرورفته
 stack trace	ردگیری پشته
 atomic operation	عملیات اتمی
 per-object lock	قفلِ مخصوص هر شیء
-synchronization primitive	ابتداییِ همگام‌سازی
+synchronization primitive	اولیه‌های همگام‌سازی
 acquire	به‌دست آوردن
 synchronization	همگام‌سازی
 thread-local storage	ذخیره‌سازی نخ‌محلی
@@ -666,4 +666,6 @@ punctuation علائم نگارشی
 decimal دهدهی
 regression	رگرسیون
 digested    پردازش‌شده
-caret نشانک
+caret نشانک
+convenience function    تابع کمکی
+convenience variable    متغیر کمکی