Automatic docs translation update

Author: Alexander Lakhin

doc/src/xml/ru/arch-dev.xml

@@ -88,7 +88,7 @@
 
     <para>На этой стадии дерево разбора создаётся только с фиксированными знаниями о синтаксической структуре SQL. При его создании не просматриваются системные каталоги, что не даёт возможность понять конкретную семантику запрошенной операции. После этого выполняется <firstterm>процедура преобразования</firstterm>, которая принимает дерево разбора от анализатора и выполняет семантический анализ, необходимый для понимания, к каким именно таблицам, функциям и операторам обращается запрос. Структура данных, которая создаётся для представления этой информации, называется <firstterm>деревом запроса</firstterm>.</para>
 
-    <para>Синтетический разбор отделён от семантического анализа, потому что обращаться к системным каталогам можно только внутри транзакции, а начинать транзакцию сразу после получения строки с запросом нежелательно. Синтетического разбора достаточно, чтобы распознать команды управления транзакциями (<command>BEGIN</command>, <command>ROLLBACK</command> и т. д.), поэтому их можно выполнить без дальнейшего анализа. Убедившись, что мы имеем дело с собственно запросом (например, <command>SELECT</command> или <command>UPDATE</command>), можно начинать транзакцию, если она ещё не начата. Только после этого можно переходить к процедуре преобразования.</para>
+    <para>Синтаксический разбор отделён от семантического анализа, потому что обращаться к системным каталогам можно только внутри транзакции, а начинать транзакцию сразу после получения строки с запросом нежелательно. Синтаксического разбора достаточно, чтобы распознать команды управления транзакциями (<command>BEGIN</command>, <command>ROLLBACK</command> и т. д.), поэтому их можно выполнить без дальнейшего анализа. Убедившись, что мы имеем дело с собственно запросом (например, <command>SELECT</command> или <command>UPDATE</command>), можно начинать транзакцию, если она ещё не начата. Только после этого можно переходить к процедуре преобразования.</para>
 
     <para>Дерево запроса, создаваемое процедурой преобразования, по структуре во многом похоже на дерево разбора, но отличается во многих деталях. Например, узел <structname>FuncCall</structname> в дереве разбора представляет то, что по синтаксису похоже на вызов функции. Этот узел может быть преобразован в узел <structname>FuncExpr</structname> или <structname>Aggref</structname> в зависимости от того, какой (обычной или агрегатной) окажется функция с заданным именем. Кроме того, в дерево запроса добавляется информация о фактических типах данных столбцов и результатов выражений.</para>
    </sect2>

doc/src/xml/ru/demodb-bookings.xml

@@ -1,22 +1,17 @@
 <!-- doc/src/xml/ref/pg-setup.xml -->
 
 <refentry id="pg-setup">
- <indexterm zone="pg-setup">
-  <primary>pg-setup</primary>
- </indexterm>
+ <indexterm zone="pg-setup"><primary>pg-setup</primary></indexterm>
 
  <refmeta>
-  <refentrytitle><application>pg-setup
-  </application></refentrytitle>
+  <refentrytitle><application>pg-setup</application></refentrytitle>
   <manvolnum>1</manvolnum>
-  <refmiscinfo>Application</refmiscinfo>
+  <refmiscinfo>Приложение</refmiscinfo>
  </refmeta>
 
  <refnamediv>
   <refname>pg-setup</refname>
-  <refpurpose>set up a new <productname>&productname;</productname> database cluster
-  and manage the corresponding service
-  </refpurpose>
+  <refpurpose>создать кластер баз данных <productname>&productname;</productname> и управлять соответствующей службой</refpurpose>
  </refnamediv>
 
  <refsynopsisdiv>
@@ -25,7 +20,7 @@
      <group choice="plain">
        <arg choice="plain"><option>initdb</option></arg>
        <group choice="opt">
-         <replaceable>initdb-options</replaceable>
+         <replaceable>параметры_initdb</replaceable>
        </group>
      </group>
   </cmdsynopsis>
@@ -38,176 +33,99 @@
   <cmdsynopsis>
    <command>pg-setup</command>
      <group choice="plain">
-       <arg choice="plain"><option>set-server-port <replaceable>port</replaceable></option></arg>
+       <arg choice="plain"><option>set-server-port <replaceable>порт</replaceable></option></arg>
      </group>
   </cmdsynopsis>
 
   <cmdsynopsis>
    <command>pg-setup</command>
-       <arg choice="plain"><option>service</option></arg>
-       <group choice="req">
-         <arg choice="plain"><option>enable</option></arg>
-         <arg choice="plain"><option>disable</option></arg>
-         <arg choice="plain"><option>start</option></arg>
-         <arg choice="plain"><option>stop</option></arg>
-         <arg choice="plain"><option>condrestart</option></arg>
-       </group>
+       <arg choice="plain"><option>service <replaceable>параметр_service</replaceable></option></arg>
   </cmdsynopsis>
 
  </refsynopsisdiv>
 
  <refsect1>
-  <title>Description</title>
-
- <para>
-  <application>pg-setup</application> is a shell script provided in
-  the <productname>&productname;</productname> distribution to automate
-  database cluster setup on Linux systems. This script is provided as
-  part of the <filename>postgrespro-std-&majorversion;-server</filename>
-  package. Once <productname>&productname;</productname> is installed,
-  you can find <application>pg-setup</application>
-  in the <filename><replaceable>install-dir</replaceable>/bin</filename>
-  directory, where <replaceable>install-dir</replaceable> is
-  <filename>/opt/pgpro/std-&majorversion;</filename> by default.
- </para>
- <para>
-  <application>pg-setup</application> must be run as root, but performs database
-  administration operations as user <literal>postgres</literal>. You can run
-  this script with different options to:
-  <itemizedlist spacing="compact">
+  <title>Описание</title>
+
+ <para>Программа <application>pg-setup</application> представляет собой скрипт оболочки, включённый в дистрибутив <productname>&productname;</productname> и предназначенный для автоматизации установки кластера баз данных в системах Linux. Этот скрипт входит в состав пакета <filename>postgrespro-std-&majorversion;-server</filename>. После установки <productname>&productname;</productname> вы можете найти <application>pg-setup</application> в каталоге <filename><replaceable>каталог-инсталляции</replaceable>/bin</filename>, где <replaceable>каталог-инсталляции</replaceable> обозначает путь <filename>/opt/pgpro/std-&majorversion;</filename>.</para>
+ <para>Программу <application>pg-setup</application> нужно запускать от имени root, но она выполняет административные операции с базой данных под именем пользователя <literal>postgres</literal>. Запуская её с разными параметрами, вы можете: <itemizedlist spacing="compact">
     <listitem>
-      <para>
-       initialize the database cluster
-      </para>
+      <para>инициализировать кластер баз данных</para>
     </listitem>
     <listitem>
-      <para>
-       check for available ports and change the port used
-       by <productname>&productname;</productname> server
-      </para>
+      <para>проверить доступные порты и изменить порт, который будет использоваться сервером <productname>&productname;</productname></para>
     </listitem>
     <listitem>
-      <para>
-       enable/disable automatic startup of <productname>&productname;</productname> service
-      </para>
+      <para>включить/отключить автоматический запуск службы <productname>&productname;</productname></para>
     </listitem>
     <listitem>
-      <para>
-       start, stop, or restart <productname>&productname;</productname> service
-      </para>
+      <para>запустить, остановить или перезапустить службу <productname>&productname;</productname></para>
     </listitem>
-  </itemizedlist>
- </para>
+  </itemizedlist></para>
 
  </refsect1>
 
  <refsect1>
-  <title>Options</title>
-
-   <para>
-    <application>pg-setup</application> accepts the following command-line arguments:
+  <title>Параметры</title>
 
-    <variablelist>
+   <para><application>pg-setup</application> принимает следующие аргументы командной строки: <variablelist>
      <varlistentry>
-      <term><option>initdb [<replaceable>initdb-options</replaceable>]</option></term>
-      <listitem><para>Initialize the database cluster on behalf of the
-      <literal>postgres</literal> user. Optionally, you can provide
-      any <xref linkend="app-initdb"/> options to customize the installation.
-      </para>
-      <para>If no <application>initdb</application>
-      options are provided, the database cluster is initialized in the
-      <filename>/var/lib/pgpro/std-&majorversion;/data</filename> directory,
-      using localization settings specified in the <envar>LANG</envar>
-      environment variable for the current session.
-      All the <literal>LC_*</literal> environment variables are ignored.
-      </para>
+      <term><option>initdb [<replaceable>параметры_initdb</replaceable>]</option></term>
+      <listitem><para>Инициализировать кластер баз данных от имени пользователя <literal>postgres</literal>. Вы можете передать любые параметры <xref linkend="app-initdb"/> для тонкой настройки инсталляции.</para>
+      <para>Если параметры <application>initdb</application> не передаются, кластер баз данных создаётся в каталоге <filename>/var/lib/pgpro/std-&majorversion;/data</filename> с параметрами локализации, определяемыми переменной окружения <envar>LANG</envar> текущего сеанса. Переменные окружения <literal>LC_*</literal> при этом игнорируются.</para>
+      <note>
+      <para><application>pg-setup</application> инициализирует кластер баз данных со включёнными контрольными суммами. Если для вас это нежелательно, не используйте <application>pg-setup</application> для инициализации кластера, а запустите непосредственно <xref linkend="app-initdb"/>.</para>
+      </note>
       </listitem>
      </varlistentry>
 
      <varlistentry>
       <term><option>find-free-port</option></term>
-      <listitem><para>Search for a free port on your system.
-      This option is useful if you are going to install more
-      than one server instance, or the default 5432 port is
-      used by another program.
-      </para>
+      <listitem><para>Найти свободный порт в системе. Это может быть полезно, если вы планируете устанавливать несколько экземпляров серверов, либо стандартный порт 5432 уже используется другой программой.</para>
       </listitem>
      </varlistentry>
 
      <varlistentry>
-      <term><option>set-server-port</option> <replaceable>port</replaceable></term>
-      <listitem><para>Specify the port number on which the server will
-      listen for connections. Use this option to avoid conflicts
-      if you are installing more than one server instance on the same system.
-      </para>
-      <para>
-      Default: 5432
-      </para>
+      <term><option>set-server-port</option> <replaceable>порт</replaceable></term>
+      <listitem><para>Задать номер порта, на котором сервер будет принимать соединения. Воспользуйтесь этой командой, чтобы избежать конфликтов, если вы устанавливаете в одной системе более одного сервера.</para>
+      <para>По умолчанию: 5432</para>
       </listitem>
      </varlistentry>
 
      <varlistentry>
-      <term><option>service</option> { <option>enable</option> | <option>disable</option> | <option>start</option> | <option>stop</option> | <option>condrestart</option> }</term>
-      <listitem><para>Manage <productname>&productname;</productname> service:
-      <itemizedlist spacing="compact">
+      <term><option>service <replaceable>параметр_service</replaceable></option></term>
+      <listitem><para>Управление службой <productname>&productname;</productname> с помощью следующих команд: <itemizedlist spacing="compact">
+        <listitem>
+          <para><literal>enable</literal> &mdash; включить автоматический запуск службы при перезагрузке системы.</para>
+        </listitem>
         <listitem>
-          <para>
-          <literal>enable</literal> &mdash; enable automatic service startup upon system restart.
-          </para>
+          <para><literal>disable</literal> &mdash; отключить автоматический запуск службы при перезагрузке системы.</para>
         </listitem>
         <listitem>
-          <para>
-          <literal>disable</literal> &mdash; disable automatic service startup upon system restart.
-          </para>
+          <para><literal>start</literal> &mdash; запустить службу.</para>
         </listitem>
         <listitem>
-          <para>
-          <literal>start</literal> &mdash; start the service.
-          </para>
+          <para><literal>stop</literal> &mdash; остановить службу.</para>
         </listitem>
         <listitem>
-          <para>
-          <literal>stop</literal> &mdash; stop the service.
-          </para>
+          <para><literal>condrestart</literal> &mdash; перезапустить службу, если она работает в момент вызова <application>pg-setup</application>.</para>
         </listitem>
         <listitem>
-          <para>
-          <literal>condrestart</literal> &mdash; restart the service if it is
-          running when <application>pg-setup</application> is invoked.
-          </para>
+          <para><literal>status</literal> &mdash; возвращает статус службы <productname>&productname;</productname>.</para>
         </listitem>
-      </itemizedlist>
-      </para>
+      </itemizedlist></para>
       </listitem>
      </varlistentry>
 
-    </variablelist>
-   </para>
+    </variablelist></para>
 
  </refsect1>
 
  <refsect1>
-  <title>Notes</title>
-  <para>
-    If you are installing <productname>&productname;</productname>
-    from the <filename>postgrespro-std-&majorversion;</filename> package,
-    <application>pg-setup</application> is invoked automatically with the default settings.
-    As a result, the database cluster is initialized and the
-    default database is created in the
-    <filename>/var/lib/pgpro/std-&majorversion;/data</filename> directory,
-    <productname>&productname;</productname> service autostart is enabled,
-    and the service is started.
-  </para>
-  <para>
-    If you are installing <productname>&productname;</productname> server
-    directly from the <filename>postgrespro-std-&majorversion;-server</filename>
-    package, you can run this script manually to initialize the database cluster
-    or manage the <productname>&productname;</productname> service.
-  </para>
-  <para>
-    For details on binary installation specifics on Linux,
-    see <xref linkend="binary-installation-on-linux"/>.
-  </para>
+  <title>Замечания</title>
+  <para>Если вы устанавливаете <productname>&productname;</productname> из пакета <filename>postgrespro-std-&majorversion;</filename>, <application>pg-setup</application> вызывается автоматически с параметрами по умолчанию. В результате создаётся кластер баз данных и база по умолчанию в каталоге <filename>/var/lib/pgpro/std-&majorversion;/data</filename>, настраивается автозапуск службы <productname>&productname;</productname> и служба запускается.</para>
+  <para>Если вы устанавливаете сервер <productname>&productname;</productname> непосредственно из пакета <filename>postgrespro-std-&majorversion;-server</filename>, вы должны запустить этот скрипт вручную для инициализации кластера баз данных или управления службой <productname>&productname;</productname>.</para>
+  <para>Установка из двоичных пакетов в Linux подробно описана в <xref remap="6" linkend="binary-installation-on-linux"/>.</para>
  </refsect1>
 
 </refentry>