From 6d35bd35fb1b4f3a37115a62cfa4298fa34b4853 Mon Sep 17 00:00:00 2001
From: leonardolara <leonardo.lara.rodrigues@gmail.com>
Date: Sun, 1 Dec 2024 15:22:47 -0300
Subject: [PATCH] sync with en rev

---
 reference/bc/functions/bcadd.xml    |  24 ++-
 reference/bc/functions/bcceil.xml   | 101 ++++++++++
 reference/bc/functions/bccomp.xml   |  59 ++----
 reference/bc/functions/bcdiv.xml    |  33 ++--
 reference/bc/functions/bcdivmod.xml | 106 ++++++++++
 reference/bc/functions/bcfloor.xml  |  85 ++++++++
 reference/bc/functions/bcmod.xml    |  47 +----
 reference/bc/functions/bcmul.xml    |  52 ++---
 reference/bc/functions/bcpow.xml    |   8 +-
 reference/bc/functions/bcpowmod.xml |  36 +++-
 reference/bc/functions/bcround.xml  | 297 ++++++++++++++++++++++++++++
 reference/bc/functions/bcscale.xml  |  10 +-
 reference/bc/functions/bcsqrt.xml   |   8 +-
 reference/bc/functions/bcsub.xml    |  38 +---
 14 files changed, 718 insertions(+), 186 deletions(-)
 create mode 100644 reference/bc/functions/bcceil.xml
 create mode 100644 reference/bc/functions/bcdivmod.xml
 create mode 100644 reference/bc/functions/bcfloor.xml
 create mode 100644 reference/bc/functions/bcround.xml

diff --git a/reference/bc/functions/bcadd.xml b/reference/bc/functions/bcadd.xml
index 86cf59f23..62fc93243 100644
--- a/reference/bc/functions/bcadd.xml
+++ b/reference/bc/functions/bcadd.xml
@@ -1,9 +1,9 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 23f5599c8cc2713e7a4fdc29d8cceab66c341c48 Maintainer: ae Status: ready --><!-- CREDITS: rarruda,ae -->
+<!-- EN-Revision: ddb05f8827151e25dd1c3e058f95f6c024bc881b Maintainer: leonardolara Status: ready --><!-- CREDITS: rarruda,ae,leonardolara -->
 <refentry xml:id="function.bcadd" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>bcadd</refname>
-  <refpurpose>Adicionar dois números de precisão arbitrária</refpurpose>
+  <refpurpose>Adiciona dois números de precisão arbitrária</refpurpose>
  </refnamediv>
 
  <refsect1 role="description">
@@ -52,6 +52,22 @@
   </para>
  </refsect1>
 
+ <refsect1 role="errors">
+  &reftitle.errors;
+  <para>
+   Esta função lança uma exceção <exceptionname>ValueError</exceptionname> nos seguintes casos:
+   <simplelist>
+    <member>
+     <parameter>num1</parameter> ou <parameter>num2</parameter>
+     não for uma string numérica BCMath bem formada.
+    </member>
+    <member>
+     <parameter>scale</parameter> estiver fora do intervalo válido.
+    </member>
+   </simplelist>
+  </para>
+ </refsect1>
+
  <refsect1 role="changelog">
   &reftitle.changelog;
   <informaltable>
@@ -66,7 +82,7 @@
      <row>
       <entry>8.0.0</entry>
       <entry>
-       <parameter>scale</parameter> pode ser null.
+       <parameter>scale</parameter> agora pode ser nulo.
       </entry>
      </row>
     </tbody>
@@ -77,7 +93,7 @@
  <refsect1 role="examples">
   &reftitle.examples;
   <example>
-   <title>Exemplo <function>bcadd</function></title>
+   <title>Exemplo de <function>bcadd</function></title>
    <programlisting role="php">
 <![CDATA[
 <?php
diff --git a/reference/bc/functions/bcceil.xml b/reference/bc/functions/bcceil.xml
new file mode 100644
index 000000000..35c77331b
--- /dev/null
+++ b/reference/bc/functions/bcceil.xml
@@ -0,0 +1,101 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- EN-Revision: ddb05f8827151e25dd1c3e058f95f6c024bc881b Maintainer: leonardolara Status: ready -->
+<refentry xml:id="function.bcceil" xmlns="http://docbook.org/ns/docbook">
+ <refnamediv>
+  <refname>bcceil</refname>
+  <refpurpose>Arredonda para cima número de precisão arbitrária</refpurpose>
+ </refnamediv>
+
+ <refsect1 role="description">
+  &reftitle.description;
+  <methodsynopsis>
+   <type>string</type><methodname>bcceil</methodname>
+   <methodparam><type>string</type><parameter>num</parameter></methodparam>
+  </methodsynopsis>
+  <simpara>
+   Retorna o próximo valor inteiro mais alto, arredondando
+   <parameter>num</parameter> para cima se necessário.
+  </simpara>
+ </refsect1>
+
+ <refsect1 role="parameters">
+  &reftitle.parameters;
+  <variablelist>
+   <varlistentry>
+    <term><parameter>num</parameter></term>
+    <listitem>
+     <simpara>
+      O valor a ser arredondado.
+     </simpara>
+    </listitem>
+   </varlistentry>
+  </variablelist>
+ </refsect1>
+
+ <refsect1 role="returnvalues">
+  &reftitle.returnvalues;
+  <simpara>
+   Retorna uma string numérica representando <parameter>num</parameter> arredondado para cima em direção ao inteiro mais próximo.
+  </simpara>
+ </refsect1>
+
+ <refsect1 role="errors">
+  &reftitle.errors;
+  <simpara>
+   Esta função lança uma exceção <exceptionname>ValueError</exceptionname> se
+   <parameter>num</parameter> não for uma string numérica BCMath bem formada.
+  </simpara>
+ </refsect1>
+
+ <refsect1 role="examples">
+  &reftitle.examples;
+  <example>
+   <title>Exemplo de <function>bcceil</function></title>
+   <programlisting role="php">
+<![CDATA[
+<?php
+var_dump(bcceil('4.3'));
+var_dump(bcceil('9.999'));
+var_dump(bcceil('-3.14'));
+?>
+]]>
+   </programlisting>
+   &example.outputs;
+   <screen role="php">
+<![CDATA[
+string(1) "5"
+string(2) "10"
+string(2) "-3"
+]]>
+   </screen>
+  </example>
+ </refsect1>
+
+ <refsect1 role="seealso">
+  &reftitle.seealso;
+  <simplelist>
+   <member><function>bcfloor</function></member>
+   <member><function>bcround</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/bc/functions/bccomp.xml b/reference/bc/functions/bccomp.xml
index 02c30661a..dd862fdab 100644
--- a/reference/bc/functions/bccomp.xml
+++ b/reference/bc/functions/bccomp.xml
@@ -1,9 +1,9 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 23f5599c8cc2713e7a4fdc29d8cceab66c341c48 Maintainer: ae Status: ready --><!-- CREDITS: rarruda,ae -->
-<refentry xml:id="function.bccomp" xmlns="http://docbook.org/ns/docbook">
+<!-- EN-Revision: ddb05f8827151e25dd1c3e058f95f6c024bc881b Maintainer: leonardolara Status: ready --><!-- CREDITS: rarruda,ae -->
+<refentry xml:id="function.bccomp" xmlns="http://docbook.org/ns/docbook" xmlns:xi="http://www.w3.org/2001/XInclude">
  <refnamediv>
   <refname>bccomp</refname>
-  <refpurpose>Comparar dois números de precisão arbitrária</refpurpose>
+  <refpurpose>Compara dois números de precisão arbitrária</refpurpose>
  </refnamediv>
 
  <refsect1 role="description">
@@ -15,55 +15,26 @@
    <methodparam choice="opt"><type class="union"><type>int</type><type>null</type></type><parameter>scale</parameter><initializer>&null;</initializer></methodparam>
   </methodsynopsis>
   <para>
-   Compara o <parameter>num1</parameter> com o
-   <parameter>num2</parameter> e retorna o resultado
-   como um inteiro.
+   Compara <parameter>num1</parameter> com <parameter>num2</parameter>
+   e retorna o resultado da comparação como um inteiro.
   </para>
  </refsect1>
 
  <refsect1 role="parameters">
-  &reftitle.parameters;
-  <para>
-   <variablelist>
-    <varlistentry>
-     <term><parameter>num1</parameter></term>
-     <listitem>
-      <para>
-       O operando da esquerda, como uma string.
-      </para>
-     </listitem>
-    </varlistentry>
-    <varlistentry>
-     <term><parameter>num2</parameter></term>
-     <listitem>
-      <para>
-       O operando da direita, como uma string.
-      </para>
-     </listitem>
-    </varlistentry>
-    <varlistentry>
-     <term><parameter>scale</parameter></term>
-     <listitem>
-      <para>
-       O parâmetro opcional <parameter>scale</parameter> é usado para definir o
-       número de dígitos depois da parte decimal que será usada na
-       comparação.
-      </para>
-     </listitem>
-    </varlistentry>
-   </variablelist>
-  </para>
+  <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('function.bcadd')/db:refsect1[@role='parameters']/*)" />
  </refsect1>
 
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
-  <para>
-   Retorna 0 se os dois operandos são iguais, 1 se o
-   <parameter>num1</parameter> é maior que
-   <parameter>num2</parameter>, -1 caso contrário.
-  </para>
+  <simpara>
+   Retorna <literal>0</literal> se ambos os operandos forem iguais,
+   <literal>1</literal> se <parameter>num1</parameter> for maior que
+   <parameter>num2</parameter>, <literal>-1</literal> para o restante.
+  </simpara>
  </refsect1>
 
+ <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('function.bcadd')/db:refsect1[@role='errors'])" />
+
  <refsect1 role="changelog">
   &reftitle.changelog;
   <informaltable>
@@ -78,7 +49,7 @@
      <row>
       <entry>8.0.0</entry>
       <entry>
-       <parameter>scale</parameter> pode ser null.
+       <parameter>scale</parameter> pode ser nulo.
       </entry>
      </row>
     </tbody>
@@ -89,7 +60,7 @@
  <refsect1 role="examples">
   &reftitle.examples;
   <example>
-   <title>Exemplo da <function>bccomp</function></title>
+   <title>Exemplo de <function>bccomp</function></title>
    <programlisting role="php">
 <![CDATA[
 <?php
diff --git a/reference/bc/functions/bcdiv.xml b/reference/bc/functions/bcdiv.xml
index 4cf60e29d..c1acb8bae 100644
--- a/reference/bc/functions/bcdiv.xml
+++ b/reference/bc/functions/bcdiv.xml
@@ -1,9 +1,9 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 87f32875a189be7ee2a8487c0db3958579e4ce72 Maintainer: ae Status: ready --><!-- CREDITS: rarruda,ae,leonardolara -->
-<refentry xml:id="function.bcdiv" xmlns="http://docbook.org/ns/docbook">
+<!-- EN-Revision: ddb05f8827151e25dd1c3e058f95f6c024bc881b Maintainer: leonardolara Status: ready --><!-- CREDITS: rarruda,ae,leonardolara -->
+<refentry xml:id="function.bcdiv" xmlns="http://docbook.org/ns/docbook" xmlns:xi="http://www.w3.org/2001/XInclude">
  <refnamediv>
   <refname>bcdiv</refname>
-  <refpurpose>Dividir dois números de precisão arbitrária</refpurpose>
+  <refpurpose>Divide dois números de precisão arbitrária</refpurpose>
  </refnamediv>
 
  <refsect1 role="description">
@@ -14,10 +14,9 @@
    <methodparam><type>string</type><parameter>num2</parameter></methodparam>
    <methodparam choice="opt"><type class="union"><type>int</type><type>null</type></type><parameter>scale</parameter><initializer>&null;</initializer></methodparam>
   </methodsynopsis>
-  <para>
-   Divide o <parameter>num1</parameter> pelo
-   <parameter>num2</parameter>.
-  </para>
+  <simpara>
+   Divide <parameter>num1</parameter> por <parameter>num2</parameter>.
+  </simpara>
  </refsect1>
 
  <refsect1 role="parameters">
@@ -53,17 +52,11 @@
  </refsect1>
 
  <refsect1 role="errors">
-  &reftitle.errors;
-  <para>
-   Esta função lança uma exceção <exceptionname>ValueError</exceptionname> nos seguintes casos:
-   <simplelist>
-    <member><parameter>num1</parameter> ou <parameter>num2</parameter> não são string numéricas BCMath bem formadas</member>
-    <member><parameter>scale</parameter> está fora do intervalo válido</member>
-   </simplelist>
-  </para>
+  <!-- Include standard ValueErrors for num1, num2, and scale, this includes the title -->
+  <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('function.bcadd')/db:refsect1[@role='errors']/*)" />
   <simpara>
-   Esta função lança uma exceção <exceptionname>DivisionByZeroError</exceptionname> se <parameter>num2</parameter>
-   for igual a <literal>0</literal>.
+   Esta função lança uma exceção <exceptionname>DivisionByZeroError</exceptionname>
+   se <parameter>num2</parameter> for igual a <literal>0</literal>.
   </simpara>
  </refsect1>
 
@@ -81,13 +74,15 @@
      <row>
       <entry>8.0.0</entry>
       <entry>
-       <parameter>scale</parameter> pode ser null.
+       <parameter>scale</parameter> pode ser nulo.
       </entry>
      </row>
      <row>
       <entry>8.0.0</entry>
       <entry>
-       Dividir por 0 agora lança uma exceção <exceptionname>DivisionByZeroError</exceptionname> ao invés de retornar null.
+       Dividir por <literal>0</literal> agora lança uma
+       exceção <exceptionname>DivisionByZeroError</exceptionname>
+       ao invés de retornar &null;.
       </entry>
      </row>
     </tbody>
diff --git a/reference/bc/functions/bcdivmod.xml b/reference/bc/functions/bcdivmod.xml
new file mode 100644
index 000000000..6cbad84fc
--- /dev/null
+++ b/reference/bc/functions/bcdivmod.xml
@@ -0,0 +1,106 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- EN-Revision: ddb05f8827151e25dd1c3e058f95f6c024bc881b Maintainer: leonardolara Status: ready -->
+<refentry xml:id="function.bcdivmod" xmlns="http://docbook.org/ns/docbook" xmlns:xi="http://www.w3.org/2001/XInclude">
+ <refnamediv>
+  <refname>bcdivmod</refname>
+  <refpurpose>Obtém o quociente e o módulo de um número de precisão arbitrário</refpurpose>
+ </refnamediv>
+
+ <refsect1 role="description">
+  &reftitle.description;
+  <methodsynopsis>
+   <type>string</type><methodname>bcdivmod</methodname>
+   <methodparam><type>string</type><parameter>num1</parameter></methodparam>
+   <methodparam><type>string</type><parameter>num2</parameter></methodparam>
+   <methodparam choice="opt"><type class="union"><type>int</type><type>null</type></type><parameter>scale</parameter><initializer>&null;</initializer></methodparam>
+  </methodsynopsis>
+  <simpara>
+   Obtém o quociente e o resto da divisão de <parameter>num1</parameter> por
+   <parameter>num2</parameter>.
+  </simpara>
+ </refsect1>
+
+ <refsect1 role="parameters">
+  <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('function.bcdiv')/db:refsect1[@role='parameters']/*)" />
+ </refsect1>
+
+ <refsect1 role="returnvalues">
+  &reftitle.returnvalues;
+  <simpara>
+   Retorna um <type>array</type> indexado onde o primeiro elemento é o quociente como uma <type>string</type>
+   e o segundo elemento é o restante como uma <type>string</type>.
+  </simpara>
+ </refsect1>
+
+ <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('function.bcdiv')/db:refsect1[@role='errors'])" />
+
+ <refsect1 role="examples">
+  &reftitle.examples;
+  <example>
+   <title>Exemplo de <function>bcdivmod</function></title>
+   <programlisting role="php">
+<![CDATA[
+<?php
+bcscale(0);
+
+[$quot, $rem] = bcdivmod('5',  '3');
+echo $quot; // 1
+echo $rem;  // 2
+
+[$quot, $rem] = bcdivmod('5',  '-3');
+echo $quot; // -1
+echo $rem;  // 2
+
+[$quot, $rem] = bcdivmod('-5',  '3');
+echo $quot; // -1
+echo $rem;  // -2
+
+[$quot, $rem] = bcdivmod('-5',  '-3');
+echo $quot; // 1
+echo $rem;  // -2
+?>
+]]>
+   </programlisting>
+  </example>
+  <example>
+   <title><function>bcdivmod</function> com decimais</title>
+   <programlisting role="php">
+<![CDATA[
+<?php
+[$quot, $rem] = bcdivmod('5.7', '1.3', 1);
+echo $quot; // 4
+echo $rem;  // 0.5
+?>
+]]>
+   </programlisting>
+  </example>
+ </refsect1>
+
+ <refsect1 role="seealso">
+  &reftitle.seealso;
+  <simplelist>
+   <member><function>bcdiv</function></member>
+   <member><function>bcmod</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/bc/functions/bcfloor.xml b/reference/bc/functions/bcfloor.xml
new file mode 100644
index 000000000..2987e9c30
--- /dev/null
+++ b/reference/bc/functions/bcfloor.xml
@@ -0,0 +1,85 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- EN-Revision: ddb05f8827151e25dd1c3e058f95f6c024bc881b Maintainer: leonardolara Status: ready -->
+<refentry xml:id="function.bcfloor" xmlns="http://docbook.org/ns/docbook" xmlns:xi="http://www.w3.org/2001/XInclude">
+ <refnamediv>
+  <refname>bcfloor</refname>
+  <refpurpose>Arredonda para baixo um número de precisão arbitrária</refpurpose>
+ </refnamediv>
+
+ <refsect1 role="description">
+  &reftitle.description;
+  <methodsynopsis>
+   <type>string</type><methodname>bcfloor</methodname>
+   <methodparam><type>string</type><parameter>num</parameter></methodparam>
+  </methodsynopsis>
+  <simpara>
+   Retorna o próximo valor inteiro mais baixo arredondando <parameter>num</parameter>
+   para baixo, se necessário.
+  </simpara>
+ </refsect1>
+
+ <refsect1 role="parameters">
+  <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('function.bcceil')/db:refsect1[@role='parameters']/*)" />
+ </refsect1>
+
+ <refsect1 role="returnvalues">
+  &reftitle.returnvalues;
+  <simpara>
+   Retorna uma string numérica representando <parameter>num</parameter> arredondado para o número inteiro mais próximo.
+  </simpara>
+ </refsect1>
+
+ <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('function.bcceil')/db:refsect1[@role='errors'])" />
+
+ <refsect1 role="examples">
+  &reftitle.examples;
+  <example>
+   <title>Exemplo de <function>bcfloor</function></title>
+   <programlisting role="php">
+<![CDATA[
+<?php
+var_dump(bcfloor('4.3'));
+var_dump(bcfloor('9.999'));
+var_dump(bcfloor('-3.14'));
+?>
+]]>
+   </programlisting>
+   &example.outputs;
+   <screen role="php">
+<![CDATA[
+string(1) "4"
+string(1) "9"
+string(2) "-4"
+]]>
+   </screen>
+  </example>
+ </refsect1>
+
+ <refsect1 role="seealso">
+  &reftitle.seealso;
+  <simplelist>
+   <member><function>bcceil</function></member>
+   <member><function>bcround</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/bc/functions/bcmod.xml b/reference/bc/functions/bcmod.xml
index 85077bb47..041191d79 100644
--- a/reference/bc/functions/bcmod.xml
+++ b/reference/bc/functions/bcmod.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 87f32875a189be7ee2a8487c0db3958579e4ce72 Maintainer: ae Status: ready --><!-- CREDITS: rarruda, leonardolara -->
-<refentry xml:id="function.bcmod" xmlns="http://docbook.org/ns/docbook">
+<!-- EN-Revision: ddb05f8827151e25dd1c3e058f95f6c024bc881b Maintainer: leonardolara Status: ready --><!-- CREDITS: rarruda, leonardolara -->
+<refentry xml:id="function.bcmod" xmlns="http://docbook.org/ns/docbook" xmlns:xi="http://www.w3.org/2001/XInclude">
  <refnamediv>
   <refname>bcmod</refname>
   <refpurpose>Obtém o resto de uma divisão com precisão arbitrária</refpurpose>
@@ -17,34 +17,12 @@
   <para>
    Obtém o resto da divisão de <parameter>num1</parameter> por
    <parameter>num2</parameter>.
-   A não ser que <parameter>num2</parameter> seja zero, o resultado tem o mesmo sinal
-   que <parameter>num1</parameter>.
+   O resultado tem o mesmo sinal de <parameter>num1</parameter>.
   </para>
  </refsect1>
 
  <refsect1 role="parameters">
-  &reftitle.parameters;
-  <para>
-   <variablelist>
-    <varlistentry>
-     <term><parameter>num1</parameter></term>
-     <listitem>
-      <para>
-       O número dividendo, como string.
-      </para>
-     </listitem>
-    </varlistentry>
-    <varlistentry>
-     <term><parameter>num2</parameter></term>
-     <listitem>
-      <para>
-       O número divisor, como string.
-      </para>
-     </listitem>
-    </varlistentry>
-    &bc.scale.description;
-   </variablelist>
-  </para>
+  <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('function.bcadd')/db:refsect1[@role='parameters']/*)" />
  </refsect1>
 
  <refsect1 role="returnvalues">
@@ -54,20 +32,7 @@
   </para>
  </refsect1>
 
- <refsect1 role="errors">
-  &reftitle.errors;
-  <para>
-   Esta função lança uma exceção <exceptionname>ValueError</exceptionname> nos seguintes casos:
-   <simplelist>
-    <member><parameter>num1</parameter> ou <parameter>num2</parameter> não são string numéricas BCMath bem formadas</member>
-    <member><parameter>scale</parameter> está fora do intervalo válido</member>
-   </simplelist>
-  </para>
-  <simpara>
-   Esta função lança uma exceção <exceptionname>DivisionByZeroError</exceptionname> se <parameter>num2</parameter>
-   for igual a <literal>0</literal>.
-  </simpara>
- </refsect1>
+ <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('function.bcdiv')/db:refsect1[@role='errors'])" />
 
  <refsect1 role="changelog"><!-- {{{ -->
   &reftitle.changelog;
@@ -89,7 +54,7 @@
      <row>
       <entry>8.0.0</entry>
       <entry>
-       Dividir por 0 agora lança uma exceção <exceptionname>DivisionByZeroError</exceptionname> ao invés de retornar null.
+       Dividir por <literal>0</literal> agora lança uma exceção <exceptionname>DivisionByZeroError</exceptionname> ao invés de retornar null.
       </entry>
      </row>
      <row>
diff --git a/reference/bc/functions/bcmul.xml b/reference/bc/functions/bcmul.xml
index cf8d9a217..f27c3da11 100644
--- a/reference/bc/functions/bcmul.xml
+++ b/reference/bc/functions/bcmul.xml
@@ -1,9 +1,9 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 23f5599c8cc2713e7a4fdc29d8cceab66c341c48 Maintainer: ae Status: ready --><!-- CREDITS: rarruda,ae -->
-<refentry xml:id="function.bcmul" xmlns="http://docbook.org/ns/docbook">
+<!-- EN-Revision: ddb05f8827151e25dd1c3e058f95f6c024bc881b Maintainer: leonardolara Status: ready --><!-- CREDITS: rarruda,ae -->
+<refentry xml:id="function.bcmul" xmlns="http://docbook.org/ns/docbook" xmlns:xi="http://www.w3.org/2001/XInclude">
  <refnamediv>
   <refname>bcmul</refname>
-  <refpurpose>Multiplicar dois números de precisão arbitrária</refpurpose>
+  <refpurpose>Multiplica dois números de precisão arbitrária</refpurpose>
  </refnamediv>
 
  <refsect1 role="description">
@@ -14,35 +14,13 @@
    <methodparam><type>string</type><parameter>num2</parameter></methodparam>
    <methodparam choice="opt"><type class="union"><type>int</type><type>null</type></type><parameter>scale</parameter><initializer>&null;</initializer></methodparam>
   </methodsynopsis>
-  <para>
-   Multiplica o <parameter>num1</parameter> pelo
-   <parameter>num2</parameter>.
-  </para>
+  <simpara>
+   Multiplica <parameter>num1</parameter> por <parameter>num2</parameter>.
+  </simpara>
  </refsect1>
 
  <refsect1 role="parameters">
-  &reftitle.parameters;
-  <para>
-   <variablelist>
-    <varlistentry>
-     <term><parameter>num1</parameter></term>
-     <listitem>
-      <para>
-       O operando da esquerda, como uma string.
-      </para>
-     </listitem>
-    </varlistentry>
-    <varlistentry>
-     <term><parameter>num2</parameter></term>
-     <listitem>
-      <para>
-       O operando da direita, como uma string.
-      </para>
-     </listitem>
-    </varlistentry>
-    &bc.scale.description;
-   </variablelist>
-  </para>
+  <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('function.bcadd')/db:refsect1[@role='parameters']/*)" />
  </refsect1>
 
  <refsect1 role="returnvalues">
@@ -52,6 +30,8 @@
   </para>
  </refsect1>
 
+ <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('function.bcadd')/db:refsect1[@role='errors'])" />
+
  <refsect1 role="changelog"><!-- {{{ -->
   &reftitle.changelog;
   <informaltable>
@@ -66,7 +46,7 @@
      <row>
       <entry>8.0.0</entry>
       <entry>
-       <parameter>scale</parameter> agora pode ser null.
+       <parameter>scale</parameter> agora pode ser nulo.
       </entry>
      </row>
      <row>
@@ -84,7 +64,7 @@
  <refsect1 role="examples">
   &reftitle.examples;
   <example>
-   <title>Exemplo da <function>bcmul</function></title>
+   <title>Exemplo de <function>bcmul</function></title>
    <programlisting role="php">
 <![CDATA[
 <?php
@@ -100,16 +80,16 @@ echo bcmul('2', '4'); // 8
   &reftitle.notes;
   <note>
    <para>
-    Anteriormente ao PHP 7.3.0 <function>bcmul</function> podia retornar um número com menos dígitos após
-    o ponto decimal que o parâmetro <parameter>scale</parameter>
-    indicaria. Isto ocorre apenas quando o resultado não exigia toda a
+    Anteriormente ao PHP 7.3.0, <function>bcmul</function> poderia retornar um número com menos dígitos após o
+    ponto decimal em comparação ao que o parâmetro <parameter>scale</parameter>
+    indicaria. Isto ocorre apenas quando o resultado não exige toda a
     precisão permitida pelo parâmetro <parameter>scale</parameter>. Por exemplo:
     <example>
-     <title>Exemplo de <function>bcmul</function> com scale</title>
+     <title>Exemplo de <function>bcmul</function> com escala</title>
      <programlisting role="php">
 <![CDATA[
 <?php
-echo bcmul('5', '2', 2);     // Imprime "10", não "10.00"
+echo bcmul('5', '2', 2);     // Exibe "10", não "10.00"
 ?>
 ]]>
      </programlisting>
diff --git a/reference/bc/functions/bcpow.xml b/reference/bc/functions/bcpow.xml
index 6fe452d5f..88ada121a 100644
--- a/reference/bc/functions/bcpow.xml
+++ b/reference/bc/functions/bcpow.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: e333514f66ae32a3468e05dbe64f55f01ff9451e Maintainer: ae Status: ready --><!-- CREDITS: rarruda,ae,leonardolara -->
+<!-- EN-Revision: ddb05f8827151e25dd1c3e058f95f6c024bc881b Maintainer: leonardolara Status: ready --><!-- CREDITS: rarruda,ae,leonardolara -->
 <refentry xml:id="function.bcpow" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>bcpow</refname>
@@ -59,9 +59,9 @@
   <para>
    Esta função lança uma exceção <exceptionname>ValueError</exceptionname> nos seguintes casos:
    <simplelist>
-    <member><parameter>num</parameter> ou <parameter>exponent</parameter> não são string numéricas BCMath bem formadas</member>
-    <member><parameter>scale</parameter> está fora do intervalo válido</member>
+    <member><parameter>num</parameter> ou <parameter>exponent</parameter> não são strings numéricas BCMath bem formadas</member>
     <member><parameter>exponent</parameter> tem uma parte fracionária</member>
+    <member><parameter>exponent</parameter> ou <parameter>scale</parameter> está fora do intervalo válido</member>
    </simplelist>
   </para>
   <simpara>
@@ -84,7 +84,7 @@
      <row>
       <entry>8.4.0</entry>
       <entry>
-       Potências negativas de 0 anteriormente retornavam 0, mas agora lançam uma exceção
+       Potências negativas de <literal>0</literal> anteriormente retornavam 0, mas agora lançam uma exceção
        <exceptionname>DivisionByZeroError</exceptionname>.
       </entry>
      </row>
diff --git a/reference/bc/functions/bcpowmod.xml b/reference/bc/functions/bcpowmod.xml
index cb9476ac7..2c52dd918 100644
--- a/reference/bc/functions/bcpowmod.xml
+++ b/reference/bc/functions/bcpowmod.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: cbac1ecf71d754707d69bdc344c4031c157eaa54 Maintainer: ae Status: ready --><!-- CREDITS: narigone,ae -->
+<!-- EN-Revision: ddb05f8827151e25dd1c3e058f95f6c024bc881b Maintainer: leonardolara Status: ready --><!-- CREDITS: narigone,ae -->
 <refentry xml:id="function.bcpowmod" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>bcpowmod</refname>
@@ -59,11 +59,27 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   Retorna o resultado como uma string, ou &false; se <parameter>modulus</parameter>
-   for <literal>0</literal> ou o <parameter>exponent</parameter> for negativo.
+   Retorna o resultado como uma string.
   </para>
  </refsect1>
 
+ <refsect1 role="errors">
+  &reftitle.errors;
+  <para>
+   Esta função lança uma exceção <exceptionname>ValueError</exceptionname> nos seguintes casos:
+   <simplelist>
+    <member><parameter>num</parameter>, <parameter>exponent</parameter> ou <parameter>modulus</parameter> não é uma string numérica BCMath bem formada</member>
+    <member><parameter>num</parameter>, <parameter>exponent</parameter> ou <parameter>modulus</parameter> tem uma parte fracionária</member>
+    <member><parameter>exponent</parameter> é um valor negativo</member>
+    <member><parameter>scale</parameter> está fora do intervalo válido</member>
+   </simplelist>
+  </para>
+  <simpara>
+   Esta função lança uma exceção <exceptionname>DivisionByZeroError</exceptionname> se <parameter>modulus</parameter>
+   for igual a <literal>0</literal>.
+  </simpara>
+ </refsect1>
+
  <refsect1 role="changelog">
   &reftitle.changelog;
   <informaltable>
@@ -78,7 +94,19 @@
      <row>
       <entry>8.0.0</entry>
       <entry>
-       <parameter>scale</parameter> agora pode ser null.
+       <parameter>scale</parameter> agora pode ser nulo.
+      </entry>
+     </row>
+     <row>
+      <entry>8.0.0</entry>
+      <entry>
+       Agora lança uma exceção <exceptionname>ValueError</exceptionname> ao invés de retornar &false; se <parameter>exponent</parameter> for negativo.
+      </entry>
+     </row>
+     <row>
+      <entry>8.0.0</entry>
+      <entry>
+       Dividir por <literal>0</literal> agora lança uma exceção <exceptionname>DivisionByZeroError</exceptionname> ao invés de retornar &false;.
       </entry>
      </row>
     </tbody>
diff --git a/reference/bc/functions/bcround.xml b/reference/bc/functions/bcround.xml
new file mode 100644
index 000000000..7f439e258
--- /dev/null
+++ b/reference/bc/functions/bcround.xml
@@ -0,0 +1,297 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- EN-Revision: ddb05f8827151e25dd1c3e058f95f6c024bc881b Maintainer: leonardolara Status: ready -->
+<refentry xml:id="function.bcround" xmlns="http://docbook.org/ns/docbook" xmlns:xi="http://www.w3.org/2001/XInclude">
+ <refnamediv>
+  <refname>bcround</refname>
+  <refpurpose>Arredonda número de precisão arbitrária</refpurpose>
+ </refnamediv>
+
+ <refsect1 role="description">
+  &reftitle.description;
+  <methodsynopsis>
+   <type>string</type><methodname>bcround</methodname>
+   <methodparam><type>string</type><parameter>num</parameter></methodparam>
+   <methodparam choice="opt"><type>int</type><parameter>precision</parameter><initializer>0</initializer></methodparam>
+   <methodparam choice="opt"><type>RoundingMode</type><parameter>mode</parameter><initializer>RoundingMode::HalfAwayFromZero</initializer></methodparam>
+  </methodsynopsis>
+  <simpara>
+   Retorna o valor arredondado de <parameter>num</parameter> para a
+   precisão informada em <parameter>precision</parameter>
+   (número de dígitos após o separador decimal).
+   <parameter>precision</parameter> também pode ser negativo ou zero (padrão).
+  </simpara>
+ </refsect1>
+
+ <refsect1 role="parameters">
+  &reftitle.parameters;
+  <variablelist>
+   <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('function.round')/db:refsect1[@role='parameters']/descendant::db:varlistentry[1])" />
+   <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('function.round')/db:refsect1[@role='parameters']/descendant::db:varlistentry[2])" />
+   <varlistentry>
+    <term><parameter>mode</parameter></term>
+    <listitem>
+     <simpara>
+      Especifica o modo de arredondamento.
+     </simpara>
+    </listitem>
+   </varlistentry>
+  </variablelist>
+ </refsect1>
+
+ <refsect1 role="returnvalues">
+  &reftitle.returnvalues;
+  <simpara>
+   Retorna uma string numérica representando <parameter>num</parameter> arredondado para a precisão especificada.
+  </simpara>
+ </refsect1>
+
+ <refsect1 role="errors">
+  &reftitle.errors;
+  <para>
+   Esta função lança uma exceção <exceptionname>ValueError</exceptionname> nos seguintes casos:
+   <simplelist>
+    <member><parameter>num</parameter> não é uma string numérica BCMath bem formada.</member>
+    <member><parameter>scale</parameter> está fora do intervalo válido.</member>
+   </simplelist>
+  </para>
+ </refsect1>
+
+ <refsect1 role="examples">
+  &reftitle.examples;
+   <example>
+   <title>Exemplos de <function>bcround</function></title>
+   <programlisting role="php">
+<![CDATA[
+<?php
+var_dump(bcround('3.4'));
+var_dump(bcround('3.5'));
+var_dump(bcround('3.6'));
+var_dump(bcround('3.6', 0));
+var_dump(bcround('5.045', 2));
+var_dump(bcround('5.055', 2));
+var_dump(bcround('345', -2));
+var_dump(bcround('345', -3));
+var_dump(bcround('678', -2));
+var_dump(bcround('678', -3));
+?>
+]]>
+   </programlisting>
+   &example.outputs;
+   <screen role="php">
+<![CDATA[
+string(1) "3"
+string(1) "4"
+string(1) "4"
+string(1) "4"
+string(4) "5.05"
+string(4) "5.06"
+string(3) "300"
+string(1) "0"
+string(3) "700"
+string(4) "1000"
+]]>
+   </screen>
+  </example>
+  <example>
+   <title>
+    Exemplo de uso de <function>bcround</function> com diferentes valores de <parameter>precision</parameter>
+   </title>
+   <programlisting role="php">
+<![CDATA[
+<?php
+$number = '123.45';
+
+var_dump(bcround($number, 3));
+var_dump(bcround($number, 2));
+var_dump(bcround($number, 1));
+var_dump(bcround($number, 0));
+var_dump(bcround($number, -1));
+var_dump(bcround($number, -2));
+var_dump(bcround($number, -3));
+?>
+]]>
+   </programlisting>
+   &example.outputs;
+   <screen role="php">
+<![CDATA[
+string(7) "123.450"
+string(6) "123.45"
+string(5) "123.5"
+string(3) "123"
+string(3) "120"
+string(3) "100"
+string(1) "0"
+]]>
+   </screen>
+  </example>
+  <example>
+   <title>
+    Exemplo de uso de <function>bcround</function> com diferentes valores de <parameter>mode</parameter>
+   </title>
+   <programlisting role="php">
+<![CDATA[
+<?php
+echo 'Modos de arredondamento com 9.5' . PHP_EOL;
+var_dump(bcround('9.5', 0, RoundingMode::HalfAwayFromZero));
+var_dump(bcround('9.5', 0, RoundingMode::HalfTowardsZero));
+var_dump(bcround('9.5', 0, RoundingMode::HalfEven));
+var_dump(bcround('9.5', 0, RoundingMode::HalfOdd));
+var_dump(bcround('9.5', 0, RoundingMode::TowardsZero));
+var_dump(bcround('9.5', 0, RoundingMode::AwayFromZero));
+var_dump(bcround('9.5', 0, RoundingMode::NegativeInfinity));
+var_dump(bcround('9.5', 0, RoundingMode::PositiveInfinity));
+
+echo PHP_EOL;
+echo 'Modos de arredondamento com 8.5' . PHP_EOL;
+var_dump(bcround('8.5', 0, RoundingMode::HalfAwayFromZero));
+var_dump(bcround('8.5', 0, RoundingMode::HalfTowardsZero));
+var_dump(bcround('8.5', 0, RoundingMode::HalfEven));
+var_dump(bcround('8.5', 0, RoundingMode::HalfOdd));
+var_dump(bcround('8.5', 0, RoundingMode::TowardsZero));
+var_dump(bcround('8.5', 0, RoundingMode::AwayFromZero));
+var_dump(bcround('8.5', 0, RoundingMode::NegativeInfinity));
+var_dump(bcround('8.5', 0, RoundingMode::PositiveInfinity));
+?>
+]]>
+   </programlisting>
+   &example.outputs;
+   <screen role="php">
+<![CDATA[
+Modos de arredondamento com 9.5
+string(2) "10"
+string(1) "9"
+string(2) "10"
+string(1) "9"
+string(1) "9"
+string(2) "10"
+string(1) "9"
+string(2) "10"
+
+Modos de arredondamento com 8.5
+string(1) "9"
+string(1) "8"
+string(1) "8"
+string(1) "9"
+string(1) "8"
+string(1) "9"
+string(1) "8"
+string(1) "9"
+]]>
+   </screen>
+  </example>
+  <example>
+   <title>
+    Exemplo de uso de <function>bcround</function> com diferentes valores de <parameter>mode</parameter>
+    ao especificar <parameter>precision</parameter>
+   </title>
+   <programlisting role="php">
+<![CDATA[
+<?php
+echo 'Usando RoundingMode::HalfAwayFromZero com precisão de 1 dígito decimal' . PHP_EOL;
+var_dump(bcround( 1.55, 1, RoundingMode::HalfAwayFromZero));
+var_dump(bcround(-1.55, 1, RoundingMode::HalfAwayFromZero));
+
+echo PHP_EOL;
+echo 'Usando RoundingMode::HalfTowardsZero com precisão de 1 dígito decimal' . PHP_EOL;
+var_dump(bcround( 1.55, 1, RoundingMode::HalfTowardsZero));
+var_dump(bcround(-1.55, 1, RoundingMode::HalfTowardsZero));
+
+echo PHP_EOL;
+echo 'Usando RoundingMode::HalfEven com precisão de 1 dígito decimal' . PHP_EOL;
+var_dump(bcround( 1.55, 1, RoundingMode::HalfEven));
+var_dump(bcround(-1.55, 1, RoundingMode::HalfEven));
+
+echo PHP_EOL;
+echo 'Usando RoundingMode::HalfOdd com precisão de 1 dígito decimal' . PHP_EOL;
+var_dump(bcround( 1.55, 1, RoundingMode::HalfOdd));
+var_dump(bcround(-1.55, 1, RoundingMode::HalfOdd));
+
+echo PHP_EOL;
+echo 'Usando RoundingMode::TowardsZero com precisão de 1 dígito decimal' . PHP_EOL;
+var_dump(bcround( 1.55, 1, RoundingMode::TowardsZero));
+var_dump(bcround(-1.55, 1, RoundingMode::TowardsZero));
+
+echo PHP_EOL;
+echo 'Usando RoundingMode::AwayFromZero com precisão de 1 dígito decimal' . PHP_EOL;
+var_dump(bcround( 1.55, 1, RoundingMode::AwayFromZero));
+var_dump(bcround(-1.55, 1, RoundingMode::AwayFromZero));
+
+echo PHP_EOL;
+echo 'Usando RoundingMode::NegativeInfinity com precisão de 1 dígito decimal' . PHP_EOL;
+var_dump(bcround( 1.55, 1, RoundingMode::NegativeInfinity));
+var_dump(bcround(-1.55, 1, RoundingMode::NegativeInfinity));
+
+echo PHP_EOL;
+echo 'Usando RoundingMode::PositiveInfinity com precisão de 1 dígito decimal' . PHP_EOL;
+var_dump(bcround( 1.55, 1, RoundingMode::PositiveInfinity));
+var_dump(bcround(-1.55, 1, RoundingMode::PositiveInfinity));
+?>
+]]>
+   </programlisting>
+   &example.outputs;
+   <screen role="php">
+<![CDATA[
+Usando RoundingMode::HalfAwayFromZero com precisão de 1 dígito decimal
+string(3) "1.6"
+string(4) "-1.6"
+
+Usando RoundingMode::HalfTowardsZero com precisão de 1 dígito decimal
+string(3) "1.5"
+string(4) "-1.5"
+
+Usando RoundingMode::HalfEven com precisão de 1 dígito decimal
+string(3) "1.6"
+string(4) "-1.6"
+
+Usando RoundingMode::HalfOdd com precisão de 1 dígito decimal
+string(3) "1.5"
+string(4) "-1.5"
+
+Usando RoundingMode::TowardsZero com precisão de 1 dígito decimal
+string(3) "1.5"
+string(4) "-1.5"
+
+Usando RoundingMode::AwayFromZero com precisão de 1 dígito decimal
+string(3) "1.6"
+string(4) "-1.6"
+
+Usando RoundingMode::NegativeInfinity com precisão de 1 dígito decimal
+string(3) "1.5"
+string(4) "-1.6"
+
+Usando RoundingMode::PositiveInfinity com precisão de 1 dígito decimal
+string(3) "1.6"
+string(4) "-1.5"
+]]>
+   </screen>
+  </example>
+ </refsect1>
+
+ <refsect1 role="seealso">
+  &reftitle.seealso;
+  <simplelist>
+   <member><function>bcceil</function></member>
+   <member><function>bcfloor</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/bc/functions/bcscale.xml b/reference/bc/functions/bcscale.xml
index 3984d8a88..2e3672b97 100644
--- a/reference/bc/functions/bcscale.xml
+++ b/reference/bc/functions/bcscale.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 23f5599c8cc2713e7a4fdc29d8cceab66c341c48 Maintainer: ae Status: ready --><!-- CREDITS: rarruda,ae -->
+<!-- EN-Revision: ddb05f8827151e25dd1c3e058f95f6c024bc881b Maintainer: leonardolara Status: ready --><!-- CREDITS: rarruda,ae -->
 <refentry xml:id="function.bcscale" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>bcscale</refname>
@@ -48,6 +48,14 @@
   </para>
  </refsect1>
 
+ <refsect1 role="errors">
+  &reftitle.errors;
+  <simpara>
+   Esta função lança uma exceção <exceptionname>ValueError</exceptionname> se <parameter>scale</parameter>
+   estiver fora do intervalo válido.
+  </simpara>
+ </refsect1>
+
  <refsect1 role="changelog">
   &reftitle.changelog;
   <informaltable>
diff --git a/reference/bc/functions/bcsqrt.xml b/reference/bc/functions/bcsqrt.xml
index 1ddec3af3..63fcf8098 100644
--- a/reference/bc/functions/bcsqrt.xml
+++ b/reference/bc/functions/bcsqrt.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 04c37bc8ca6b2faff2b14b85b4576529444bd6a2 Maintainer: ae Status: ready --><!-- CREDITS: rarruda,ae -->
+<!-- EN-Revision: ddb05f8827151e25dd1c3e058f95f6c024bc881b Maintainer: leonardolara Status: ready --><!-- CREDITS: rarruda,ae -->
 <refentry xml:id="function.bcsqrt" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>bcsqrt</refname>
@@ -13,9 +13,9 @@
    <methodparam><type>string</type><parameter>num</parameter></methodparam>
    <methodparam choice="opt"><type class="union"><type>int</type><type>null</type></type><parameter>scale</parameter><initializer>&null;</initializer></methodparam>
   </methodsynopsis>
-  <para>
-   Retorna a raiz quadrada do <parameter>num</parameter>.
-  </para>
+  <simpara>
+   Retorna a raiz quadrada de <parameter>num</parameter>.
+  </simpara>
  </refsect1>
 
  <refsect1 role="parameters">
diff --git a/reference/bc/functions/bcsub.xml b/reference/bc/functions/bcsub.xml
index 6f0279db3..390465f0f 100644
--- a/reference/bc/functions/bcsub.xml
+++ b/reference/bc/functions/bcsub.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 23f5599c8cc2713e7a4fdc29d8cceab66c341c48 Maintainer: ae Status: ready --><!-- CREDITS: rarruda,ae -->
-<refentry xml:id="function.bcsub" xmlns="http://docbook.org/ns/docbook">
+<!-- EN-Revision: ddb05f8827151e25dd1c3e058f95f6c024bc881b Maintainer: leonardolara Status: ready --><!-- CREDITS: rarruda,ae -->
+<refentry xml:id="function.bcsub" xmlns="http://docbook.org/ns/docbook" xmlns:xi="http://www.w3.org/2001/XInclude">
  <refnamediv>
   <refname>bcsub</refname>
   <refpurpose>Subtrai um número de precisão arbitrária de outro</refpurpose>
@@ -14,35 +14,13 @@
    <methodparam><type>string</type><parameter>num2</parameter></methodparam>
    <methodparam choice="opt"><type class="union"><type>int</type><type>null</type></type><parameter>scale</parameter><initializer>&null;</initializer></methodparam>
   </methodsynopsis>
-  <para>
-   Subtrai <parameter>num2</parameter> de
-   <parameter>num1</parameter>.
-  </para>
+  <simpara>
+   Subtrai <parameter>num2</parameter> de <parameter>num1</parameter>.
+  </simpara>
  </refsect1>
 
  <refsect1 role="parameters">
-  &reftitle.parameters;
-  <para>
-   <variablelist>
-    <varlistentry>
-     <term><parameter>num1</parameter></term>
-     <listitem>
-      <para>
-       O operando da esquerda, como uma string.
-      </para>
-     </listitem>
-    </varlistentry>
-    <varlistentry>
-     <term><parameter>num2</parameter></term>
-     <listitem>
-      <para>
-       O operando da direita, como uma string.
-      </para>
-     </listitem>
-    </varlistentry>
-    &bc.scale.description;
-   </variablelist>
-  </para>
+  <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('function.bcadd')/db:refsect1[@role='parameters']/*)" />
  </refsect1>
 
  <refsect1 role="returnvalues">
@@ -52,6 +30,8 @@
   </para>
  </refsect1>
 
+ <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('function.bcadd')/db:refsect1[@role='errors'])" />
+
  <refsect1 role="changelog">
   &reftitle.changelog;
   <informaltable>
@@ -66,7 +46,7 @@
      <row>
       <entry>8.0.0</entry>
       <entry>
-       <parameter>scale</parameter> agora pode ser null.
+       <parameter>scale</parameter> agora pode ser nulo.
       </entry>
      </row>
     </tbody>