diff --git a/reference/ps/functions/ps-hyphenate.xml b/reference/ps/functions/ps-hyphenate.xml
index 260549b9e..86664e7d2 100644
--- a/reference/ps/functions/ps-hyphenate.xml
+++ b/reference/ps/functions/ps-hyphenate.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: b95d28e6ec86e4a71e012737d36ebdc1cf009180 Maintainer: evvc Status: ready -->
+<!-- EN-Revision: 61374bbe228e8e9c55a24aba59a1e2bb2a871148 Maintainer: evvc Status: ready -->
 <!-- Reviewed: no -->
 <refentry xml:id="function.ps-hyphenate" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
@@ -20,9 +20,9 @@
    Перед вызовом этой функции необходимо установить дефис.
   </para>
   <para>
-   Для работы функции требуется, чтобы категория языкового стандарта LC_CTYPE была установлена корректно.
-   Это делается, при инициализации модуля с использованием переменных окружения.
-   В системах Unix для получения дополнительной информации прочтите справочную страницу языковых стандартов.
+   Для работы функции требуется, чтобы категорию языкового стандарта <constant>LC_CTYPE</constant> установили корректно.
+   Это делается при инициализации модуля с использованием переменных окружения.
+   В системах Unix дополнительную информацию дают справочные страницы языковых стандартов.
   </para>
  </refsect1>
 
@@ -43,9 +43,9 @@
      <term><parameter>text</parameter></term>
      <listitem>
       <para>
-       <parameter>text</parameter> не должен содержать никаких символов, отличных от букв.
+       Параметр <parameter>text</parameter> не должен содержать символов, которые отличаются от букв.
        Возможные позиции для переносов возвращаются в виде массива целых чисел.
-       Каждое число - это позиция символа в <parameter>text</parameter>,
+       Каждое число — позиция символа в значении <parameter>text</parameter>,
        после которой может быть выполнен перенос.
       </para>
      </listitem>
@@ -57,7 +57,8 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   Массив целых чисел, указывающий положение возможных переносов в тексте&return.falseforfailure;.
+   Функция возвращает массив целых чисел, который указывает
+   положение возможных переносов в тексте&return.falseforfailure;.
   </para>
  </refsect1>
 
@@ -69,16 +70,23 @@
     <programlisting role="php">
 <![CDATA[
 <?php
+
 $word = "Koordinatensystem";
 $psdoc = ps_new();
+
 ps_set_parameter($psdoc, "hyphendict", "hyph_de.dic");
+
 $hyphens = ps_hyphenate($psdoc, $word);
-for($i=0; $i<strlen($word); $i++) {
+
+for ($i=0; $i < strlen($word); $i++) {
   echo $word[$i];
-  if(in_array($i, $hyphens))
+
+  if (in_array($i, $hyphens))
     echo "-";
 }
+
 ps_delete($psdoc);
+
 ?>
 ]]>
     </programlisting>