Automatic docs translation update

Author: dmpgpro

doc/src/xml/ru/cfs.xml

@@ -61,14 +61,18 @@
 
   <para>&productname; хранит отношение в наборе файлов, ограничивая размер каждого 2 гигабайтами. CFS создаёт для каждого файла отдельную карту отображения страниц и производит сборку мусора в нескольких фоновых процессах. Число этих рабочих процессов и условия простоя в их работе может настраиваться администратором баз данных. Эти рабочие процессы разделяют свою работу по хешу дескриптора файла (inode), так что конфликт между ними исключён. Обрабатывается каждый файл независимо. Эти файлы могут блокироваться в момент сборки мусора, но всё отношение при этом не блокируется. Для сохранения целостности данных сборщик мусора создаёт копии исходного файла с данными и файла отображения, а когда данные полностью сохраняются на диске, новая версия файла данных атомарно переименовывается и получает исходное имя. Затем новая карта отображения копируется в файл, отображённый в память, и предыдущий файл отображения удаляется. Производя восстановление после сбоя, мы сначала проверяем, нет ли на диске резервной копии файла данных. Если такой файл существует, это означает, что исходный файл ещё не заменился и мы можем безопасно удалить копию. Если же такого файла нет, мы проверяем наличие копии файла отображения. Если эта копия находится, значит дефрагментация не была завершена из-за сбоя, и мы можем продолжить эту операцию, скопировав отображение из копии.</para>
 
-  <para>CFS можно собрать с поддержкой разных библиотек сжатия: &productname; lz, zlib, lz4, snappy, lzfse... Но этот выбор нужно сделать во время сборки: динамическая смена алгоритма сжатия не поддерживается. CFS сохраняет информацию об используемом алгоритме сжатия в табличном пространстве и выдаёт ошибку, если &productname; собран с другой библиотекой.</para>
+  <para>
+    By default, CFS uses <application>zstd</application> compression library.
+    For safety reasons, CFS checks that the compression algorithm used
+    in a tablespace corresponds to this library.
+  </para>
 
   <para>Шифрование выполняется по алгоритму RC4. Ключ шифрования получается из переменной окружения <varname>PG_CIPHER_KEY</varname>. Заметьте, что отношения системного каталога, как и дополнительные слои отношений, не шифруются.</para>
 
  </sect1>
 
  <sect1 id="cfs-usage">
-  <title>Использование сжатия/шифрования</title>
+  <title>Using Compression/Encryption</title>
 
   <para>Сжатие можно включить для отдельных табличных пространств. При этом системные отношения не сжимаются в любом случае. В настоящее время изменить характеристику сжатия табличного пространства невозможно — то есть нельзя сжать существующее табличное пространство или наоборот, сделать сжатое пространство несжатым.</para>
 
@@ -80,13 +84,34 @@
 
   <para>Шифрование на данный момент поддерживается только со сжатием: использовать шифрование без сжатия невозможно. Чтобы включить шифрование, нужно задать для параметра <varname>cfs_encryption</varname> значение true и задать ключ шифрования в переменной окружения <varname>PG_CIPHER_KEY</varname>.</para>
 
-  <para>Вы можете настроить поведение CFS, используя параметры конфигурации сжатия данных. За подробностями обратитесь к <xref remap="3" linkend="runtime-config-cfs"/>.</para>
-
-    <para>По умолчанию CFS использует для сборки мусора один рабочий процесс. Сборщик мусора проходит по каталогу табличного пространства, находит в нём файлы отображений и проверяет в них процент мусора. Если отношение неиспользуемого объёма к общему превышает значение <varname>cfs_gc_threshold</varname>, этот файл дефрагментируется. На время дефрагментации файл блокируется, в результате чего ни к какой его части нельзя обратиться. По завершении фрагментации сборщик мусора ждёт <varname>cfs_gc_delay</varname> миллисекунд и продолжает проход по каталогу. Завершив проход, он ждёт дополнительно <varname>cfs_gc_period</varname> миллисекунд и начинает новый проход. Если для CFS настроено несколько процессов сборки мусора, они разделяют свою работу по хешу дескриптора файла (inode).</para>
-
-    <para>Также возможно запустить сборку мусора вручную, воспользовавшись функцией <varname>cfs_start_gc(n_workers)</varname>. Эта функция возвращает число рабочих процессов, которые были фактически запущены. Заметьте, что если параметр <varname>cfs_gc_workers</varname> отличен от нуля, сборка мусора выполняется в фоне и функция <varname>cfs_start_gc</varname> ничего не делает, а просто возвращает 0.</para>
-
-    <para>Эффект от сжатия таблицы можно оценить предварительно, воспользовавшись функцией <varname>cfs_estimate(relation)</varname>. Эта функция считывает первые десять блоков отношения, пытается сжать их и возвращает средний коэффициент сжатия. Так, если она возвращает значение 7.8, это означает, что сжатая таблица будет занимать почти в 8 раз меньше места, чем исходная.</para>
+  <para>
+      To configure CFS, use data compression configuration parameters listed in <xref linkend="runtime-config-cfs"/>.
+      By default, CFS is configured with one background worker performing garbage collection. 
+      Garbage collector traverses tablespace directory, locating map files in it and checking percent of garbage in this file.
+      When ratio of used and allocated spaces exceeds <varname>cfs_gc_threshold</varname> threshold, this file is defragmented.
+      The file is locked at the period of defragmentation, preventing any access to this part of relation.
+      When defragmentation is completed, garbage collection waits <varname>cfs_gc_delay</varname> milliseconds and continue directory traversal.
+      After the end of traversal, GC waits <varname>cfs_gc_period</varname> milliseconds and starts new GC iteration.
+      If there are more than one GC workers, then they split work based on hash of file inode.
+    </para>
+
+    <para>
+      CFS provides several functions to manually control CFS garbage collection
+      and get information on CFS state and activity. For the full list of
+      functions, see <xref linkend="functions-compression-control"/>.
+    </para>
+
+    <para>
+      To initiate garbage collection manually, use the <varname>cfs_start_gc(n_workers)</varname>  function.
+      This function returns number of workers which are actually started. Please notice that if <varname>cfs_gc_workers</varname> 
+      parameter is non zero, then GC is performed in background and <varname>cfs_start_gc</varname>  function does nothing and returns 0.
+    </para>
+
+    <para>
+      It is possible to estimate effect of table compression using <varname>cfs_estimate(relation)</varname> function.
+      This function takes first ten blocks of relation, tries to compress them, and returns average compress ratio.
+      So if returned value is 7.8 then compressed table occupies about eight time less space than original table.
+    </para>
 
      <para>Функция <varname>cfs_compression_ratio(relation)</varname> позволяет проверить, насколько точной была оценка, выданная функцией <varname>cfs_estimate(relation)</varname>. Она возвращает фактический коэффициент сжатия для всех сегментов сжатого отношения. Коэффициент сжатия рассчитывается как результат деления общей суммы виртуальных размеров всех сегментов отношения (числа блоков, умноженного на 8 Кбайт) на сумму физических размеров его файлов сегментов.</para>
 

doc/src/xml/ru/contrib-spi.xml

@@ -5,7 +5,7 @@
 
  <indexterm zone="contrib-spi"><primary>SPI</primary> <secondary>примеры</secondary></indexterm>
 
- <para>Модуль <application>spi</application> предоставляет несколько рабочих примеров использования SPI и триггеров. Хотя эти функцию имеют некоторую ценность сами по себе, они ещё более полезны как заготовки, которые можно приспособить под собственные нужды. Эти функции достаточно общие, чтобы работать с любой таблицей, но вы должны явно указать имена таблицы и полей (как описано ниже) при создании триггера.</para>
+ <para>Модуль <application>spi</application> предоставляет несколько рабочих примеров использования <link linkend="spi">Интерфейса программирования сервера</link> (Server Programming Interface, SPI) и триггеров. Хотя эти функции имеют некоторую ценность сами по себе, они ещё более полезны как заготовки, которые можно приспособить под собственные нужды. Эти функции достаточно общие, чтобы работать с любой таблицей, но вы должны явно указать имена таблицы и полей (как описано ниже) при создании триггера.</para>
 
  <para>Каждая группа функций, описанная ниже, представлена в виде отдельно устанавливаемого расширения.</para>
 

doc/src/xml/ru/contrib.xml

@@ -130,6 +130,7 @@ pages.
   <para>В этом разделе рассматриваются приложения, связанные с функциональностью сервера <productname>&productname;</productname> и размещённые в <literal>contrib</literal>. Они обычно запускаются в той же системе, где работает сервер баз данных. Обратитесь также к <xref remap="3" linkend="reference-server"/> за информацией о серверных приложениях, относящихся к ядру дистрибутива <productname>&productname;</productname>.</para>
 
  &pgstandby;
+ &pgbouncer;
  &mamonsu;
  </sect1>
 </appendix>

doc/src/xml/ru/docguide.xml

@@ -258,7 +258,7 @@ checking for fop... fop
      </listitem>
     </itemizedlist></para>
 
-   <para>Так как документация &productname; весьма объёмна, процессору <productname>FOP</productname> для её обработки требуется много памяти. Поэтому в некоторых системах сборка может прерваться ошибкой, связанной с памятью. Обычно это можно исправить, увеличив объём области кучи Java в файле конфигурации <filename>~/.foprc</filename>, например: <programlisting># FOP binary distribution
+   <para>Так как документация &productname; весьма объёмна, процессору <productname>FOP</productname> для её обработки требуется много памяти. Поэтому в некоторых системах сборка может прерваться ошибкой, связанной с памятью. Обычно это можно исправить, увеличив объём области кучи Java в файле конфигурации <filename>~/.foprc</filename>, например: <programlisting># Бинарный пакет FOP
 FOP_OPTS='-Xmx1500m'
 # Debian
 JAVA_ARGS='-Xmx1500m'