property-hooks.xml Исправил ошибки и формулировки

Author: mmalferov

language/oop5/property-hooks.xml

@@ -86,29 +86,27 @@ class Example
 $example = new Example();
 $example->foo = 'changed';
 print $example->foo;
-
-?>
 ]]>
    </programlisting>
   </example>
   <simpara>
    Объявление свойства <varname>$foo</varname> заканчивается фигурными скобками <literal>{}</literal>, а не точкой с запятой.
-   Это указывает на то, что для свойства определили хуки.
+   Фигурные скобки указывают, что для свойства определили хуки.
    В примере определили оба хука — и <literal>get</literal>, и <literal>set</literal>,
    хотя разрешается определять отдельно один или другой.
-   Обоим хуках определили тела, которые также обозначили фигурными скобками <literal>{}</literal>.
-   В теле разрешается записывать произвольный код.
+   Для каждого хука определили тело, которое обозначается фигурными скобками <literal>{}</literal>.
+   В теле записывают произвольный код.
   </simpara>
   <simpara>
-   Хук <literal>set</literal> дополнительно разрешает указывать тип и название входящего значения,
-   тем же синтаксисом, которым в методах объявляют параметры.
+   Хук <literal>set</literal> дополнительно поддерживает объявление типа и названия входящего значения
+   синтаксисом, аналогичным объявлению параметров в методах.
    Тип значения указывается либо с ограничением как у типа свойства,
    либо <link linkend="language.oop5.variance.contravariance">контравариантным</link> к значению —
    с более широким, или слабым, ограничением.
    Например, для свойства с типом <type>string</type>
-   в хуке <literal>set</literal> разрешается определять параметр, который принимает типы
+   в хуке <literal>set</literal> возможно определить параметр с типом
    <type class="union"><type>string</type><type>Stringable</type></type>,
-   но нельзя определить только тип <type>array</type>.
+   но нельзя определить параметр с типом <type>array</type>, поскольку тип <type>array</type> не принадлежит ни самому строковому типу, ни надтипу строки.
   </simpara>
   <simpara>
    В примере по крайней мере один хук ссылается на само свойство <code>$this->foo</code>,
@@ -146,8 +144,6 @@ class Example
         }
     }
 }
-
-?>
 ]]>
    </programlisting>
   </example>
@@ -178,8 +174,6 @@ class Example
         }
     }
 }
-
-?>
 ]]>
    </programlisting>
   </example>
@@ -201,8 +195,6 @@ class Example
         set => strtolower($value);
     }
 }
-
-?>
 ]]>
    </programlisting>
   </example>
@@ -318,8 +310,6 @@ class Example
         }
     }
 }
-
-?>
 ]]>
    </programlisting>
   </example>
@@ -349,26 +339,24 @@ class Rectangle
 $s = new Rectangle(4, 5);
 print $s->area; // Выводит 20
 $s->area = 30; // Ошибка, поскольку для свойства не определили комбинацию записи
-
-?>
 ]]>
    </programlisting>
   </example>
   <simpara>
-   Для виртуального свойства разрешается определять оба хука, как <literal>get</literal>, так и <literal>set</literal>.
+   Для виртуальных свойств поддерживается определение обоих хуков: <literal>get</literal> и <literal>set</literal>.
   </simpara>
  </sect2>
  <sect2>
   <title>Об области видимости</title>
   <simpara>
-   Хуки действуют в области видимости модифицуируемого объекта.
+   Хуки действуют в области видимости модифицируемого объекта.
    Поэтому хукам доступны открытые, защищённые и закрытые методы и свойства объекта,
-   включая свойства со своими хуками.
-   Доступ к другому свойству из хука не обходит хуки, которые определили для другого свойства.
+   включая свойства с хуками.
+   Хуки свойств срабатывают при каждом обращении к свойству, даже при обращении из хука другого свойства.
   </simpara>
   <simpara>
-   Следствие этого состоит в том, что нетривиальным хукам доступен
-   вызов метода произвольной сложности, если потребуется.
+   За счёт доступа к членам объекта и срабатывания при каждой операции чтения или записи
+   хуки поддерживают не только тривиальную логику, но и, если потребуется, вызов методов произвольной сложности.
   </simpara>
   <example>
    <title>Пример вызова метода из хука</title>
@@ -394,8 +382,6 @@ class Person
         return $value;
     }
 }
-
-?>
 ]]>
    </programlisting>
   </example>
@@ -466,8 +452,6 @@ class Manager extends User
         set => strtoupper($value);
     }
 }
-
-?>
 ]]>
     </programlisting>
    </example>
@@ -482,10 +466,10 @@ class Manager extends User
     Это то же поведение, что и у окончательных методов.
    </simpara>
    <simpara>
-    В дочернем классе разрешается определять или переопределять отдельные хуки для свойства
-    путём переопределения свойства и только тех хуков, которые классу требуется переопределить.
-    В дочернем классе также возможно добавить хуки к свойству, для которого хуки не определили прежде.
-    Практически, это то же самое, как если бы хуки были методами.
+    Подклассы поддерживают определение своих хуков и переопределение отдельных хуков родительских свойств.
+    В подклассах хуки переопределяют путём переопределения свойства только с конкретными хуками.
+    Дочерние классы поддерживают также добавление свойствам хуков, которые не определили в родительском классе.
+    Практически, правила переопределения хуков аналогичны правилам переопределения методов.
    </simpara>
    <example>
     <title>Наследование хуков</title>
@@ -511,8 +495,6 @@ class PositivePoint extends Point
         }
     }
 }
-
-?>
 ]]>
     </programlisting>
    </example>
@@ -570,8 +552,6 @@ class PositivePoint extends Point
         }
     }
 }
-
-?>
 ]]>
     </programlisting>
    </example>
@@ -600,8 +580,6 @@ class CaseFoldingStrings extends Strings
         ;
     }
 }
-
-?>
 ]]>
     </programlisting>
    </example>