Apply suggestions from code review

Co-authored-by: Louis-Arnaud <la.catoire@gmail.com>

Author: jb-lopez

language/operators.xml

@@ -29,11 +29,11 @@
   exactly how expressions containing several different operators are
   evaluated.
  </para>
- <para>
+ <simpara>
   There is a PECL extension that allows for overloading of some operators for
   objects. For more information, see the <link linkend="book.operator">Operator
   Overloading for Objects</link> section.
- </para>
+ </simpara>
 
  &language.operators.precedence;
  &language.operators.arithmetic;

reference/operator/book.xml

@@ -8,21 +8,20 @@
  <!-- {{{ preface -->
  <preface xml:id="intro.operator">
   &reftitle.intro;
-  <para>
-   This extension allows you to define and implement operator overloading for objects.
-   It is possible to define how an object reacts when an operator is used on it.
-  </para>
-  <para>
+  <simpara>
+   This extension defines and implements operator overloading for objects.
+   It allows defining how an object reacts when an operator is used on it.
+  </simpara>
+  <simpara>
    One example of this is creating a collection type object that has the addition
    operator overloaded to allow adding elements to the collection or adding two
    collections together.
-  </para>
-  <para>
+  </simpara>
+  <simpara>
    Another example is creating an enhanced string class that has the multiplication
    operator overloaded to allow repeating the string a certain number of times.
-  </para>
+  </simpara>
   <section>
-   &reftitle.seealso;
   </section>
  </preface>
  <!-- }}} -->

reference/operator/overloading.xml

@@ -27,9 +27,9 @@
    <member><literal>$a::__assign_div($b)</literal></member>
    <member><literal>$a::__assign_mod($b)</literal></member>
    <member><literal>$a::__assign_pow($b)</literal></member>
-   <member><literal>$a::__assign_and($b)</literal></member>
-   <member><literal>$a::__assign_or($b)</literal></member>
-   <member><literal>$a::__assign_xor($b)</literal></member>
+   <member><literal>$a::__assign_bw_and($b)</literal></member>
+   <member><literal>$a::__assign_bw_or($b)</literal></member>
+   <member><literal>$a::__assign_bw_xor($b)</literal></member>
    <member><literal>$a::__assign_sl($b)</literal></member>
    <member><literal>$a::__assign_sr($b)</literal></member>
    <member><literal>$a::__assign_concat($b)</literal></member>
@@ -42,8 +42,8 @@
    <member><literal>$a::__bw_or($b)</literal></member>
    <member><literal>$a::__bw_xor($b)</literal></member>
    <member><literal>$a::__bw_not()</literal></member>
-   <member><literal>$a::__bw_sl($b)</literal></member>
-   <member><literal>$a::__bw_sr($b)</literal></member>
+   <member><literal>$a::__sl($b)</literal></member>
+   <member><literal>$a::__sr($b)</literal></member>
   </simplelist>
  </para>
  <para>
@@ -57,6 +57,7 @@
    <member><literal>$a::__is_smaller_or_equal($b)</literal></member>
    <member><literal>$a::__is_greater($b)</literal></member>
    <member><literal>$a::__is_greater_or_equal($b)</literal></member>
+   <member><literal>$a::__spaceship($b)</literal></member>
   </simplelist>
  </para>
  <para>

reference/operator/setup.xml

@@ -9,12 +9,12 @@
    &pecl.info;
    <link xlink:href="&url.pecl.package;operator">&url.pecl.package;operator</link>.
   </para>
-  <para>
+  <simpara>
    Windows users can download prebuilt release binaries from the <link xlink:href="&url.pecl.package;operator">PECL</link> website.
-  </para>
-  <para>
+  </simpara>
+  <simpara>
    operator releases are hosted by PECL and the source code by
    <link xlink:href="&url.git.hub;jb-lopez/pecl-php-operator">github</link>.
-  </para>
+  </simpara>
  </section>
 </chapter>