Translate reference_lua/fiber; fix #1851

locale/ru/LC_MESSAGES/reference/reference_lua/fiber.po

@@ -232,13 +232,13 @@ msgid "Get the system time in microseconds"
 msgstr "Получение системного времени в микросекундах"
 
 msgid ":ref:`fiber.clock() <fiber-clock>`"
-msgstr ""
+msgstr ":ref:`fiber.clock() <fiber-clock>`"
 
 msgid "Get the monotonic time in seconds"
 msgstr "Получение монотонного времени в секундах"
 
 msgid ":ref:`fiber.clock64() <fiber-clock64>`"
-msgstr ""
+msgstr ":ref:`fiber.clock64() <fiber-clock64>`"
 
 msgid "Get the monotonic time in microseconds"
 msgstr "Получение монотонного времени в микросекундах"
@@ -250,10 +250,12 @@ msgid "Check if the current fiber has been cancelled"
 msgstr "Проверка отмены действующего файбера"
 
 msgid ":ref:`fiber.top() <fiber-top>`"
-msgstr ""
+msgstr ":ref:`fiber.top() <fiber-top>`"
 
 msgid "Return a table of alive fibers and show their CPU consumption"
 msgstr ""
+"Возврат таблицы с активными файберами и отображение статистики "
+"потребления ресурсов ЦП"
 
 msgid ":ref:`fiber.yield() <fiber-yield>`"
 msgstr ":ref:`fiber.yield() <fiber-yield>`"
@@ -412,6 +414,20 @@ msgid ""
 "---\n"
 "..."
 msgstr ""
+"tarantool> fiber = require('fiber')\n"
+"---\n"
+"...\n"
+"tarantool> function function_name()\n"
+"         >   print(\"I'm a fiber\")\n"
+"         > end\n"
+"---\n"
+"...\n"
+"tarantool> fiber_object = fiber.create(function_name); print(\"Fiber "
+"started\")\n"
+"I'm a fiber\n"
+"Fiber started\n"
+"---\n"
+"..."
 
 msgid ""
 "Create but do not start a fiber: the fiber is created but does not begin "
@@ -455,6 +471,22 @@ msgid ""
 "---\n"
 "..."
 msgstr ""
+"tarantool> fiber = require('fiber')\n"
+"---\n"
+"...\n"
+"tarantool> function function_name()\n"
+"         >   print(\"I'm a fiber\")\n"
+"         > end\n"
+"---\n"
+"...\n"
+"tarantool> fiber_object = fiber.new(function_name); print(\"Fiber not "
+"started yet\")\n"
+"Fiber not started yet\n"
+"---\n"
+"...\n"
+"tarantool> I'm a fiber\n"
+"---\n"
+"..."
 
 msgid "fiber object for the currently scheduled fiber."
 msgstr "объект файбера для запланированного на данный момент файбера."
@@ -602,39 +634,52 @@ msgstr ""
 "..."
 
 msgid "Show all alive fibers and their CPU consumption."
-msgstr ""
+msgstr "Отображение всех активных файберов и потребляемых ими ресурсов ЦП."
 
 msgid "a table with two entries: ``cpu`` and ``cpu_misses``"
-msgstr ""
+msgstr "таблица с двумя записями:``cpu`` и ``cpu_misses``"
 
 msgid ""
 "``cpu`` itself is a table whose keys are strings containing fiber ids and"
 " names. The three metrics available for each fiber are:"
 msgstr ""
+"``cpu`` это ещё одна таблица, в которой ключами являются строки с ID и "
+"именами файберов. Для каждого файбера доступны 3 метрики:"
 
 msgid ""
 "``instant`` (in per cent), which indicates the share of time the fiber "
 "was executing during the previous event loop iteration."
 msgstr ""
+"``instant`` (в процентах) показывает долю времени выполнения файбера во "
+"время предыдущей итерации цикла событий."
 
 msgid ""
 "``average`` (in per cent), which is calculated as an exponential moving "
 "average of instant values over all the previous event loop iterations."
 msgstr ""
+"``average`` (в процентах) рассчитывается как экспоненциальное скользящее "
+"среднее мгновенных значений по всем предыдущим итерациям цикла событий."
 
 msgid ""
 "``time`` (in seconds), which estimates how much CPU time each fiber spent"
 " processing during its lifetime."
 msgstr ""
+"``time`` (в секундах) определяет процессорное время, потраченное на "
+"обработку каждого файбера за время его существования."
 
 msgid ""
 "The ``time`` entry is also added to each fiber's output in "
 "``fiber.info()`` (it duplicates the ``time`` entry from "
 "``fiber.top().cpu`` per fiber)."
 msgstr ""
+"Запись ``time`` также добавляется к выводу информации о файбере с помощью"
+" ``fiber.info()`` (дублируется запись ``time`` из ``fiber.top().cpu`` для"
+" каждого файбера)."
 
 msgid "Note that ``time`` is only counted while ``fiber.top()`` is enabled."
 msgstr ""
+"Обратите внимание, что подсчет ``time`` ведется, только если активна "
+"функция ``fiber.top()``."
 
 msgid ""
 "``cpu_misses`` indicates the number of times the TX thread detected it "
@@ -648,9 +693,20 @@ msgid ""
 "the precision of our computations, so the bigger ``cpu misses`` value the"
 " lower the precision of ``fiber.top()`` results."
 msgstr ""
+"``cpu_misses`` показывает число раз, когда поток TX регистрировал перенос"
+" файбера на другое ядро процессора во время последней итерации цикла "
+"обработки событий. ``fiber.top()`` использует счетчик меток времени для "
+"измерения времени выполнения каждого файбера. Однако в разных ядрах могут"
+" быть разные значения счетчика, поэтому полагаться на разность показаний "
+"счетчика можно только в том случае, если оба измерения были проведены на "
+"одном и том же ядре; в противном случае разность показаний может даже "
+"быть отрицательной. Когда поток TX переносится на другое ядро процессора,"
+" Tarantool просто предполагает, что разность показаний была нулевой для "
+"последнего измерения. Это снижает точность вычислений, поэтому больше "
+"значение ``cpu misses``, тем ниже точность результатов ``fiber.top()``."
 
 msgid "Let's take a look at the example:"
-msgstr ""
+msgstr "Возьмем такой пример:"
 
 msgid "**Example**"
 msgstr "**Пример:**"
@@ -694,12 +750,53 @@ msgid ""
 "  cpu_misses: 0\n"
 "..."
 msgstr ""
+"tarantool> fiber.top()\n"
+"---\n"
+"- cpu:\n"
+"    107/lua:\n"
+"      instant: 30.967324490456\n"
+"      time: 0.351821993\n"
+"      average: 25.582738345233\n"
+"    104/lua:\n"
+"      instant: 9.6473633128437\n"
+"      time: 0.110869897\n"
+"      average: 7.9693406131877\n"
+"    101/on_shutdown:\n"
+"      instant: 0\n"
+"      time: 0\n"
+"      average: 0\n"
+"    103/lua:\n"
+"      instant: 9.8026528631511\n"
+"      time: 0.112641118\n"
+"      average: 18.138387232255\n"
+"    106/lua:\n"
+"      instant: 20.071174377224\n"
+"      time: 0.226901357\n"
+"      average: 17.077908441831\n"
+"    102/interactive:\n"
+"      instant: 0\n"
+"      time: 9.6858e-05\n"
+"      average: 0\n"
+"    105/lua:\n"
+"      instant: 9.2461986412164\n"
+"      time: 0.10657528\n"
+"      average: 7.7068458630827\n"
+"    1/sched:\n"
+"      instant: 20.265286315108\n"
+"      time: 0.237095335\n"
+"      average: 23.141537169257\n"
+"  cpu_misses: 0\n"
+"..."
 
 msgid ""
 "Enabling ``fiber.top()`` slows down fiber switching by about 15%, so it "
 "is disabled by default. To enable it, say ``fiber.top_enable()``. To "
 "disable it after you finished debugging, with ``fiber.top_disable()``."
 msgstr ""
+"Выполнение ``fiber.top()`` замедляет переключение файберов примерно на "
+"15%, поэтому по умолчанию функция отключена. Чтобы включить ее, выполните"
+" команду ``fiber.top_enable()``. Чтобы отключить ее по окончании отладки,"
+" выполните ``fiber.top_disable()``."
 
 msgid ""
 "Locate a fiber by its numeric id and cancel it. In other words, "
@@ -889,6 +986,11 @@ msgid ""
 " ``error: the fiber is dead``. But a dead fiber can still report its id "
 "and status."
 msgstr ""
+"Отмена файбера. Отменить можно активные и приостановленные файберы. Любые"
+" попытки использовать файбер после его отмены вызовут ошибку, например, "
+":ref:`fiber_object:name() <fiber_object-name_get>` вызовет ``error: the "
+"fiber is dead``. Тем не менее, недоступный файбер может передавать свой "
+"ID и статус."
 
 msgid "Possible errors: cancel is not permitted for the specified fiber object."
 msgstr "Возможные ошибки: нельзя отменить указанный объект файбера."
@@ -910,6 +1012,22 @@ msgid ""
 "- dead\n"
 "..."
 msgstr ""
+"tarantool> fiber.self():cancel() -- завершение работы файбера, может "
+"вызвать окончание программы\n"
+"---\n"
+"...\n"
+"tarantool> fiber.self():cancel()\n"
+"---\n"
+"- error: fiber is cancelled\n"
+"...\n"
+"tarantool> fiber.self:id()\n"
+"---\n"
+"- 163\n"
+"...\n"
+"tarantool> fiber.self:status()\n"
+"---\n"
+"- dead\n"
+"..."
 
 msgid ""
 "Local storage within the fiber. It is a Lua table created when it is "
@@ -1280,6 +1398,17 @@ msgid ""
 "---\n"
 "..."
 msgstr ""
+"tarantool> start = fiber.clock()\n"
+"---\n"
+"...\n"
+"tarantool> print(start)\n"
+"248700.58805\n"
+"---\n"
+"...\n"
+"tarantool> print(fiber.time(), fiber.time()-start)\n"
+"1600785979.8291 1600537279.241\n"
+"---\n"
+"..."
 
 msgid "Same as :ref:`fiber.clock() <fiber-clock>` but in microseconds."
 msgstr "То же, что и :ref:`fiber.clock() <fiber-clock>`, но в микросекундах."
@@ -1455,6 +1584,18 @@ msgid ""
 "fiber.sleep(.1)\n"
 "fiber_object:cancel()"
 msgstr ""
+"fiber = require('fiber')\n"
+"function function_name()\n"
+"  while true do\n"
+"    print('before testcancel')\n"
+"    fiber.testcancel()\n"
+"    print('before yield')\n"
+"    fiber.yield()\n"
+"  end\n"
+"end\n"
+"fiber_object = fiber.create(function_name)\n"
+"fiber.sleep(.1)\n"
+"fiber_object:cancel()"
 
 msgid "Channels"
 msgstr "Каналы"
@@ -1834,6 +1975,10 @@ msgid ""
 "connect. We will use the tarantoolctl utility (a utility for "
 "administrators) to start two clients."
 msgstr ""
+"Предположим, что экземпляр Tarantool работает и прослушивает порт 3301 на"
+" localhost в ожидании соединений. Также предположим, что пользователи "
+"уровня guest имеют права на подключение. Воспользуемся утилитой "
+"tarantoolctl (утилитой для администраторов), чтобы запустить два клиента."
 
 msgid "On terminal #1, say"
 msgstr "В первом терминале введите:"