diff --git a/reference/ssh2/functions/ssh2-auth-pubkey-file.xml b/reference/ssh2/functions/ssh2-auth-pubkey-file.xml
index 6776ac125..359da70f5 100644
--- a/reference/ssh2/functions/ssh2-auth-pubkey-file.xml
+++ b/reference/ssh2/functions/ssh2-auth-pubkey-file.xml
@@ -1,10 +1,10 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 12f0e72200ea9249d0fc2f118528bd24b24c44a6 Maintainer: rjhdby Status: ready -->
+<!-- EN-Revision: 74ef2355c59e814d14f75a0792d22727be72f137 Maintainer: rjhdby Status: ready -->
 <!-- Reviewed: no -->
 <refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.ssh2-auth-pubkey-file">
  <refnamediv>
   <refname>ssh2_auth_pubkey_file</refname>
-  <refpurpose>Аутентификация с открытым ключом</refpurpose>
+  <refpurpose>Аутентифицирует клиента путём считывания открытого ключа из файла</refpurpose>
  </refnamediv>
 
  <refsect1 role="description">
@@ -18,7 +18,7 @@
    <methodparam choice="opt"><type>string</type><parameter>passphrase</parameter></methodparam>
   </methodsynopsis>
   <simpara>
-   Аутентификация с открытым ключом, сохранённом в файле.
+   Функция аутентифицирует клиента по открытому ключу, который считывает из файла.
   </simpara>
  </refsect1>
 
@@ -29,8 +29,8 @@
     <term><parameter>session</parameter></term>
     <listitem>
      <simpara>
-      Идентификатор соединения SSH, полученный из
-      <function>ssh2_connect</function>.
+      Идентификатор канала SSH-соединения, который вернула
+      функция <function>ssh2_connect</function>.
      </simpara>
     </listitem>
    </varlistentry>
@@ -38,6 +38,7 @@
     <term><parameter>username</parameter></term>
     <listitem>
      <simpara>
+      Имя пользователя, от лица которого требуется выполнить аутентификацию на удалённом сервере.
      </simpara>
     </listitem>
    </varlistentry>
@@ -45,7 +46,7 @@
     <term><parameter>pubkeyfile</parameter></term>
     <listitem>
      <simpara>
-      Открытый ключ в формате OpenSSH. Должен выглядеть примерно так:
+      Открытый ключ в формате OpenSSH, строка наподобие:
      </simpara>
      <simpara>
       ssh-rsa AAAAB3NzaC1yc2EAAA....NX6sqSnHA8= rsa-key-20121110
@@ -56,6 +57,7 @@
     <term><parameter>privkeyfile</parameter></term>
     <listitem>
      <simpara>
+      Путь к файлу закрытого OpenSSH-ключа.
      </simpara>
     </listitem>
    </varlistentry>
@@ -63,8 +65,9 @@
     <term><parameter>passphrase</parameter></term>
     <listitem>
      <simpara>
-      Если <parameter>privkeyfile</parameter> зашифрован (как должен бы),
-      то необходимо предоставить <parameter>passphrase</parameter>.
+      Парольная фраза для расшифровки закрытого ключа <parameter>privkey</parameter>.
+      Парольную фразу передают в параметр <parameter>passphrase</parameter>,
+      только если выполняются требования безопасности и закрытый ключ хранится в зашифрованном виде.
      </simpara>
     </listitem>
    </varlistentry>
@@ -81,20 +84,24 @@
  <refsect1 role="examples">
   &reftitle.examples;
   <example>
-   <title>Аутентификация с открытым ключом</title>
+   <title>Пример аутентификации по открытому ключу</title>
    <programlisting role="php">
 <![CDATA[
 <?php
-$connection = ssh2_connect('shell.example.com', 22, array('hostkey'=>'ssh-rsa'));
 
-if (ssh2_auth_pubkey_file($connection, 'username',
-                          '/home/username/.ssh/id_rsa.pub',
-                          '/home/username/.ssh/id_rsa', 'secret')) {
-  echo "Успешная аутентификация с открытым ключом\n";
+$connection = ssh2_connect('shell.example.com', 22, array('hostkey' => 'ssh-rsa'));
+
+if (ssh2_auth_pubkey_file(
+    $connection,
+    'username',
+    '/home/username/.ssh/id_rsa.pub',
+    '/home/username/.ssh/id_rsa',
+    'secret'
+)) {
+    echo "Клиент прошёл аутентификацию по открытому ключу\n";
 } else {
-  die('Неудачная аутентификация с открытым ключом');
+    die('Открытый ключ не подтвердил подлинность клиента');
 }
-?>
 ]]>
    </programlisting>
   </example>
@@ -104,13 +111,23 @@ if (ssh2_auth_pubkey_file($connection, 'username',
   &reftitle.notes;
   <note>
    <simpara>
-    Основная библиотека libssh не поддерживает частичные аутентификации очень чисто.
-    То есть,  если вам нужно предоставить как открытый ключ, так и пароль, он будет выглядеть так, как если бы эта функция потерпела неудачу. В данном конкретном случае неудачный вызов
-    может означать, что аутентификация не завершена. Вам нужно игнорировать это неудачное выполнение, продолжить работу и вызвать <function>ssh2_auth_password</function> для завершения аутентификации.
+    Библиотека libssh, на базе которой работает PHP-модуль SSH2, не поддерживает
+    частичное подтверждение подлинности на серверах с многофакторной аутентификацией,
+    при которой требуется проверка и открытого ключа, и пароля. Поэтому на шаге проверки
+    открытого ключа возврат значения &false; часто указывает не на ошибку, а только на незавершённость процесса аутентификации.
+    При многоступенчатой аутентификации ошибку игнорируют
+    и вызывают функцию <function>ssh2_auth_password</function>, чтобы завершить аутентификацию.
    </simpara>
   </note>
  </refsect1>
 
+ <refsect1 role="seealso">
+  &reftitle.seealso;
+  <simplelist>
+   <member><function>ssh2_auth_pubkey</function></member>
+  </simplelist>
+ </refsect1>
+
 </refentry>
 <!-- Keep this comment at the end of the file
 Local variables:
diff --git a/reference/ssh2/functions/ssh2-auth-pubkey.xml b/reference/ssh2/functions/ssh2-auth-pubkey.xml
new file mode 100644
index 000000000..9371584c5
--- /dev/null
+++ b/reference/ssh2/functions/ssh2-auth-pubkey.xml
@@ -0,0 +1,152 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- EN-Revision: 74ef2355c59e814d14f75a0792d22727be72f137 Maintainer: malferov Status: ready -->
+<!-- Reviewed: no -->
+<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.ssh2-auth-pubkey">
+ <refnamediv>
+  <refname>ssh2_auth_pubkey</refname>
+  <refpurpose>Аутентифицирует клиента по открытому ключу в переменной</refpurpose>
+ </refnamediv>
+
+ <refsect1 role="description">
+  &reftitle.description;
+  <methodsynopsis>
+   <type>bool</type><methodname>ssh2_auth_pubkey</methodname>
+   <methodparam><type>resource</type><parameter>session</parameter></methodparam>
+   <methodparam><type>string</type><parameter>username</parameter></methodparam>
+   <methodparam><type>string</type><parameter>pubkey</parameter></methodparam>
+   <methodparam><type>string</type><parameter>privkey</parameter></methodparam>
+   <methodparam choice="opt"><type>string</type><parameter>passphrase</parameter></methodparam>
+  </methodsynopsis>
+  <simpara>
+   Функция аутентифицирует клиента по открытому ключу, который содержит переменная.
+  </simpara>
+ </refsect1>
+
+ <refsect1 role="parameters">
+  &reftitle.parameters;
+  <variablelist>
+   <varlistentry>
+    <term><parameter>session</parameter></term>
+    <listitem>
+     <simpara>
+      Идентификатор канала SSH-соединения, который вернула
+      функция <function>ssh2_connect</function>.
+     </simpara>
+    </listitem>
+   </varlistentry>
+   <varlistentry>
+    <term><parameter>username</parameter></term>
+    <listitem>
+     <simpara>
+       Имя пользователя, от лица которого требуется выполнить аутентификацию на удалённом сервере.
+     </simpara>
+    </listitem>
+   </varlistentry>
+   <varlistentry>
+    <term><parameter>pubkey</parameter></term>
+    <listitem>
+     <simpara>
+      Открытый ключ в формате OpenSSH, строка наподобие:
+      <literal>ssh-rsa AAAAB3NzaC1yc2EAAA....NX6sqSnHA8= rsa-key-20121110</literal>
+     </simpara>
+    </listitem>
+   </varlistentry>
+   <varlistentry>
+    <term><parameter>privkey</parameter></term>
+    <listitem>
+     <simpara>
+      Закрытый OpenSSH-ключ, который начинается со строки:
+      <literal>-----BEGIN RSA PRIVATE KEY-----</literal>
+     </simpara>
+    </listitem>
+   </varlistentry>
+   <varlistentry>
+    <term><parameter>passphrase</parameter></term>
+    <listitem>
+     <simpara>
+      Парольная фраза для расшифровки закрытого ключа <parameter>privkey</parameter>.
+      Парольную фразу передают в параметр <parameter>passphrase</parameter>,
+      только если выполняются требования безопасности и закрытый ключ хранится в зашифрованном виде.
+     </simpara>
+    </listitem>
+   </varlistentry>
+  </variablelist>
+ </refsect1>
+
+ <refsect1 role="returnvalues">
+  &reftitle.returnvalues;
+  <simpara>
+   &return.success;
+  </simpara>
+ </refsect1>
+
+ <refsect1 role="examples">
+  &reftitle.examples;
+  <example>
+   <title>Пример аутентификации с открытым ключом</title>
+   <programlisting role="php">
+<![CDATA[
+<?php
+
+$connection = ssh2_connect('shell.example.com', 22, array('hostkey' => 'ssh-rsa'));
+$publicKey = file_get_contents('/home/username/.ssh/id_rsa.pub');
+$privateKey = file_get_contents('/home/username/.ssh/id_rsa');
+
+if (ssh2_auth_pubkey(
+    $connection,
+    'username',
+    $publicKey,
+    $privateKey,
+    'secret'
+)) {
+    echo "Клиент прошёл аутентификацию по открытому ключу\n";
+} else {
+    die('Открытый ключ не подтвердил подлинность клиента');
+}
+]]>
+   </programlisting>
+  </example>
+ </refsect1>
+
+ <refsect1 role="notes">
+  &reftitle.notes;
+  <note>
+   <simpara>
+    Библиотека libssh, на базе которой работает PHP-модуль SSH2, не поддерживает
+    частичное подтверждение подлинности на серверах с многофакторной аутентификацией,
+    при которой требуется проверка и открытого ключа, и пароля. Поэтому на шаге проверки
+    открытого ключа возврат значения &false; часто указывает не на ошибку, а только на незавершённость процесса аутентификации.
+    При многоступенчатой аутентификации ошибку игнорируют
+    и вызывают функцию <function>ssh2_auth_password</function>, чтобы завершить аутентификацию.
+   </simpara>
+  </note>
+ </refsect1>
+
+ <refsect1 role="seealso">
+  &reftitle.seealso;
+  <simplelist>
+   <member><function>ssh2_auth_pubkey_file</function></member>
+  </simplelist>
+ </refsect1>
+
+</refentry>
+<!-- Keep this comment at the end of the file
+Local variables:
+mode: sgml
+sgml-omittag:t
+sgml-shorttag:t
+sgml-minimize-attributes:nil
+sgml-always-quote-attributes:t
+sgml-indent-step:1
+sgml-indent-data:t
+indent-tabs-mode:nil
+sgml-parent-document:nil
+sgml-default-dtd-file:"~/.phpdoc/manual.ced"
+sgml-exposed-tags:nil
+sgml-local-catalogs:nil
+sgml-local-ecat-files:nil
+End:
+vim600: syn=xml fen fdm=syntax fdl=2 si
+vim: et tw=78 syn=sgml
+vi: ts=1 sw=1
+-->
diff --git a/reference/ssh2/functions/ssh2-connect.xml b/reference/ssh2/functions/ssh2-connect.xml
index 1d8c51d68..0212291bb 100644
--- a/reference/ssh2/functions/ssh2-connect.xml
+++ b/reference/ssh2/functions/ssh2-connect.xml
@@ -1,10 +1,10 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 12f0e72200ea9249d0fc2f118528bd24b24c44a6 Maintainer: rjhdby Status: ready -->
+<!-- EN-Revision: 74ef2355c59e814d14f75a0792d22727be72f137 Maintainer: rjhdby Status: ready -->
 <!-- Reviewed: no -->
 <refentry xmlns:xlink="http://www.w3.org/1999/xlink" xmlns="http://docbook.org/ns/docbook" xml:id="function.ssh2-connect">
  <refnamediv>
   <refname>ssh2_connect</refname>
-  <refpurpose>Подключение к SSH-серверу</refpurpose>
+  <refpurpose>Подключается к серверу по протоколу SSH</refpurpose>
  </refnamediv>
 
  <refsect1 role="description">
@@ -17,12 +17,12 @@
    <methodparam choice="opt"><type>array</type><parameter>callbacks</parameter></methodparam>
   </methodsynopsis>
   <simpara>
-   Устанавливает соединение с сервером по SSH.
+   Функция устанавливает соединение с сервером по протоколу SSH.
   </simpara>
   <simpara>
-   После соединения, пользователь должен проверить ключ сервера, используя функцию
-   <function>ssh2_fingerprint</function>, и после этого авторизоваться, используя
-   пароль или открытый ключ.
+   После установки соединения клиенту потребуется проверить ключ хоста сервера
+   функцией <function>ssh2_fingerprint</function>,
+   а затем пройти аутентификацию по паролю или открытому ключу.
   </simpara>
  </refsect1>
 
@@ -33,6 +33,7 @@
     <term><parameter>host</parameter></term>
     <listitem>
      <simpara>
+      Хост.
      </simpara>
     </listitem>
    </varlistentry>
@@ -40,6 +41,7 @@
     <term><parameter>port</parameter></term>
     <listitem>
      <simpara>
+      Номер порта.
      </simpara>
     </listitem>
    </varlistentry>
@@ -47,17 +49,16 @@
     <term><parameter>methods</parameter></term>
     <listitem>
      <simpara>
-      Параметр <parameter>methods</parameter> может быть ассоциативным массивом,
-      содержащим до четырёх записей, перечисленных ниже.
+      Параметр <parameter>methods</parameter> — ассоциативный массив,
+      который содержит одно или все следующие значения.
      </simpara>
      <table>
-      <title>Параметр <parameter>methods</parameter> может быть ассоциативным
-       массивом, содержащим от одного до четырёх параметров</title>
+      <title>Допустимые значения параметра <parameter>methods</parameter></title>
       <tgroup cols="3">
        <thead>
         <row>
          <entry>Индекс</entry>
-         <entry>Что обозначает</entry>
+         <entry>Обозначение</entry>
          <entry>Допустимые значения*</entry>
         </row>
        </thead>
@@ -65,40 +66,40 @@
         <row>
          <entry>kex</entry>
          <entry>
-          Список методов обмена ключами, разделённых запятой, в порядке предпочтения.
+          Список значений для объявления способов обмена ключами. Значения разделяют запятой и указывают в порядке убывания приоритета.
          </entry>
          <entry>
           <literal>diffie-hellman-group1-sha1</literal>,
-          <literal>diffie-hellman-group14-sha1</literal>, и
-          <literal>diffie-hellman-group-exchange-sha1</literal>
+          <literal>diffie-hellman-group14-sha1</literal>
+          и <literal>diffie-hellman-group-exchange-sha1</literal>
          </entry>
         </row>
         <row>
          <entry>hostkey</entry>
          <entry>
-          Список методов ключей хоста, разделённых запятой,
-          в порядке предпочтения.
+          Список значений для объявления методов проверки подлинности ключей хоста.
+          Значения разделяют запятой и указывают в порядке убывания приоритета.
          </entry>
          <entry>
-          <literal>ssh-rsa</literal> и
-          <literal>ssh-dss</literal>
+          <literal>ssh-rsa</literal>
+          и <literal>ssh-dss</literal>
          </entry>
         </row>
         <row>
          <entry>client_to_server</entry>
          <entry>
-          Ассоциативный массив, содержащий настройки шифрования, сжатия и
-          метода имитовставки ("message authentication code" или MAC) для
-          сообщений, отправленных клиентом серверу.
+          Ассоциативный массив с настройками шифрования,
+          сжатия и метода имитовставки (Англ. Message Authentication Code, сокр. MAC)
+          для сообщений в направлении клиент — сервер.
          </entry>
          <entry/>
         </row>
         <row>
          <entry>server_to_client</entry>
          <entry>
-          Ассоциативный массив, содержащий настройки шифрования, сжатия и
-          метода имитовставки ("message authentication code" или MAC) для
-          сообщений, отправленных сервером клиенту.
+          Ассоциативный массив с настройками шифрования,
+          сжатия и метода имитовставки
+          для сообщений в направлении сервер — клиент.
          </entry>
          <entry/>
         </row>
@@ -106,27 +107,27 @@
       </tgroup>
      </table>
      <simpara>
-      * - Поддерживаемые значения зависят от методов, поддерживаемых базовой библиотекой.
-      Более подробно читайте документацию по <link xlink:href="&url.libssh2;">libssh2</link>.
+      * — Поддерживаемые значения зависят от методов, которые поддерживает базовая библиотека.
+      Дополнительную информацию даёт <link xlink:href="&url.libssh2;">документация к libssh2</link>.
      </simpara>
      <table>
       <title>
-       <parameter>client_to_server</parameter> и
-       <parameter>server_to_client</parameter> могут быть ассоциативными массивами,
-       содержащими любой или же все нижеперечисленные параметры.
+       <parameter>client_to_server</parameter>
+       и <parameter>server_to_client</parameter> — ассоциативные массивы
+       с одним или всеми следующими параметрами.
       </title>
       <tgroup cols="3">
        <thead>
         <row>
          <entry>Индекс</entry>
-         <entry>Что обозначает</entry>
+         <entry>Обозначение</entry>
          <entry>Допустимые значения*</entry>
         </row>
        </thead>
        <tbody>
         <row>
          <entry>crypt</entry>
-         <entry>Список методов шифрования, разделённых запятой, в порядке предпочтения.</entry>
+         <entry>Список значений для объявления методов шифрования. Значения разделяют запятой и указывают в порядке убывания приоритета.</entry>
          <entry>
           <literal>rijndael-cbc@lysator.liu.se</literal>,
           <literal>aes256-cbc</literal>,
@@ -135,39 +136,39 @@
           <literal>3des-cbc</literal>,
           <literal>blowfish-cbc</literal>,
           <literal>cast128-cbc</literal>,
-          <literal>arcfour</literal> и
-          <literal>none**</literal>
+          <literal>arcfour</literal>
+          и <literal>none**</literal>
          </entry>
         </row>
         <row>
          <entry>comp</entry>
-         <entry>Список методов сжатия, разделённых запятой, в порядке предпочтения.</entry>
+         <entry>Список методов для объявления способов сжатия. Значения разделяют запятой и указывают в порядке убывания приоритета.</entry>
          <entry>
-          <literal>zlib</literal> и
-          <literal>none</literal>
+          <literal>zlib</literal>
+          и <literal>none</literal>
          </entry>
         </row>
         <row>
          <entry>mac</entry>
-         <entry>Список методов MAC, разделённых запятой, в порядке предпочтения.</entry>
+         <entry>Список методов для объявления способа вычисления MAC. Значения разделяют запятой и указывают в порядке убывания приоритета.</entry>
          <entry>
           <literal>hmac-sha1</literal>,
           <literal>hmac-sha1-96</literal>,
           <literal>hmac-ripemd160</literal>,
-          <literal>hmac-ripemd160@openssh.com</literal> и
-          <literal>none**</literal>
+          <literal>hmac-ripemd160@openssh.com</literal>
+          и <literal>none**</literal>
          </entry>
         </row>
        </tbody>
       </tgroup>
      </table>
      <note>
-      <title>Метод шифрования "<literal>none</literal>" и MAC</title>
+      <title>Значение "<literal>none</literal>" вместо алгоритма шифрования и способа вычисления MAC</title>
       <simpara>
-       В целях безопасности <literal>none</literal> отключён в базовой библиотеке
-       <link xlink:href="&url.libssh2;">libssh2</link>, если вы не разрешили его
-       самостоятельно на этапе сборки, используя соответствующие ключи ./configure.
-       Смотрите документацию по базовой библиотеки для более подробной информации.
+       В библиотеке <link xlink:href="&url.libssh2;">libssh2</link>, на базе которой работает PHP-модуль SSH2,
+       поддержку значения <literal>none</literal> преднамеренно отключают по соображениям безопасности.
+       Поддержку значения добавляют на этапе сборки: указывают в команде ./configure параметр, который включает поддержку значения.
+       Дополнительную информацию даёт документация к базовой библиотеке.
       </simpara>
      </note>
     </listitem>
@@ -176,8 +177,8 @@
     <term><parameter>callbacks</parameter></term>
     <listitem>
      <para>
-      <parameter>callbacks</parameter> может быть ассоциативным массивом,
-      содержащим любой или же все нижеперечисленные параметры
+      Параметр <parameter>callbacks</parameter> — ассоциативный массив,
+      который содержит один или все следующие параметры:
       <table>
        <title>
         Параметры callback-функции
@@ -186,7 +187,7 @@
         <thead>
          <row>
           <entry>Индекс</entry>
-          <entry>Что обозначает</entry>
+          <entry>Обозначение</entry>
           <entry>Прототип</entry>
          </row>
         </thead>
@@ -194,7 +195,7 @@
          <row>
           <entry>ignore</entry>
           <entry>
-           Имя функции, вызываемой после получения пакета
+           Название функции для вызова при получении пакета
            <constant>SSH2_MSG_IGNORE</constant>
           </entry>
           <entry>void ignore_cb($message)</entry>
@@ -202,7 +203,7 @@
          <row>
           <entry>debug</entry>
           <entry>
-           Имя функции, вызываемой после получения пакета
+           Название функции для вызова при получении пакета
            <constant>SSH2_MSG_DEBUG</constant>
           </entry>
           <entry>void debug_cb($message, $language, $always_display)</entry>
@@ -210,17 +211,17 @@
          <row>
           <entry>macerror</entry>
           <entry>
-           Имя функции, вызываемой если пакет получен, но
-           MAC не удался. Если callback-функция вернёт &true;,
-           несовпадение будет проигнорировано, в обратном случае
-           соединение будет оборвано.
+           Название функции для вызова при получении пакета
+           с неправильным кодом аутентификации сообщения (англ. Message Authentication Code, сокр. MAC).
+           При возврате из callback-функции значения &true; несоответствие MAC игнорируется,
+           иначе соединение обрывается.
           </entry>
           <entry>bool macerror_cb($packet)</entry>
          </row>
          <row>
           <entry>disconnect</entry>
           <entry>
-           Имя функции, вызываемой после получения пакета
+           Название функции для вызова при получении пакета
            <constant>SSH2_MSG_DISCONNECT</constant>
           </entry>
           <entry>void disconnect_cb($reason, $message, $language)</entry>
@@ -237,42 +238,51 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <simpara>
-   Возвращает ресурс в случае успешного выполнения или &false; в случае возникновения ошибки.
+   Функция возвращает ресурс, если выполнилась успешно, или &false;, если возникла ошибка.
   </simpara>
  </refsect1>
 
  <refsect1 role="examples">
   &reftitle.examples;
   <example>
-   <title>Пример <function>ssh2_connect</function></title>
+   <title>Пример установки соединения функцией <function>ssh2_connect</function></title>
    <simpara>
-    Откроем соединение, принудительно используя такие настройки: 3des-cbc при отправке
-    пакетов, шифр aes любой силы при получении пакетов, без сжатия в обоих направлениях
-    и обмен ключами Group1.
+    Пример открывает соединение со следующими настройками: при отправке шифровать пакеты по алгоритму 3DES-CBC,
+    принимать пакеты с AES-шифром произвольной стойкости, не применять сжатие в обоих направлениях
+    и обмениваться ключами по спецификации Group1.
    </simpara>
    <programlisting role="php">
 <![CDATA[
 <?php
-/* Оповещаем пользователя, если сервер прервал соединение */
-function my_ssh_disconnect($reason, $message, $language) {
-  printf("Сервер отключился с кодом причины [%d] и сообщением: %s\n",
-         $reason, $message);
+
+/* Уведомляет пользователя о разрыве соединения сервером */
+function my_ssh_disconnect($reason, $message, $language)
+{
+    printf(
+        "Сервер отключился с кодом причины [%d] и сообщением: %s\n",
+        $reason,
+        $message
+    );
 }
 
 $methods = array(
-  'kex' => 'diffie-hellman-group1-sha1',
-  'client_to_server' => array(
-    'crypt' => '3des-cbc',
-    'comp' => 'none'),
-  'server_to_client' => array(
-    'crypt' => 'aes256-cbc,aes192-cbc,aes128-cbc',
-    'comp' => 'none'));
+    'kex' => 'diffie-hellman-group1-sha1',
+    'client_to_server' => array(
+        'crypt' => '3des-cbc',
+        'comp' => 'none'
+    ),
+    'server_to_client' => array(
+        'crypt' => 'aes256-cbc,aes192-cbc,aes128-cbc',
+        'comp' => 'none'
+    )
+);
 
 $callbacks = array('disconnect' => 'my_ssh_disconnect');
 
 $connection = ssh2_connect('shell.example.com', 22, $methods, $callbacks);
-if (!$connection) die('Не удалось установить соединение');
-?>
+if (!$connection) {
+    die('Невозможно установить соединение');
+}
 ]]>
    </programlisting>
   </example>
@@ -284,6 +294,7 @@ if (!$connection) die('Не удалось установить соединен
    <member><function>ssh2_fingerprint</function></member>
    <member><function>ssh2_auth_none</function></member>
    <member><function>ssh2_auth_password</function></member>
+   <member><function>ssh2_auth_pubkey</function></member>
    <member><function>ssh2_auth_pubkey_file</function></member>
    <member><function>ssh2_disconnect</function></member>
   </simplelist>