sigmasternchen/php-doc-en
1
0
Fork 0
mirror of https://github.com/sigmasternchen/php-doc-en synced 2025-03-16 00:48:54 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions

finally i've done someting :)

Browse source 
git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@141942 c90b9560-bf6c-de11-be94-00142212c4b1
This commit is contained in:
Thomas Gonzalez Miranda 2003-10-06 21:26:22 +00:00
parent dc8e37c499
commit a37ab2f355
21 changed files with 302 additions and 290 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

4
reference/calendar/configure.xml
View file

@ -1,9 +1,9 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.1 $ -->
<!-- $Revision: 1.2 $ -->
<section id="calendar.installation">
&reftitle.install;
<para>
To get these functions to work, you have to compile PHP with
Para estas funções funcionarem, você precisa compilar o PHP com
<option role="configure">--enable-calendar</option>.
</para>
&windows.builtin;

48
reference/calendar/constants.xml
View file

@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.4 $ -->
<!-- $Revision: 1.5 $ -->
<section id="calendar.constants">
&reftitle.constants;
&extension.constants;
@ -7,7 +7,7 @@
<varlistentry>
<term>
<constant>CAL_GREGORIAN</constant>
(<type>integer</type>)
(<type>inteiro</type>)
</term>
<listitem>
<simpara>
@ -18,7 +18,7 @@
<varlistentry>
<term>
<constant>CAL_JULIAN</constant>
(<type>integer</type>)
(<type>inteiro</type>)
</term>
<listitem>
<simpara>
@ -29,7 +29,7 @@
<varlistentry>
<term>
<constant>CAL_JEWISH</constant>
(<type>integer</type>)
(<type>inteiro</type>)
</term>
<listitem>
<simpara>
@ -40,7 +40,7 @@
<varlistentry>
<term>
<constant>CAL_FRENCH</constant>
(<type>integer</type>)
(<type>inteiro</type>)
</term>
<listitem>
<simpara>
@ -51,7 +51,7 @@
<varlistentry>
<term>
<constant>CAL_NUM_CALS</constant>
(<type>integer</type>)
(<type>inteiro</type>)
</term>
<listitem>
<simpara>
@ -62,7 +62,7 @@
<varlistentry>
<term>
<constant>CAL_DOW_DAYNO</constant>
(<type>integer</type>)
(<type>inteiro</type>)
</term>
<listitem>
<simpara>
@ -73,7 +73,7 @@
<varlistentry>
<term>
<constant>CAL_DOW_SHORT</constant>
(<type>integer</type>)
(<type>inteiro</type>)
</term>
<listitem>
<simpara>
@ -84,7 +84,7 @@
<varlistentry>
<term>
<constant>CAL_DOW_LONG</constant>
(<type>integer</type>)
(<type>inteiro</type>)
</term>
<listitem>
<simpara>
@ -95,7 +95,7 @@
<varlistentry>
<term>
<constant>CAL_MONTH_GREGORIAN_SHORT</constant>
(<type>integer</type>)
(<type>inteiro</type>)
</term>
<listitem>
<simpara>
@ -106,7 +106,7 @@
<varlistentry>
<term>
<constant>CAL_MONTH_GREGORIAN_LONG</constant>
(<type>integer</type>)
(<type>inteiro</type>)
</term>
<listitem>
<simpara>
@ -117,7 +117,7 @@
<varlistentry>
<term>
<constant>CAL_MONTH_JULIAN_SHORT</constant>
(<type>integer</type>)
(<type>inteiro</type>)
</term>
<listitem>
<simpara>
@ -128,7 +128,7 @@
<varlistentry>
<term>
<constant>CAL_MONTH_JULIAN_LONG</constant>
(<type>integer</type>)
(<type>inteiro</type>)
</term>
<listitem>
<simpara>
@ -139,7 +139,7 @@
<varlistentry>
<term>
<constant>CAL_MONTH_JEWISH</constant>
(<type>integer</type>)
(<type>inteiro</type>)
</term>
<listitem>
<simpara>
@ -150,7 +150,7 @@
<varlistentry>
<term>
<constant>CAL_MONTH_FRENCH</constant>
(<type>integer</type>)
(<type>inteiro</type>)
</term>
<listitem>
<simpara>
@ -160,13 +160,13 @@
</varlistentry>
</variablelist>
<para>
The following constants are available since <literal>PHP</literal> 4.3.0 :
As constantes abaixo estão disponíveis à partir da versão 4.3.0 do <literal>PHP</literal> :
</para>
<variablelist>
<varlistentry>
<term>
<constant>CAL_EASTER_DEFAULT</constant>
(<type>integer</type>)
(<type>inteiro</type>)
</term>
<listitem>
<simpara>
@ -177,7 +177,7 @@
<varlistentry>
<term>
<constant>CAL_EASTER_ROMAN</constant>
(<type>integer</type>)
(<type>inteiro</type>)
</term>
<listitem>
<simpara>
@ -188,7 +188,7 @@
<varlistentry>
<term>
<constant>CAL_EASTER_ALWAYS_GREGORIAN</constant>
(<type>integer</type>)
(<type>inteiro</type>)
</term>
<listitem>
<simpara>
@ -199,7 +199,7 @@
<varlistentry>
<term>
<constant>CAL_EASTER_ALWAYS_JULIAN</constant>
(<type>integer</type>)
(<type>inteiro</type>)
</term>
<listitem>
<simpara>
@ -209,13 +209,13 @@
</varlistentry>
</variablelist>
<para>
The following constants are available since <literal>PHP</literal> 5.0.0 :
As constantes abaixo estão disponíveis à partir da versão 5.0.0 do <literal>PHP</literal> :
</para>
<variablelist>
<varlistentry>
<term>
<constant>CAL_JEWISH_ADD_ALAFIM_GERESH</constant>
(<type>integer</type>)
(<type>inteiro</type>)
</term>
<listitem>
<simpara>
@ -226,7 +226,7 @@
<varlistentry>
<term>
<constant>CAL_JEWISH_ADD_ALAFIM</constant>
(<type>integer</type>)
(<type>inteiro</type>)
</term>
<listitem>
<simpara>
@ -237,7 +237,7 @@
<varlistentry>
<term>
<constant>CAL_JEWISH_ADD_GERESHAYIM</constant>
(<type>integer</type>)
(<type>inteiro</type>)
</term>
<listitem>
<simpara>

24
reference/calendar/functions/cal-days-in-month.xml
View file

@ -1,39 +1,39 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.3 $ -->
<!-- $Revision: 1.4 $ -->
<!-- splitted from ./en/functions/calendar.xml, last change in rev 1.19 -->
<refentry id="function.cal-days-in-month">
<refnamediv>
<refname>cal_days_in_month</refname>
<refpurpose>Return the number of days in a month for a given year and calendar</refpurpose>
<refpurpose>Retorna o número de dias em um mês de um calendário e ano requisitado</refpurpose>
</refnamediv>
<refsect1>
<title>Description</title>
<title>Descrição</title>
<methodsynopsis>
<type>int</type><methodname>cal_days_in_month</methodname>
<methodparam><type>int</type><parameter>calendar</parameter></methodparam>
<methodparam><type>int</type><parameter>month</parameter></methodparam>
<methodparam><type>int</type><parameter>year</parameter></methodparam>
<methodparam><type>int</type><parameter>calendario</parameter></methodparam>
<methodparam><type>int</type><parameter>mês</parameter></methodparam>
<methodparam><type>int</type><parameter>ano</parameter></methodparam>
</methodsynopsis>
<para>
This function will return the number of days in the
<parameter>month</parameter> of <parameter>year</parameter> for
the specified <parameter>calendar</parameter>.
ESta função irá retornar o número de dias em um
<parameter>month</parameter> do <parameter>ano</parameter> para
o <parameter>calendário</parameter> especificado.
</para>
<para>
<example>
<title><function>cal_days_in_month</function> example</title>
<title><function>cal_days_in_month</function> exemplo</title>
<programlisting role="php">
<![CDATA[
<?php
$num = cal_days_in_month(CAL_GREGORIAN, 8, 2003); // 31
echo "There was $num days in August 2003";
echo "Houve $num dias em Agosto de 2003";
?>
]]>
</programlisting>
</example>
</para>
<para>
See also <function>jdtounix</function>.
Veja também <function>jdtounix</function>.
</para>
</refsect1>
</refentry>

28
reference/calendar/functions/cal-from-jd.xml
View file

@ -1,41 +1,41 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.5 $ -->
<!-- $Revision: 1.6 $ -->
<!-- splitted from ./en/functions/calendar.xml, last change in rev 1.19 -->
<refentry id='function.cal-from-jd'>
<refnamediv>
<refname>cal_from_jd</refname>
<refpurpose>Converts from Julian Day Count to a supported calendar</refpurpose>
<refpurpose>Converte à partir do "Julian Day Count" para um outro calendário suportado</refpurpose>
</refnamediv>
<refsect1>
<title>Description</title>
<title>Descrição</title>
<methodsynopsis>
<type>array</type><methodname>cal_from_jd</methodname>
<methodparam><type>int</type><parameter>jd</parameter></methodparam>
<methodparam><type>int</type><parameter>calendar</parameter></methodparam>
<methodparam><type>int</type><parameter>calendário</parameter></methodparam>
</methodsynopsis>
<para>
<function>cal_from_jd</function> converts the julian day given in
<parameter>jd</parameter> into a date of the specified
<parameter>calendar</parameter>. Supported
<parameter>calendar</parameter> values are
<function>cal_from_jd</function> converte do "Julian Day Count" (
<parameter>jd</parameter>) para uma data de um
<parameter>calendário</parameter> especificado. Os valores dos
<parameter>calendários</parameter> suportados são
<constant>CAL_GREGORIAN</constant>,
<constant>CAL_JULIAN</constant>,
<constant>CAL_JEWISH</constant> and
<constant>CAL_JEWISH</constant> e
<constant>CAL_FRENCH</constant>.
</para>
<para>
<example>
<title><function>cal_from_jd</function> example</title>
<title><function>cal_from_jd</function> exemplo</title>
<programlisting role="php">
<![CDATA[
<?php
$today = unixtojd(mktime(0, 0, 0, 8, 16, 2003));
print_r(cal_from_jd($today, CAL_GREGORIAN));
$hoje = unixtojd(mktime(0, 0, 0, 8, 16, 2003));
print_r(cal_from_jd($hoje, CAL_GREGORIAN));
?>
]]>
</programlisting>
<para>
This will output :
Este código retorna:
</para>
<screen>
<![CDATA[
@ -56,7 +56,7 @@ Array
</example>
</para>
<para>
See also <function>cal_to_jd</function>.
Veja também <function>cal_to_jd</function>.
</para>
</refsect1>
</refentry>

26
reference/calendar/functions/cal-info.xml
View file

@ -1,32 +1,32 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.6 $ -->
<!-- $Revision: 1.7 $ -->
<!-- splitted from ./en/functions/calendar.xml, last change in rev 1.19 -->
<refentry id='function.cal-info'>
<refnamediv>
<refname>cal_info</refname>
<refpurpose>Returns information about a particular calendar</refpurpose>
<refpurpose>Retorna informações sobre um calendário em particular</refpurpose>
</refnamediv>
<refsect1>
<title>Description</title>
<title>Descrição</title>
<methodsynopsis>
<type>array</type><methodname>cal_info</methodname>
<methodparam choice='opt'><type>int</type><parameter>calendar</parameter></methodparam>
<methodparam choice='opt'><type>int</type><parameter>calendário</parameter></methodparam>
</methodsynopsis>
<para>
<function>cal_info</function> returns information on the
specified <parameter>calendar</parameter> or on all supported
calendars if no <parameter>calendar</parameter> is specified.
<function>cal_info</function> retorna as informações de um
<parameter>calendário</parameter> específico ou de todos os calendários
se nenhum <parameter>calendário</parameter> for especificado.
</para>
<para>
Calendar information is returned as an array containing the
elements <literal>calname</literal>, <literal>calsymbol</literal>,
<literal>month</literal>, <literal>abbrevmonth</literal> and
A informação do calendário especificado é retornada em um array contendo os
elementos <literal>calname</literal>, <literal>calsymbol</literal>,
<literal>month</literal>, <literal>abbrevmonth</literal> e
<literal>maxdaysinmonth</literal>.
</para>
<para>
If no <parameter>calendar</parameter> is specified information on all
supported calendars is returned as an array. This functionality
will be available beginning with PHP 5.
Se nenhum <parameter>calendário</parameter> foi especificado as informações de
todos os calendários suportados são retornadas em um array. Esta funcionalidade
será suportada à partir do PHP 5.
</para>
</refsect1>
</refentry>

24
reference/calendar/functions/cal-to-jd.xml
View file

@ -1,31 +1,31 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.4 $ -->
<!-- $Revision: 1.5 $ -->
<!-- splitted from ./en/functions/calendar.xml, last change in rev 1.19 -->
<refentry id='function.cal-to-jd'>
<refnamediv>
<refname>cal_to_jd</refname>
<refpurpose>Converts from a supported calendar to Julian Day Count</refpurpose>
<refpurpose>Converte um calendário (suportado) para o calendário "Julian Day Count"</refpurpose>
</refnamediv>
<refsect1>
<title>Description</title>
<title>Descrião</title>
<methodsynopsis>
<type>int</type><methodname>cal_to_jd</methodname>
<methodparam><type>int</type><parameter>calendar</parameter></methodparam>
<methodparam><type>int</type><parameter>month</parameter></methodparam>
<methodparam><type>int</type><parameter>day</parameter></methodparam>
<methodparam><type>int</type><parameter>year</parameter></methodparam>
<methodparam><type>int</type><parameter>calendário</parameter></methodparam>
<methodparam><type>int</type><parameter>mês</parameter></methodparam>
<methodparam><type>int</type><parameter>dia</parameter></methodparam>
<methodparam><type>int</type><parameter>ano</parameter></methodparam>
</methodsynopsis>
<para>
<function>cal_to_jd</function> calculates the julian day count
for a date in the specified <parameter>calendar</parameter>.
Supported <parameter>calendar</parameter>s are
<function>cal_to_jd</function> calcula uma data em formato "Julian Day Count"
à partir de um <parameter>calendário</parameter> suportado especificado.
Os <parameter>calendários</parameter> suportados são:
<constant>CAL_GREGORIAN</constant>,
<constant>CAL_JULIAN</constant>,
<constant>CAL_JEWISH</constant> and
<constant>CAL_JEWISH</constant> e
<constant>CAL_FRENCH</constant>.
</para>
<para>
See also <function>cal_to_jd</function>.
Veja também <function>cal_to_jd</function>.
</para>
</refsect1>
</refentry>

61
reference/calendar/functions/easter-date.xml
View file

@ -1,34 +1,39 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.4 $ -->
<!-- $Revision: 1.5 $ -->
<!-- splitted from ./en/functions/calendar.xml, last change in rev 1.2 -->
<!--
A.D -> anno dommini (depois de cristo) D.C
B.C -> before christ (antes de cristo) A.C
-->
<refentry id="function.easter-date">
<refnamediv>
<refname>easter_date</refname>
<refpurpose>
Get UNIX timestamp for midnight on Easter of a given year
Retorna a data do sistema UNIX correspondente à meia-noite da Páscoa do ano especificado.
Se nenhum ano tiver sido especificado, será assumido o ano atual.
</refpurpose>
</refnamediv>
<refsect1>
<title>Description</title>
<title>Descrição</title>
<methodsynopsis>
<type>int</type><methodname>easter_date</methodname>
<methodparam choice="opt"><type>int</type><parameter>year</parameter></methodparam>
<methodparam choice="opt"><type>int</type><parameter>ano</parameter></methodparam>
</methodsynopsis>
<para>
Returns the UNIX timestamp corresponding to midnight on Easter of
the given year.
Retorna a data do sistema UNIX correspondente à meia-noite da Páscoa do ano especificado.
Se nenhum ano tiver sido especificado, será assumido o ano atual.
</para>
<para>
Since <literal>PHP</literal> 4.3.0, the <parameter>year</parameter>
parameter is optional and defaults to the current year according to the
localtime if ommited.
À partir da versão 4.3.0 <literal>PHP</literal>, e se omitido
o parâmetro <parameter>ano</parameter>, o padrão assumido é o ano
atual de acordo com a hora local.
</para>
<para>
<emphasis>Warning:</emphasis> This function will generate
a warning if the year is outside of the range for UNIX
timestamps (i.e. before 1970 or after 2037).
<emphasis>Aviso</emphasis> Esta função irá gerar um aviso se
o ano está fora do padrão de datas do sistema UNIX (i.e. antes
de 1970 ou após 2037).
<example>
<title><function>easter_date</function> example</title>
<title><function>easter_date</function> exemplo</title>
<programlisting role="php">
<![CDATA[
<?php
@ -43,27 +48,25 @@ echo date ("M-d-Y", easter_date(2001)); // Apr-15-2001
</example>
</para>
<para>
The date of Easter Day was defined by the Council of Nicaea in
AD325 as the Sunday after the first full moon which falls on or
after the Spring Equinox. The Equinox is assumed to always fall
on 21st March, so the calculation reduces to determining the date
of the full moon and the date of the following Sunday. The
algorithm used here was introduced around the year 532 by
Dionysius Exiguus. Under the Julian Calendar (for years before
1753) a simple 19-year cycle is used to track the phases of the
Moon. Under the Gregorian Calendar (for years after 1753 -
devised by Clavius and Lilius, and introduced by Pope Gregory
XIII in October 1582, and into Britain and its then colonies in
September 1752) two correction factors are added to make the
cycle more accurate.
A data da Páscoa foi definida pelo Conselho de Nicaea em
DC325 como sendo o primeiro domingo após a primeira lua cheia
que cai no equinócio da primavera ou depois dele. O equinócio geralmente
cai perto do 21º de Março, logo, o cálculo resume-se à determinar a data
da lua cheia e a data do seguinte domingo. O algoritmo usado aqui foi
feito no ano 532 por Dionysius Exiguus. De acordo com o calendário "Julian" (para
anos anterioris à 1753) um simples ciclo de 19-anos é usado para seguir as
fases da lua. De acordo com o Calendário Gregoriano (para antes após 1753 -
planejado por Clavius e por Lilius, e feito por Pope Gregory XIII em Outubro
de 1582, e na Grã Bretanha e suas colônias em Setembro de 1752), duas correções
fatoriais foram adicionadas para fazer o ciclo mais exato.
</para>
<para>
(The code is based on a C program by Simon Kershaw,
(O código é baseado em um programa feito em C por Simon Kershaw,
&lt;webmaster@ely.anglican.org&gt;)
</para>
<para>
See <function>easter_days</function> for calculating Easter
before 1970 or after 2037.
Veja <function>easter_days</function> para calcular a Páscoa
antes de 1970 ou após 2037.
</para>
</refsect1>
</refentry>

72
reference/calendar/functions/easter-days.xml
View file

@ -1,46 +1,44 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.4 $ -->
<!-- $Revision: 1.5 $ -->
<!-- splitted from ./en/functions/calendar.xml, last change in rev 1.2 -->
<refentry id="function.easter-days">
<refnamediv>
<refname>easter_days</refname>
<refpurpose>
Get number of days after March 21 on which Easter falls for a
given year
Obtém o número de dias entre 21 de Março e o dia da Páscoa em
determinado ano.
</refpurpose>
</refnamediv>
<refsect1>
<title>Description</title>
<methodsynopsis>
<type>int</type><methodname>easter_days</methodname>
<methodparam choice="opt"><type>int</type><parameter>year</parameter></methodparam>
<methodparam choice="opt"><type>int</type><parameter>method</parameter></methodparam>
<methodparam choice="opt"><type>int</type><parameter>ano</parameter></methodparam>
<methodparam choice="opt"><type>int</type><parameter>método</parameter></methodparam>
</methodsynopsis>
<para>
Returns the number of days after March 21 on which Easter falls
for a given year. If no year is specified, the current year is
assumed.
Retorna o número de dias entre 21 de Março e o dia da Páscoa em
determinado ano. Se nenhum ano tiver sido especificado, será assumido
o ano atual.
</para>
<para>
Since <literal>PHP</literal> 4.3.0, the <parameter>year</parameter>
parameter is optional and defaults to the current year according to the
localtime if ommited.
À partir da versão 4.3.0 do <literal>PHP</literal>, o parâmetro <parameter>ano</parameter>
é opcional e se for omitido o padrão assumido é o ano atual de acrodo com o hora local.
</para>
<para>
The <parameter>method</parameter> parameter was also introduced in
<literal>PHP</literal> 4.3.0 and allows to calculate easter dates based
on the Gregorian calendar during the years 1582 - 1752 when set to
<constant>CAL_EASTER_ROMAN</constant>. See the <link
linkend="calendar.constants">calendar constants</link> for more valid
constants.
O parâmetro <parameter>método</parameter> está disponível à partir da versão
4.3.0 do <literal>PHP</literal> e perimite calcular as datas da Páscoa baseadas no
calendário Gregoriano durante os anos 1582 - 1752 quando a constante
<constant>CAL_EASTER_ROMAN</constant> está ligada. Veja as
<link linkend="calendar.constants">constantes de calendário</link> para obter
outras constantes válidas.
</para>
<para>
This function can be used instead of
<function>easter_date</function> to calculate Easter for years
which fall outside the range of UNIX timestamps (i.e. before 1970
or after 2037).
<example>
<title><function>easter_days</function> example</title>
Ao invés de usar a função <function>easter_date</function>,
você pode usar esta função para calcular a Páscoa em anos que estão
fora da escala de datas do sistema UNIX (i.e. antes de 1970 ou após 2037).
<example>
<title><function>easter_days</function> exemplo</title>
<programlisting role="php">
<![CDATA[
<?php
@ -55,26 +53,24 @@ echo easter_days (1913); // 2, i.e. March 23
</example>
</para>
<para>
The date of Easter Day was defined by the Council of Nicaea in
AD325 as the Sunday after the first full moon which falls on or
after the Spring Equinox. The Equinox is assumed to always fall
on 21st March, so the calculation reduces to determining the date
of the full moon and the date of the following Sunday. The
algorithm used here was introduced around the year 532 by
Dionysius Exiguus. Under the Julian Calendar (for years before
1753) a simple 19-year cycle is used to track the phases of the
Moon. Under the Gregorian Calendar (for years after 1753 -
devised by Clavius and Lilius, and introduced by Pope Gregory
XIII in October 1582, and into Britain and its then colonies in
September 1752) two correction factors are added to make the
cycle more accurate.
A data da Páscoa foi definida pelo Conselho de Nicaea em
DC325 como sendo o primeiro domingo após a primeira lua cheia
que cai no equinócio da primavera ou depois dele. O equinócio geralmente
cai perto do 21º de Março, logo, o cálculo resume-se à determinar a data
da lua cheia e a data do seguinte domingo. O algoritmo usado aqui foi
feito no ano 532 por Dionysius Exiguus. De acordo com o calendário "Julian" (para
anos anterioris à 1753) um simples ciclo de 19-anos é usado para seguir as
fases da lua. De acordo com o Calendário Gregoriano (para antes após 1753 -
planejado por Clavius e por Lilius, e feito por Pope Gregory XIII em Outubro
de 1582, e na Grã Bretanha e suas colônias em Setembro de 1752), duas correções
fatoriais foram adicionadas para fazer o ciclo mais exato.
</para>
<para>
(The code is based on a C program by Simon Kershaw,
(O código é baseado em um programa feito em C por Simon Kershaw,
&lt;webmaster@ely.anglican.org&gt;)
</para>
<para>
See also <function>easter_date</function>.
Veja também <function>easter_date</function>.
</para>
</refsect1>
</refentry>

26
reference/calendar/functions/frenchtojd.xml
View file

@ -1,31 +1,31 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.2 $ -->
<!-- $Revision: 1.3 $ -->
<!-- splitted from ./en/functions/calendar.xml, last change in rev 1.4 -->
<refentry id="function.frenchtojd">
<refnamediv>
<refname>FrenchToJD</refname>
<refpurpose>
Converts a date from the French Republican Calendar to a Julian
Day Count
Converte uma data do calendário Republicano da França para o calendário
"Julian Day Count".
</refpurpose>
</refnamediv>
<refsect1>
<title>Description</title>
<title>Descrição</title>
<methodsynopsis>
<type>int</type><methodname>frenchtojd</methodname>
<methodparam><type>int</type><parameter>month</parameter></methodparam>
<methodparam><type>int</type><parameter>day</parameter></methodparam>
<methodparam><type>int</type><parameter>year</parameter></methodparam>
<methodparam><type>int</type><parameter>mês</parameter></methodparam>
<methodparam><type>int</type><parameter>dia</parameter></methodparam>
<methodparam><type>int</type><parameter>ano</parameter></methodparam>
</methodsynopsis>
<para>
Converts a date from the French Republican Calendar to a Julian
Day Count.
Converte uma data do calendário Republicano da França para o calendário
"Julian Day Count".
</para>
<para>
These routines only convert dates in years 1 through 14
(Gregorian dates 22 September 1792 through 22 September
1806). This more than covers the period when the calendar was in
use.
Estas rotinas somente converte datas entre os anos de 1 até 14
(datas Gregorianas de 22 de Setembro de 1792 até 22 de Setembro
de 1806). "This more than covers the period when the calendar was in
use."
</para>
</refsect1>
</refentry>

34
reference/calendar/functions/gregoriantojd.xml
View file

@ -1,33 +1,37 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.2 $ -->
<!-- $Revision: 1.3 $ -->
<!-- splitted from ./en/functions/calendar.xml, last change in rev 1.4 -->
<!--
A.D -> anno dommini (depois de cristo) D.C
B.C -> before christ (antes de cristo) A.C
-->
<refentry id="function.gregoriantojd">
<refnamediv>
<refname>GregorianToJD</refname>
<refpurpose>
Converts a Gregorian date to Julian Day Count
Converte uma data do calendário Gregoriano para o calendário "Julian Day Count".
</refpurpose>
</refnamediv>
<refsect1>
<title>Description</title>
<title>Descrição</title>
<methodsynopsis>
<type>int</type><methodname>gregoriantojd</methodname>
<methodparam><type>int</type><parameter>month</parameter></methodparam>
<methodparam><type>int</type><parameter>day</parameter></methodparam>
<methodparam><type>int</type><parameter>year</parameter></methodparam>
<methodparam><type>int</type><parameter>mês</parameter></methodparam>
<methodparam><type>int</type><parameter>dia</parameter></methodparam>
<methodparam><type>int</type><parameter>ano</parameter></methodparam>
</methodsynopsis>
<para>
Valid Range for Gregorian Calendar 4714 B.C. to 9999 A.D.</para>
Escala válida para o Calendário Gregoriano: 4714 A.C. to 9999 D.C.</para>
<para>
Although this function can handle dates all the way back to 4714
B.C., such use may not be meaningful. The Gregorian calendar was
not instituted until October 15, 1582 (or October 5, 1582 in the
Julian calendar). Some countries did not accept it until much
later. For example, Britain converted in 1752, The USSR in 1918
and Greece in 1923. Most European countries used the Julian
calendar prior to the Gregorian.
Entretanto esta função pode trabalhar com todas datas anteriores à,
porém usá-la desta maneira não tem muito sentido. O Calendário Gregoriano
não foi instituído até 15 de Outubro de 1582 (ou 5 de Outubro de 1582, no
calendário JDC ("Julian Day Count")). Alguns países aceitaram este calendário
um pouco mais tarde. Por exemplo, a Grã Bretanha converteu-se em 1752, a URSS
em 1918 e a Grécia em 1923. A maioria dos países Europeus usaram o calendário
"Julian" (JDC) antes do calendário Gregoriano.
<example>
<title>Calendar functions</title>
<title>Funções do Calendário</title>
<programlisting role="php">
<![CDATA[
<?php

28
reference/calendar/functions/jddayofweek.xml
View file

@ -1,49 +1,49 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.2 $ -->
<!-- $Revision: 1.3 $ -->
<!-- splitted from ./en/functions/calendar.xml, last change in rev 1.4 -->
<refentry id="function.jddayofweek">
<refnamediv>
<refname>JDDayOfWeek</refname>
<refpurpose>Returns the day of the week</refpurpose>
<refpurpose>Retorna o dia da semana</refpurpose>
</refnamediv>
<refsect1>
<title>Description</title>
<title>Descrição</title>
<methodsynopsis>
<type>mixed</type><methodname>jddayofweek</methodname>
<methodparam><type>int</type><parameter>julianday</parameter></methodparam>
<methodparam><type>int</type><parameter>mode</parameter></methodparam>
<methodparam><type>int</type><parameter>modo</parameter></methodparam>
</methodsynopsis>
<para>
Returns the day of the week. Can return a string or an integer
depending on the mode.
Retorna o dia da semana. Pode retornar uma "string" ou um inteiro
dependendo do modo utilizado.
<table>
<title>Calendar week modes</title>
<title>Calendários da semana (modos)</title>
<tgroup cols="2">
<thead>
<row>
<entry>Mode</entry>
<entry>Meaning</entry>
<entry>Modo</entry>
<entry>Significado</entry>
</row>
</thead>
<tbody>
<row>
<entry>0</entry>
<entry>
Returns the day number as an int (0=sunday, 1=monday, etc)
Retonra o dia da semana como sendo um número inteiro (0=domingo, 1=segunda, etc.)
</entry>
</row>
<row>
<entry>1</entry>
<entry>
Returns string containing the day of week
(english-gregorian)
Retorna uma string contendo o dia da semana
(inglês-gregoriano)
</entry>
</row>
<row>
<entry>2</entry>
<entry>
Returns a string containing the abbreviated day of week
(english-gregorian)
Retorna uma "string" contendo a abreviação do dia da semana
(inglês-gregoriano)
</entry>
</row>
</tbody>

44
reference/calendar/functions/jdmonthname.xml
View file

@ -1,62 +1,62 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.2 $ -->
<!-- $Revision: 1.3 $ -->
<!-- splitted from ./en/functions/calendar.xml, last change in rev 1.4 -->
<refentry id="function.jdmonthname">
<refnamediv>
<refname>JDMonthName</refname>
<refpurpose>Returns a month name</refpurpose>
<refpurpose>REtorna o nome de um mês</refpurpose>
</refnamediv>
<refsect1>
<title>Description</title>
<title>Descrição</title>
<methodsynopsis>
<type>string</type><methodname>jdmonthname</methodname>
<methodparam><type>int</type><parameter>julianday</parameter></methodparam>
<methodparam><type>int</type><parameter>mode</parameter></methodparam>
<methodparam><type>int</type><parameter>modo</parameter></methodparam>
</methodsynopsis>
<para>
Returns a string containing a month name.
<parameter>mode</parameter> tells this function which calendar to
convert the Julian Day Count to, and what type of month names are
to be returned.
Retorna uma "string" contendo o nome do mês.
O parâmetro <parameter>modo</parameter> diz à função
qual calendário será convertido para o formato "Julian Day Count",
e o tipo do nome do mês.
<table>
<title>Calendar modes</title>
<title>Calendário (modos)</title>
<tgroup cols="3">
<thead>
<row>
<entry>Mode</entry>
<entry>Meaning</entry>
<entry>Values</entry>
<entry>Modo</entry>
<entry>Significado</entry>
<entry>Valores</entry>
</row>
</thead>
<tbody>
<row>
<entry>0</entry>
<entry>Gregorian - abbreviated</entry>
<entry>Jan, Feb, Mar, Apr, May, Jun, Jul, Aug, Sep, Oct, Nov, Dec</entry>
<entry>Gregoriano - abreviado</entry>
<entry>Jan, Fev, Mar, Abr, Mai, Jun, Jul, Ago, Set, Out, Nov, Dez</entry>
</row>
<row>
<entry>1</entry>
<entry>Gregorian</entry>
<entry>January, February, March, April, May, June, July, August, September, October, November, December</entry>
<entry>Gregoriano</entry>
<entry>Janeiro, Fevereiro, Março, Abril, Maio, Junho, Julho, Agosto, Setembro, Outubro, Novembro, Dezembro</entry>
</row>
<row>
<entry>2</entry>
<entry>Julian - abbreviated</entry>
<entry>Jan, Feb, Mar, Apr, May, Jun, Jul, Aug, Sep, Oct, Nov, Dec</entry>
<entry>"Julian" - abreviado</entry>
<entry>Jan, Fev, Mar, Abr, Mai, Jun, Jul, Ago, Set, Out, Nov, Dez</entry>
</row>
<row>
<entry>3</entry>
<entry>Julian</entry>
<entry>January, February, March, April, May, June, July, August, September, October, November, December</entry>
<entry>"Julian"</entry>
<entry>Janeiro, Fevereiro, Março, Abril, Maio, Junho, Julho, Agosto, Setembro, Outubro, Novembro, Dezembro</entry>
</row>
<row>
<entry>4</entry>
<entry>Jewish</entry>
<entry>Judeu</entry>
<entry>Tishri, Heshvan, Kislev, Tevet, Shevat, AdarI, AdarII, Nisan, Iyyar, Sivan, Tammuz, Av, Elul</entry>
</row>
<row>
<entry>5</entry>
<entry>French Republican</entry>
<entry>Republicano Francês</entry>
<entry>Vendemiaire, Brumaire, Frimaire, Nivose, Pluviose, Ventose, Germinal, Floreal, Prairial, Messidor, Thermidor, Fructidor, Extra</entry>
</row>
</tbody>

8
reference/calendar/functions/jdtofrench.xml
View file

@ -1,21 +1,21 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.2 $ -->
<!-- $Revision: 1.3 $ -->
<!-- splitted from ./en/functions/calendar.xml, last change in rev 1.4 -->
<refentry id="function.jdtofrench">
<refnamediv>
<refname>JDToFrench</refname>
<refpurpose>
Converts a Julian Day Count to the French Republican Calendar
Converte do calendário "Julian Day Count" para o calendário Republicano Francês
</refpurpose>
</refnamediv>
<refsect1>
<title>Description</title>
<title>Descrição</title>
<methodsynopsis>
<type>string</type><methodname>jdtofrench</methodname>
<methodparam><type>int</type><parameter>juliandaycount</parameter></methodparam>
</methodsynopsis>
<para>
Converts a Julian Day Count to the French Republican Calendar.
Converte do calendário "Julian Day Count" para o calendário Republicano Francês
</para>
</refsect1>
</refentry>

10
reference/calendar/functions/jdtogregorian.xml
View file

@ -1,20 +1,20 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.2 $ -->
<!-- $Revision: 1.3 $ -->
<!-- splitted from ./en/functions/calendar.xml, last change in rev 1.4 -->
<refentry id="function.jdtogregorian">
<refnamediv>
<refname>JDToGregorian</refname>
<refpurpose>Converts Julian Day Count to Gregorian date</refpurpose>
<refpurpose>Converte uma data no formato "Julian Day Count" para o formato Gregoriano</refpurpose>
</refnamediv>
<refsect1>
<title>Description</title>
<title>Descrição</title>
<methodsynopsis>
<type>string</type><methodname>jdtogregorian</methodname>
<methodparam><type>int</type><parameter>julianday</parameter></methodparam>
</methodsynopsis>
<para>
Converts Julian Day Count to a string containing the Gregorian
date in the format of "month/day/year".
Converte "Julian Day Count" para uma "string" contendo a data em
formato Gregoriano "mês/dia/ano".
</para>
</refsect1>
</refentry>

20
reference/calendar/functions/jdtojewish.xml
View file

@ -1,15 +1,15 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.4 $ -->
<!-- $Revision: 1.5 $ -->
<!-- splitted from ./en/functions/calendar.xml, last change in rev 1.4 -->
<refentry id="function.jdtojewish">
<refnamediv>
<refname>jdtojewish</refname>
<refpurpose>
Converts a julian day count to a jewish calendar date
Convete uma data do calendário "Julian Day Count" para o calendário Judaico
</refpurpose>
</refnamediv>
<refsect1>
<title>Description</title>
<title>Descrição</title>
<methodsynopsis>
<type>string</type><methodname>jdtojewish</methodname>
<methodparam><type>int</type><parameter>juliandaycount</parameter></methodparam>
@ -17,23 +17,23 @@
<methodparam choice="opt"><type>int</type><parameter>fl</parameter></methodparam>
</methodsynopsis>
<para>
Converts a Julian Day Count the the Jewish Calendar.
Convete uma data do calendário "Julian Day Count" para o calendário Judaico
</para>
<para>
The optional <parameter>hebrew</parameter> and <parameter>fl</parameter>
parameters became available in PHP 5.0.0
Os parâmetros <parameter>hebrew</parameter> e <parameter>fl</parameter>
são opcionais e estarão disponíveis na versão do PHP 5.0.0
</para>
<para>
If the the <parameter>hebrew</parameter> parameter is set to &true;, the
<parameter>fl</parameter> parameter is used for hebrew, string based,
output format. The available formats are:
Se o parâmetro <parameter>hebrew</parameter> for &true;, o parâmetro
<parameter>fl</parameter> a "string" de saída de dados é
baseada no formato "hebrew". Os formatos disponíveis são:
<constant>CAL_JEWISH_ADD_ALAFIM_GERESH</constant>,
<constant>CAL_JEWISH_ADD_ALAFIM</constant>,
<constant>CAL_JEWISH_ADD_GERESHAYIM</constant>.
</para>
<para>
<example>
<title><function>jdtojewish</function> Example</title>
<title><function>jdtojewish</function> Exemplo</title>
<programlisting role="php">
<![CDATA[
<?php

10
reference/calendar/functions/jdtojulian.xml
View file

@ -1,22 +1,22 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.2 $ -->
<!-- $Revision: 1.3 $ -->
<!-- splitted from ./en/functions/calendar.xml, last change in rev 1.4 -->
<refentry id="function.jdtojulian">
<refnamediv>
<refname>JDToJulian</refname>
<refpurpose>
Converts a Julian Day Count to a Julian Calendar Date
Converte uma data do calendário "Julian Day Count" para o calendário "Julian"
</refpurpose>
</refnamediv>
<refsect1>
<title>Description</title>
<title>Descrição</title>
<methodsynopsis>
<type>string</type><methodname>jdtojulian</methodname>
<methodparam><type>int</type><parameter>julianday</parameter></methodparam>
</methodsynopsis>
<para>
Converts Julian Day Count to a string containing the Julian
Calendar Date in the format of "month/day/year".
Converte "Julian Day Count" para uma "string" contendo a data
do calendário "Julian" no formato "mês/dia/ano".
</para>
</refsect1>
</refentry>

20
reference/calendar/functions/jdtounix.xml
View file

@ -1,27 +1,27 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.3 $ -->
<!-- $Revision: 1.4 $ -->
<!-- splitted from ./en/functions/calendar.xml, last change in rev 1.3 -->
<refentry id="function.jdtounix">
<refnamediv>
<refname>jdtounix</refname>
<refpurpose>Convert Julian Day to UNIX timestamp</refpurpose>
<refpurpose>Converte do formato "Julain Day" para o formato de datas do sistema UNIX ("timestamp")</refpurpose>
</refnamediv>
<refsect1>
<title>Description</title>
<title>Descrição</title>
<methodsynopsis>
<type>int</type><methodname>jdtounix</methodname>
<methodparam><type>int</type><parameter>jday</parameter></methodparam>
</methodsynopsis>
<para>
This function will return a UNIX timestamp corresponding to the
Julian Day given in <parameter>jday</parameter> or &false; if
<parameter>jday</parameter> is not inside the UNIX epoch
(Gregorian years between 1970 and 2037 or 2440588 &lt;=
<parameter>jday</parameter> &lt;= 2465342 ). The time returned is
localtime (and not GMT).
Esta função irá retorna a data do sistema UNIX correspondente ao
"Julian Day" especificado no parâmetro <parameter>jday</parameter> ou &false;
se <parameter>jday</parameter> não está dentre a escala de datas UNIX
(Anos Gregorianos entre 1970 e 2037 ou 2440588 &lt;=
<parameter>jday</parameter> &lt;= 2465342). A hora retornada é a
hora local (e não a GMT).
</para>
<para>
See also <function>unixtojd</function>.
Veja também <function>unixtojd</function>.
</para>
</refsect1>
</refentry>

26
reference/calendar/functions/jewishtojd.xml
View file

@ -1,27 +1,31 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.2 $ -->
<!-- $Revision: 1.3 $ -->
<!-- splitted from ./en/functions/calendar.xml, last change in rev 1.4 -->
<!--
A.D -> anno dommini (depois de cristo) D.C
B.C -> before christ (antes de cristo) A.C
-->
<refentry id="function.jewishtojd">
<refnamediv>
<refname>JewishToJD</refname>
<refpurpose>
Converts a date in the Jewish Calendar to Julian Day Count
Converte uma data do calendário Judaico para o calendário "Julian Day Count".
</refpurpose>
</refnamediv>
<refsect1>
<title>Description</title>
<title>Descrição</title>
<methodsynopsis>
<type>int</type><methodname>jewishtojd</methodname>
<methodparam><type>int</type><parameter>month</parameter></methodparam>
<methodparam><type>int</type><parameter>day</parameter></methodparam>
<methodparam><type>int</type><parameter>year</parameter></methodparam>
<methodparam><type>int</type><parameter>mês</parameter></methodparam>
<methodparam><type>int</type><parameter>dia</parameter></methodparam>
<methodparam><type>int</type><parameter>ano</parameter></methodparam>
</methodsynopsis>
<para>
Although this function can handle dates all the way back to the year 1
(3761 B.C.), such use may not be meaningful. The Jewish calendar has
been in use for several thousand years, but in the early days there was
no formula to determine the start of a month. A new month was started
when the new moon was first observed.
Entretanto esta função suporta datas anteriores ao ano 1 (3761 A.C.),
porém tal uso não faz sentido. O calendário Judaico vem sendo usado por
centenas de anos, porém os primeiros dias não tem uma fórmula que
determina qual é o começo do mês. Um novo mês começa quando uma lua nova
é vista.
</para>
</refsect1>
</refentry>

36
reference/calendar/functions/juliantojd.xml
View file

@ -1,37 +1,41 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.3 $ -->
<!-- $Revision: 1.4 $ -->
<!-- splitted from ./en/functions/calendar.xml, last change in rev 1.4 -->
<!--
A.D -> anno dommini (depois de cristo) D.C
B.C -> before christ (antes de cristo) A.C
-->
<refentry id="function.juliantojd">
<refnamediv>
<refname>JulianToJD</refname>
<refpurpose>
Converts a Julian Calendar date to Julian Day Count
Converte datas no formato "Julian" para o formato "Julian Day Count"
</refpurpose>
</refnamediv>
<refsect1>
<title>Description</title>
<title>Descrição</title>
<methodsynopsis>
<type>int</type><methodname>juliantojd</methodname>
<methodparam><type>int</type><parameter>month</parameter></methodparam>
<methodparam><type>int</type><parameter>day</parameter></methodparam>
<methodparam><type>int</type><parameter>year</parameter></methodparam>
<methodparam><type>int</type><parameter>mês</parameter></methodparam>
<methodparam><type>int</type><parameter>dia</parameter></methodparam>
<methodparam><type>int</type><parameter>ano</parameter></methodparam>
</methodsynopsis>
<para>
Valid Range for Julian Calendar 4713 B.C. to 9999 A.D.
O Calendário "Julian" vai de 4713 A.C. até 9999 D.C.
</para>
<para>
Although this function can handle dates all the way back to 4713
B.C., such use may not be meaningful. The calendar was created in
46 B.C., but the details did not stabilize until at least 8 A.D.,
and perhaps as late at the 4th century. Also, the beginning of a
year varied from one culture to another - not all accepted
January as the first month.
Entretanto esta função trabalha com datas anteriores à 4713 A.C,
porém tal uso não faz muito sentido. O calendário foi criado em
46 A.C., mas os detalhes não foram padronizados até o ano 8 D.C.,
e talvez mais tarde no 4º século. Além disso, o começo do ano
variou de uma cultura para outra - nem todas aceitaram o Janeiro
como sendo o primeiro mês.
</para>
<caution>
<para>
Remember, the current calendar system being used worldwide is the
Gregorian calendar. <function>gregoriantojd</function> can be used to
convert such dates to their Julian Day count.
Lembre-se, o sistema atual de calendário que é usado mundialmente é
o Gregoriano. A função <function>gregoriantojd</function> pode ser
usada para converter datas no formato Gregoriano para o formato "Julian Day Count".
</para>
</caution>
</refsect1>

14
reference/calendar/functions/unixtojd.xml
View file

@ -1,24 +1,24 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.2 $ -->
<!-- $Revision: 1.3 $ -->
<!-- splitted from ./en/functions/calendar.xml, last change in rev 1.3 -->
<refentry id="function.unixtojd">
<refnamediv>
<refname>unixtojd</refname>
<refpurpose>Convert UNIX timestamp to Julian Day</refpurpose>
<refpurpose>Converte datas do sistema UNIX para o "Julian Day"</refpurpose>
</refnamediv>
<refsect1>
<title>Description</title>
<title>Descrição</title>
<methodsynopsis>
<type>int</type><methodname>unixtojd</methodname>
<methodparam choice="opt"><type>int</type><parameter>timestamp</parameter></methodparam>
</methodsynopsis>
<para>
Return the Julian Day for a UNIX <parameter>timestamp</parameter>
(seconds since 1.1.1970), or for the current day if no
<parameter>timestamp</parameter> is given.
Retorna o "Julian Day" para um UNIX <parameter>timestamp</parameter>
(segundos desde 1.1.1970), ou para o dia atual se nenhum
<parameter>timestamp</parameter> for especificado.
</para>
<para>
See also <function>jdtounix</function>.
Veja também <function>jdtounix</function>.
</para>
</refsect1>
</refentry>

29
reference/calendar/reference.xml
View file

@ -1,23 +1,24 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.5 $ -->
<!-- $Revision: 1.6 $ -->
<reference id="ref.calendar">
<title>Calendar functions</title>
<titleabbrev>Calendar</titleabbrev>
<title>Calendário, funções</title>
<titleabbrev>Calendário</titleabbrev>
<partintro>
<section id="calendar.intro">
&reftitle.intro;
<para>
The calendar extension presents a series of functions to simplify
converting between different calendar formats. The intermediary or
standard it is based on is the Julian Day Count. The Julian Day Count is
a count of days starting from January 1st, 4713 B.C. To convert between
calendar systems, you must first convert to Julian Day Count, then to the
calendar system of your choice. Julian Day Count is very different from
the Julian Calendar! For more information on Julian Day Count, visit
<ulink url="&url.calendar.jd;">&url.calendar.jd;</ulink>. For more
information on calendar systems visit <ulink
url="&url.calendar;">&url.calendar;</ulink>. Excerpts from this page are
included in these instructions, and are in quotes.
A extensão de calendário contém uma série de funções para simplificar
a conversão de diferentes formatos de calendários. O calendário padrão
é baseado no formato "Julian Day Count". A contagem de dias do calendário
"Julian Day Count" começa em 1º de Janeiro de 4713 B.C. Para converter
um calendário para algum formato, você deve primeiro convertê-lo para o
formato "Julian Day Count", então converter para o sistema de calendário
de sua escolha. O formato de calendário "Julian Day Count" é muito diferente
do "Julian Calendar"! Para mais informações sobre o calendário "Julian Day Count",
visite <ulink url="&url.calendar.jd;">&url.calendar.jd;</ulink>. Para mais informações
sobre sistemas de calendários, visite: <ulink
url="&url.calendar;">&url.calendar;</ulink>. "Excerpts from this page are
included in these instructions, and are in quotes".
</para>
</section>