Skip to content

Commit

Permalink
Revert bc updates because of nestes xi:include error
Browse files Browse the repository at this point in the history
This reverts commit 6d35bd3.
  • Loading branch information
leonardolara committed Dec 1, 2024
1 parent 6d35bd3 commit e058615
Show file tree
Hide file tree
Showing 14 changed files with 186 additions and 718 deletions.
24 changes: 4 additions & 20 deletions reference/bc/functions/bcadd.xml
Original file line number Diff line number Diff line change
@@ -1,9 +1,9 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: ddb05f8827151e25dd1c3e058f95f6c024bc881b Maintainer: leonardolara Status: ready --><!-- CREDITS: rarruda,ae,leonardolara -->
<!-- EN-Revision: 23f5599c8cc2713e7a4fdc29d8cceab66c341c48 Maintainer: ae Status: ready --><!-- CREDITS: rarruda,ae -->
<refentry xml:id="function.bcadd" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>bcadd</refname>
<refpurpose>Adiciona dois números de precisão arbitrária</refpurpose>
<refpurpose>Adicionar dois números de precisão arbitrária</refpurpose>
</refnamediv>

<refsect1 role="description">
Expand Down Expand Up @@ -52,22 +52,6 @@
</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>
Expand All @@ -82,7 +66,7 @@
<row>
<entry>8.0.0</entry>
<entry>
<parameter>scale</parameter> agora pode ser nulo.
<parameter>scale</parameter> pode ser null.
</entry>
</row>
</tbody>
Expand All @@ -93,7 +77,7 @@
<refsect1 role="examples">
&reftitle.examples;
<example>
<title>Exemplo de <function>bcadd</function></title>
<title>Exemplo <function>bcadd</function></title>
<programlisting role="php">
<![CDATA[
<?php
Expand Down
101 changes: 0 additions & 101 deletions reference/bc/functions/bcceil.xml

This file was deleted.

59 changes: 44 additions & 15 deletions reference/bc/functions/bccomp.xml
Original file line number Diff line number Diff line change
@@ -1,9 +1,9 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- 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">
<!-- EN-Revision: 23f5599c8cc2713e7a4fdc29d8cceab66c341c48 Maintainer: ae Status: ready --><!-- CREDITS: rarruda,ae -->
<refentry xml:id="function.bccomp" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>bccomp</refname>
<refpurpose>Compara dois números de precisão arbitrária</refpurpose>
<refpurpose>Comparar dois números de precisão arbitrária</refpurpose>
</refnamediv>

<refsect1 role="description">
Expand All @@ -15,26 +15,55 @@
<methodparam choice="opt"><type class="union"><type>int</type><type>null</type></type><parameter>scale</parameter><initializer>&null;</initializer></methodparam>
</methodsynopsis>
<para>
Compara <parameter>num1</parameter> com <parameter>num2</parameter>
e retorna o resultado da comparação como um inteiro.
Compara o <parameter>num1</parameter> com o
<parameter>num2</parameter> e retorna o resultado
como um inteiro.
</para>
</refsect1>

<refsect1 role="parameters">
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('function.bcadd')/db: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>
</refsect1>

<refsect1 role="returnvalues">
&reftitle.returnvalues;
<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>
<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>
</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>
Expand All @@ -49,7 +78,7 @@
<row>
<entry>8.0.0</entry>
<entry>
<parameter>scale</parameter> pode ser nulo.
<parameter>scale</parameter> pode ser null.
</entry>
</row>
</tbody>
Expand All @@ -60,7 +89,7 @@
<refsect1 role="examples">
&reftitle.examples;
<example>
<title>Exemplo de <function>bccomp</function></title>
<title>Exemplo da <function>bccomp</function></title>
<programlisting role="php">
<![CDATA[
<?php
Expand Down
33 changes: 19 additions & 14 deletions reference/bc/functions/bcdiv.xml
Original file line number Diff line number Diff line change
@@ -1,9 +1,9 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- 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">
<!-- EN-Revision: 87f32875a189be7ee2a8487c0db3958579e4ce72 Maintainer: ae Status: ready --><!-- CREDITS: rarruda,ae,leonardolara -->
<refentry xml:id="function.bcdiv" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>bcdiv</refname>
<refpurpose>Divide dois números de precisão arbitrária</refpurpose>
<refpurpose>Dividir dois números de precisão arbitrária</refpurpose>
</refnamediv>

<refsect1 role="description">
Expand All @@ -14,9 +14,10 @@
<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>
Divide <parameter>num1</parameter> por <parameter>num2</parameter>.
</simpara>
<para>
Divide o <parameter>num1</parameter> pelo
<parameter>num2</parameter>.
</para>
</refsect1>

<refsect1 role="parameters">
Expand Down Expand Up @@ -52,11 +53,17 @@
</refsect1>

<refsect1 role="errors">
<!-- 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']/*)" />
&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>.
Esta função lança uma exceção <exceptionname>DivisionByZeroError</exceptionname> se <parameter>num2</parameter>
for igual a <literal>0</literal>.
</simpara>
</refsect1>

Expand All @@ -74,15 +81,13 @@
<row>
<entry>8.0.0</entry>
<entry>
<parameter>scale</parameter> pode ser nulo.
<parameter>scale</parameter> pode ser null.
</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 &null;.
Dividir por 0 agora lança uma exceção <exceptionname>DivisionByZeroError</exceptionname> ao invés de retornar null.
</entry>
</row>
</tbody>
Expand Down
Loading

0 comments on commit e058615

Please sign in to comment.