ext/bcmath: Minor fixes (#4422)

Author: SakiTakamachi

reference/bc/bcmath/number/add.xml

@@ -32,8 +32,8 @@
     <term><parameter>scale</parameter></term>
     <listitem>
      <simpara>
-      <parameter>scale</parameter> explicitly specified for calculation results.
-      If &null;, the <parameter>scale</parameter> of the calculation result will be set automatically.
+      <property>BcMath\Number::scale</property> explicitly specified for calculation results.
+      If &null;, the <property>BcMath\Number::scale</property> of the calculation result will be set automatically.
      </simpara>
     </listitem>
    </varlistentry>

reference/bc/bcmath/number/construct.xml

@@ -24,7 +24,7 @@
     <listitem>
      <simpara>
       An <type>int</type> or <type>string</type> value.
-      If <parameter>num</parameter> is a  <type>int</type>,
+      If <parameter>num</parameter> is a <type>int</type>,
       the <property>BcMath\Number::scale</property> is always set to <literal>0</literal>.
       If <parameter>num</parameter> is a <type>string</type>, it must be a valid number,
       and the <property>BcMath\Number::scale</property> is automatically set by parsing the string.

reference/bc/bcmath/number/div.xml

@@ -49,13 +49,13 @@
    <literal>15</literal>.
   </simpara>
   <simpara>
-    Even in indivisible calculations, the <property>BcMath\Number::scale</property> will not always be
-    <literal>+10</literal>.
-    A <literal>0</literal> at the end of the result is considered not to need expansion, so the
-    <property>BcMath\Number::scale</property> is reduced by that amount.
-    The <property>BcMath\Number::scale</property> will never be less than the
-    <property>BcMath\Number::scale</property> before expansion.
-    See also the <link linkend="bcmath-number.div.example.expansion-scale">code example</link>.
+   Even in indivisible calculations, the <property>BcMath\Number::scale</property> will not always be
+   <literal>+10</literal>.
+   A <literal>0</literal> at the end of the result is considered not to need expansion, so the
+   <property>BcMath\Number::scale</property> is reduced by that amount.
+   The <property>BcMath\Number::scale</property> will never be less than the
+   <property>BcMath\Number::scale</property> before expansion.
+   See also the <link linkend="bcmath-number.div.example.expansion-scale">code example</link>.
   </simpara>
  </refsect1>
 

reference/bc/bcmath/number/round.xml

@@ -43,6 +43,13 @@
   </simpara>
  </refsect1>
 
+ <refsect1 role="errors">
+  &reftitle.errors;
+  <simpara>
+   This method throws a <exceptionname>ValueError</exceptionname> if an invalid <parameter>mode</parameter> is specified.
+  </simpara>
+ </refsect1>
+
  <refsect1 role="examples">
   &reftitle.examples;
    <example>

reference/bc/bcmath/number/sqrt.xml

@@ -30,12 +30,13 @@
   </simpara>
   <simpara>
    When the <property>BcMath\Number::scale</property> of the result object is automatically set,
-   the <property>BcMath\Number::scale</property> of this object is used. However, in cases such
+   the <property>BcMath\Number::scale</property> of <varname>$this</varname> is used. However, in cases such
    as indivisible division, the <property>BcMath\Number::scale</property> of the result is expanded.
    Expansion is done only as needed, up to a maximum of <literal>+10</literal>.
+   This behavior is the same as <methodname>BcMath\Number::div</methodname>, so please see that for details.
   </simpara>
   <simpara>
-   That is, if the <property>BcMath\Number::scale</property> of this object is <literal>5</literal>,
+   That is, if the <property>BcMath\Number::scale</property> of <varname>$this</varname> is <literal>5</literal>,
    the <property>BcMath\Number::scale</property> of the result is between <literal>5</literal> and
    <literal>15</literal>.
   </simpara>
@@ -46,7 +47,7 @@
   <para>
    This method throws a <exceptionname>ValueError</exceptionname> in the following cases:
    <simplelist>
-    <member>This object is a negative value</member>
+    <member><varname>$this</varname> is a negative value</member>
     <member><parameter>scale</parameter> is outside the valid range</member>
     <member><property>BcMath\Number::scale</property> of the result object is outside the valid range</member>
    </simplelist>

reference/bc/functions/bcpow.xml

@@ -84,7 +84,7 @@
      <row>
       <entry>8.4.0</entry>
       <entry>
-       Negative powers of <literal>0</literal> previously returned 0, but now throw a <exceptionname>DivisionByZeroError</exceptionname>
+       Negative powers of <literal>0</literal> previously returned <literal>0</literal>, but now throw a <exceptionname>DivisionByZeroError</exceptionname>
        exception.
       </entry>
      </row>

reference/bc/functions/bcround.xml

@@ -51,7 +51,7 @@
    This function throws a <exceptionname>ValueError</exceptionname> in the following cases:
    <simplelist>
     <member><parameter>num</parameter> is not a well-formed BCMath numeric string.</member>
-    <member><parameter>scale</parameter> is outside the valid range.</member>
+    <member>An invalid <parameter>mode</parameter> is specified.</member>
    </simplelist>
   </para>
  </refsect1>