From 80b0f805186d1a439b6bb489d0c27b04a678ccb1 Mon Sep 17 00:00:00 2001
From: Fernando Wobeto <fernandowobeto@gmail.com>
Date: Tue, 5 Nov 2024 13:18:05 -0300
Subject: [PATCH 1/3] =?UTF-8?q?inclus=C3=A3o=20dos=20arquivos=20originais?=
 =?UTF-8?q?=20com=20revis=C3=A3o=20atualizada?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 reference/ev/evperiodic/again.xml         |  59 +++++++
 reference/ev/evperiodic/at.xml            |  57 ++++++
 reference/ev/evperiodic/construct.xml     | 204 ++++++++++++++++++++++
 reference/ev/evperiodic/createstopped.xml | 159 +++++++++++++++++
 reference/ev/evperiodic/set.xml           |  84 +++++++++
 5 files changed, 563 insertions(+)
 create mode 100644 reference/ev/evperiodic/again.xml
 create mode 100644 reference/ev/evperiodic/at.xml
 create mode 100644 reference/ev/evperiodic/construct.xml
 create mode 100644 reference/ev/evperiodic/createstopped.xml
 create mode 100644 reference/ev/evperiodic/set.xml

diff --git a/reference/ev/evperiodic/again.xml b/reference/ev/evperiodic/again.xml
new file mode 100644
index 000000000..6bd291507
--- /dev/null
+++ b/reference/ev/evperiodic/again.xml
@@ -0,0 +1,59 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- EN-Revision: dd07341fae2c414adc1f700be0890ff32e8daab4 Maintainer: fernandowobeto Status: ready --><!-- CREDITS: fernandowobeto -->
+<refentry xml:id="evperiodic.again" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
+ <refnamediv>
+  <refname>EvPeriodic::again</refname>
+  <refpurpose>Simply stops and restarts the periodic watcher again</refpurpose>
+ </refnamediv>
+ <refsect1 role="description">
+  &reftitle.description;
+  <methodsynopsis>
+   <modifier>public</modifier>
+   <type>void</type>
+   <methodname>EvPeriodic::again</methodname>
+   <void />
+  </methodsynopsis>
+  <para>
+   Simply stops and restarts the periodic watcher again. This is only useful
+   when attributes are changed.
+  </para>
+ </refsect1>
+ <refsect1 role="parameters">
+  &reftitle.parameters;
+  &no.function.parameters;
+ </refsect1>
+ <refsect1 role="returnvalues">
+  &reftitle.returnvalues;
+  <para>
+   &return.void;
+  </para>
+ </refsect1>
+ <refsect1 role="seealso">
+  &reftitle.seealso;
+  <simplelist>
+   <member>
+    <methodname>EvTimer::again</methodname>
+   </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/ev/evperiodic/at.xml b/reference/ev/evperiodic/at.xml
new file mode 100644
index 000000000..67e6c7541
--- /dev/null
+++ b/reference/ev/evperiodic/at.xml
@@ -0,0 +1,57 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- EN-Revision: 508869e1df6458162c162d71669f5e81abd65d50 Maintainer: fernandowobeto Status: ready --><!-- CREDITS: fernandowobeto -->
+<refentry xml:id="evperiodic.at" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
+ <refnamediv>
+  <refname>EvPeriodic::at</refname>
+  <refpurpose>Returns the absolute time that this
+  watcher is supposed to trigger next</refpurpose>
+ </refnamediv>
+ <refsect1 role="description">
+  &reftitle.description;
+  <methodsynopsis>
+   <modifier>public</modifier>
+   <type>float</type>
+   <methodname>EvPeriodic::at</methodname>
+   <void />
+  </methodsynopsis>
+  <para>
+   When the watcher is active, returns the absolute time that this watcher is
+   supposed to trigger next. This is not the same as the offset argument to
+   <methodname>EvPeriodic::set</methodname>
+   or
+   <methodname>EvPeriodic::__construct</methodname>
+   , but indeed works even in interval mode.
+  </para>
+ </refsect1>
+ <refsect1 role="parameters">
+  &reftitle.parameters;
+  &no.function.parameters;
+ </refsect1>
+ <refsect1 role="returnvalues">
+  &reftitle.returnvalues;
+  <para>
+   Returns the absolute time this watcher is supposed to trigger next in
+   seconds.
+  </para>
+ </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/ev/evperiodic/construct.xml b/reference/ev/evperiodic/construct.xml
new file mode 100644
index 000000000..1c5631e67
--- /dev/null
+++ b/reference/ev/evperiodic/construct.xml
@@ -0,0 +1,204 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- EN-Revision: 33e5f4ef7243bc1282acb1cba93e8f99c1debe68 Maintainer: fernandowobeto Status: ready --><!-- CREDITS: fernandowobeto -->
+<refentry xml:id="evperiodic.construct" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
+ <refnamediv>
+  <refname>EvPeriodic::__construct</refname>
+  <refpurpose>Constructs EvPeriodic watcher object</refpurpose>
+ </refnamediv>
+ <refsect1 role="description">
+  &reftitle.description;
+  <constructorsynopsis>
+   <modifier>public</modifier>
+   <methodname>EvPeriodic::__construct</methodname>
+   <methodparam>
+    <type>float</type>
+    <parameter>offset</parameter>
+   </methodparam>
+   <methodparam>
+    <type>string</type>
+    <parameter>interval</parameter>
+   </methodparam>
+   <methodparam>
+    <type>callable</type>
+    <parameter>reschedule_cb</parameter>
+   </methodparam>
+   <methodparam>
+    <type>callable</type>
+    <parameter>callback</parameter>
+   </methodparam>
+   <methodparam
+   choice="opt">
+    <type>mixed</type>
+    <parameter>data</parameter>
+    <initializer>&null;</initializer>
+   </methodparam>
+   <methodparam
+   choice="opt">
+    <type>int</type>
+    <parameter>priority</parameter>
+    <initializer>0</initializer>
+   </methodparam>
+  </constructorsynopsis>
+  <para>
+   Constructs EvPeriodic watcher object and starts it automatically.
+   <methodname>EvPeriodic::createStopped</methodname>
+   method creates stopped periodic watcher.
+  </para>
+ </refsect1>
+ <refsect1 role="parameters">
+  &reftitle.parameters;
+  <variablelist>
+   <varlistentry>
+    <term>
+     <parameter>offset</parameter>
+    </term>
+    <listitem>
+     <para>
+      See
+      <link linkend="ev.periodic-modes">Periodic watcher operation modes</link>
+     </para>
+    </listitem>
+   </varlistentry>
+   <varlistentry>
+    <term>
+     <parameter>interval</parameter>
+    </term>
+    <listitem>
+     <para>
+      See
+      <link linkend="ev.periodic-modes">Periodic watcher operation modes</link>
+     </para>
+    </listitem>
+   </varlistentry>
+   <varlistentry>
+    <term>
+     <parameter>reschedule_cb</parameter>
+    </term>
+    <listitem>
+     <para>
+      Reschedule callback. You can pass &null;. See
+      <link linkend="ev.periodic-modes">Periodic watcher operation
+     modes</link>
+     </para>
+    </listitem>
+   </varlistentry>
+   <varlistentry>
+    <term>
+     <parameter>callback</parameter>
+    </term>
+    <listitem>
+     <para>
+      See
+      <link linkend="ev.watcher-callbacks">Watcher callbacks</link>
+      .
+     </para>
+    </listitem>
+   </varlistentry>
+   <varlistentry>
+    <term>
+     <parameter>data</parameter>
+    </term>
+    <listitem>
+     <para>
+      Custom data associated with the watcher.
+     </para>
+    </listitem>
+   </varlistentry>
+   <varlistentry>
+    <term>
+     <parameter>priority</parameter>
+    </term>
+    <listitem>
+     <para>
+      <link linkend="ev.constants.watcher-pri">Watcher priority</link>
+     </para>
+    </listitem>
+   </varlistentry>
+  </variablelist>
+ </refsect1>
+
+ <refsect1 role="examples">
+  &reftitle.examples;
+
+ <example>
+   <title>Periodic timer. Use reschedule callback</title>
+   <programlisting role="php">
+<![CDATA[
+<?php
+// Tick each 10.5 seconds
+
+function reschedule_cb ($watcher, $now) {
+ return $now + (10.5. - fmod($now, 10.5));
+}
+
+$w = new EvPeriodic(0., 0., "reschedule_cb", function ($w, $revents) {
+ echo time(), PHP_EOL;
+});
+Ev::run();
+?>
+
+]]>
+   </programlisting>
+  </example>
+  <example>
+   <title>Periodic timer. Tick every 10.5 seconds starting at now</title>
+   <programlisting role="php">
+<![CDATA[
+<?php
+// Tick every 10.5 seconds starting at now
+$w = new EvPeriodic(fmod(Ev::now(), 10.5), 10.5, NULL, function ($w, $revents) {
+ echo time(), PHP_EOL;
+});
+Ev::run();
+?>
+]]>
+   </programlisting>
+  </example>
+  <example>
+   <title>Hourly watcher</title>
+   <programlisting role="php">
+<![CDATA[
+<?php
+$hourly = EvPeriodic(0, 3600, NULL, function () {
+ echo "once per hour\n";
+});
+?>
+]]>
+   </programlisting>
+  </example>
+ </refsect1>
+ <refsect1 role="seealso">
+  &reftitle.seealso;
+  <simplelist>
+   <member>
+    <link linkend="ev.periodic-modes">Periodic watcher operation modes</link>
+   </member>
+   <member>
+    <classname>EvTimer</classname>
+   </member>
+   <member>
+    <methodname>EvPeriodic::createStopped</methodname>
+   </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/ev/evperiodic/createstopped.xml b/reference/ev/evperiodic/createstopped.xml
new file mode 100644
index 000000000..77f317b7d
--- /dev/null
+++ b/reference/ev/evperiodic/createstopped.xml
@@ -0,0 +1,159 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- EN-Revision: 508869e1df6458162c162d71669f5e81abd65d50 Maintainer: fernandowobeto Status: ready --><!-- CREDITS: fernandowobeto -->
+<refentry xml:id="evperiodic.createstopped" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
+ <refnamediv>
+  <refname>EvPeriodic::createStopped</refname>
+  <refpurpose>Create a stopped EvPeriodic watcher</refpurpose>
+ </refnamediv>
+ <refsect1 role="description">
+  &reftitle.description;
+  <methodsynopsis>
+   <modifier>final</modifier>
+   <modifier>public</modifier>
+   <modifier>static</modifier>
+   <type>EvPeriodic</type>
+   <methodname>EvPeriodic::createStopped</methodname>
+   <methodparam>
+    <type>float</type>
+    <parameter>offset</parameter>
+   </methodparam>
+   <methodparam>
+    <type>float</type>
+    <parameter>interval</parameter>
+   </methodparam>
+   <methodparam>
+    <type>callable</type>
+    <parameter>reschedule_cb</parameter>
+   </methodparam>
+   <methodparam>
+    <type>callable</type>
+    <parameter>callback</parameter>
+   </methodparam>
+   <methodparam
+   choice="opt">
+    <type>mixed</type>
+    <parameter>data</parameter>
+    <initializer>&null;</initializer>
+   </methodparam>
+   <methodparam
+   choice="opt">
+    <type>int</type>
+    <parameter>priority</parameter>
+    <initializer>0</initializer>
+   </methodparam>
+  </methodsynopsis>
+  <para>
+   Create EvPeriodic object. Unlike
+   <methodname>EvPeriodic::__construct</methodname>
+   this method doesn&apos;t start the watcher automatically.
+  </para>
+ </refsect1>
+ <refsect1 role="parameters">
+  &reftitle.parameters;
+  <variablelist>
+   <varlistentry>
+    <term>
+     <parameter>offset</parameter>
+    </term>
+    <listitem>
+     <para>
+      See
+      <link linkend="ev.periodic-modes">Periodic watcher operation modes</link>
+     </para>
+    </listitem>
+   </varlistentry>
+   <varlistentry>
+    <term>
+     <parameter>interval</parameter>
+    </term>
+    <listitem>
+     <para>
+      See
+      <link linkend="ev.periodic-modes">Periodic watcher operation modes</link>
+     </para>
+    </listitem>
+   </varlistentry>
+   <varlistentry>
+    <term>
+     <parameter>reschedule_cb</parameter>
+    </term>
+    <listitem>
+     <para>
+      Reschedule callback. You can pass &null;. See
+      <link linkend="ev.periodic-modes">Periodic watcher operation
+     modes</link>
+     </para>
+    </listitem>
+   </varlistentry>
+   <varlistentry>
+    <term>
+     <parameter>callback</parameter>
+    </term>
+    <listitem>
+     <para>
+      See
+      <link linkend="ev.watcher-callbacks">Watcher callbacks</link>
+      .
+     </para>
+    </listitem>
+   </varlistentry>
+   <varlistentry>
+    <term>
+     <parameter>data</parameter>
+    </term>
+    <listitem>
+     <para>
+      Custom data associated with the watcher.
+     </para>
+    </listitem>
+   </varlistentry>
+   <varlistentry>
+    <term>
+     <parameter>priority</parameter>
+    </term>
+    <listitem>
+     <para>
+      <link linkend="ev.constants.watcher-pri">Watcher priority</link>
+     </para>
+    </listitem>
+   </varlistentry>
+  </variablelist>
+ </refsect1>
+ <refsect1 role="returnvalues">
+  &reftitle.returnvalues;
+  <para>
+   Returns EvPeriodic watcher object on success.
+  </para>
+ </refsect1>
+ <refsect1 role="seealso">
+  &reftitle.seealso;
+  <simplelist>
+   <member>
+    <methodname>EvPeriodic::__construct</methodname>
+   </member>
+   <member>
+    <methodname>EvTimer::createStopped</methodname>
+   </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/ev/evperiodic/set.xml b/reference/ev/evperiodic/set.xml
new file mode 100644
index 000000000..ca91fea4d
--- /dev/null
+++ b/reference/ev/evperiodic/set.xml
@@ -0,0 +1,84 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- EN-Revision: 508869e1df6458162c162d71669f5e81abd65d50 Maintainer: fernandowobeto Status: ready --><!-- CREDITS: fernandowobeto -->
+<refentry xml:id="evperiodic.set" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
+ <refnamediv>
+  <refname>EvPeriodic::set</refname>
+  <refpurpose>Configures the watcher</refpurpose>
+ </refnamediv>
+ <refsect1 role="description">
+  &reftitle.description;
+  <methodsynopsis>
+   <modifier>public</modifier>
+   <type>void</type>
+   <methodname>EvPeriodic::set</methodname>
+   <methodparam>
+    <type>float</type>
+    <parameter>offset</parameter>
+   </methodparam>
+   <methodparam>
+    <type>float</type>
+    <parameter>interval</parameter>
+   </methodparam>
+  </methodsynopsis>
+  <para>
+   (Re-)Configures EvPeriodic watcher
+  </para>
+ </refsect1>
+ <refsect1 role="parameters">
+  &reftitle.parameters;
+  <variablelist>
+   <varlistentry>
+    <term>
+     <parameter>offset</parameter>
+    </term>
+    <listitem>
+     <para>
+      The same meaning as for
+      <methodname>EvPeriodic::__construct</methodname>
+      . See
+      <link linkend="ev.periodic-modes">Periodic watcher operation modes</link>
+     </para>
+    </listitem>
+   </varlistentry>
+   <varlistentry>
+    <term>
+     <parameter>interval</parameter>
+    </term>
+    <listitem>
+     <para>
+      The same meaning as for
+      <methodname>EvPeriodic::__construct</methodname>
+      . See
+      <link linkend="ev.periodic-modes">Periodic watcher operation modes</link>
+     </para>
+    </listitem>
+   </varlistentry>
+  </variablelist>
+ </refsect1>
+ <refsect1 role="returnvalues">
+  &reftitle.returnvalues;
+  <para>
+   &return.void;
+  </para>
+ </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
+-->

From 8dd3bedd6c527a2cdc508951c6fb676df9cd2223 Mon Sep 17 00:00:00 2001
From: Fernando Wobeto <fernandowobeto@gmail.com>
Date: Tue, 12 Nov 2024 15:19:33 -0300
Subject: [PATCH 2/3] =?UTF-8?q?tradu=C3=A7=C3=A3o=20em=20reference/ev/evpe?=
 =?UTF-8?q?riodic?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 reference/ev/evperiodic/again.xml         |  6 ++--
 reference/ev/evperiodic/at.xml            | 18 +++++-----
 reference/ev/evperiodic/construct.xml     | 44 +++++++++++------------
 reference/ev/evperiodic/createstopped.xml | 32 ++++++++---------
 reference/ev/evperiodic/set.xml           | 16 ++++-----
 5 files changed, 58 insertions(+), 58 deletions(-)

diff --git a/reference/ev/evperiodic/again.xml b/reference/ev/evperiodic/again.xml
index 6bd291507..7f553030c 100644
--- a/reference/ev/evperiodic/again.xml
+++ b/reference/ev/evperiodic/again.xml
@@ -3,7 +3,7 @@
 <refentry xml:id="evperiodic.again" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
   <refname>EvPeriodic::again</refname>
-  <refpurpose>Simply stops and restarts the periodic watcher again</refpurpose>
+  <refpurpose>Simplesmente para e reinicia o observador periódico novamente</refpurpose>
  </refnamediv>
  <refsect1 role="description">
   &reftitle.description;
@@ -14,8 +14,8 @@
    <void />
   </methodsynopsis>
   <para>
-   Simply stops and restarts the periodic watcher again. This is only useful
-   when attributes are changed.
+   Simplesmente para e reinicia o observador periódico novamente. Isso só é útil
+   quando os atributos são alterados.
   </para>
  </refsect1>
  <refsect1 role="parameters">
diff --git a/reference/ev/evperiodic/at.xml b/reference/ev/evperiodic/at.xml
index 67e6c7541..09c67de4a 100644
--- a/reference/ev/evperiodic/at.xml
+++ b/reference/ev/evperiodic/at.xml
@@ -3,8 +3,8 @@
 <refentry xml:id="evperiodic.at" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
   <refname>EvPeriodic::at</refname>
-  <refpurpose>Returns the absolute time that this
-  watcher is supposed to trigger next</refpurpose>
+  <refpurpose>Retorna o tempo absoluto em que este observador
+  deve disparar em seguida</refpurpose>
  </refnamediv>
  <refsect1 role="description">
   &reftitle.description;
@@ -15,12 +15,12 @@
    <void />
   </methodsynopsis>
   <para>
-   When the watcher is active, returns the absolute time that this watcher is
-   supposed to trigger next. This is not the same as the offset argument to
+   Quando o observador está ativo, retorna o tempo absoluto em que este observador
+   deve disparar em seguida. Isso não é o mesmo que o argumento offset para
    <methodname>EvPeriodic::set</methodname>
-   or
-   <methodname>EvPeriodic::__construct</methodname>
-   , but indeed works even in interval mode.
+   ou
+   <methodname>EvPeriodic::__construct</methodname>,
+   mas funciona mesmo no modo de intervalo.
   </para>
  </refsect1>
  <refsect1 role="parameters">
@@ -30,8 +30,8 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   Returns the absolute time this watcher is supposed to trigger next in
-   seconds.
+   Retorna o tempo absoluto que este observador deve disparar em seguida em
+   segundos.
   </para>
  </refsect1>
 </refentry>
diff --git a/reference/ev/evperiodic/construct.xml b/reference/ev/evperiodic/construct.xml
index 1c5631e67..e8bcec3dc 100644
--- a/reference/ev/evperiodic/construct.xml
+++ b/reference/ev/evperiodic/construct.xml
@@ -3,7 +3,7 @@
 <refentry xml:id="evperiodic.construct" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
   <refname>EvPeriodic::__construct</refname>
-  <refpurpose>Constructs EvPeriodic watcher object</refpurpose>
+  <refpurpose>Constrói objeto observador EvPeriodic</refpurpose>
  </refnamediv>
  <refsect1 role="description">
   &reftitle.description;
@@ -40,9 +40,9 @@
    </methodparam>
   </constructorsynopsis>
   <para>
-   Constructs EvPeriodic watcher object and starts it automatically.
-   <methodname>EvPeriodic::createStopped</methodname>
-   method creates stopped periodic watcher.
+   Constrói o objeto observador EvPeriodic e o inicia automaticamente.
+   O método <methodname>EvPeriodic::createStopped</methodname>
+   cria o observador periódico parado.
   </para>
  </refsect1>
  <refsect1 role="parameters">
@@ -54,8 +54,8 @@
     </term>
     <listitem>
      <para>
-      See
-      <link linkend="ev.periodic-modes">Periodic watcher operation modes</link>
+      Veja
+      <link linkend="ev.periodic-modes">Modos de operação do observador periódico</link>
      </para>
     </listitem>
    </varlistentry>
@@ -65,8 +65,8 @@
     </term>
     <listitem>
      <para>
-      See
-      <link linkend="ev.periodic-modes">Periodic watcher operation modes</link>
+      Veja
+      <link linkend="ev.periodic-modes">Modos de operação do observador periódico</link>
      </para>
     </listitem>
    </varlistentry>
@@ -76,9 +76,9 @@
     </term>
     <listitem>
      <para>
-      Reschedule callback. You can pass &null;. See
-      <link linkend="ev.periodic-modes">Periodic watcher operation
-     modes</link>
+      Reprograma retorno de chamada. Você pode passar &null;. Veja
+      <link linkend="ev.periodic-modes">Modos de operação do observador
+      periódico</link>
      </para>
     </listitem>
    </varlistentry>
@@ -88,8 +88,8 @@
     </term>
     <listitem>
      <para>
-      See
-      <link linkend="ev.watcher-callbacks">Watcher callbacks</link>
+      Veja
+      <link linkend="ev.watcher-callbacks">Retornos de chamada do observador</link>
       .
      </para>
     </listitem>
@@ -100,7 +100,7 @@
     </term>
     <listitem>
      <para>
-      Custom data associated with the watcher.
+      Dados personalizados associados ao observador.
      </para>
     </listitem>
    </varlistentry>
@@ -110,7 +110,7 @@
     </term>
     <listitem>
      <para>
-      <link linkend="ev.constants.watcher-pri">Watcher priority</link>
+      <link linkend="ev.constants.watcher-pri">Prioridade do observador</link>
      </para>
     </listitem>
    </varlistentry>
@@ -121,11 +121,11 @@
   &reftitle.examples;
 
  <example>
-   <title>Periodic timer. Use reschedule callback</title>
+   <title>Temporizador periódico. Usar retorno de chamada de reagendamento</title>
    <programlisting role="php">
 <![CDATA[
 <?php
-// Tick each 10.5 seconds
+// Marca a cada 10,5 segundos
 
 function reschedule_cb ($watcher, $now) {
  return $now + (10.5. - fmod($now, 10.5));
@@ -141,11 +141,11 @@ Ev::run();
    </programlisting>
   </example>
   <example>
-   <title>Periodic timer. Tick every 10.5 seconds starting at now</title>
+   <title>Temporizador periódico. Marca a cada 10,5 segundos a partir de agora</title>
    <programlisting role="php">
 <![CDATA[
 <?php
-// Tick every 10.5 seconds starting at now
+// Marca a cada 10,5 segundos a partir de agora
 $w = new EvPeriodic(fmod(Ev::now(), 10.5), 10.5, NULL, function ($w, $revents) {
  echo time(), PHP_EOL;
 });
@@ -155,12 +155,12 @@ Ev::run();
    </programlisting>
   </example>
   <example>
-   <title>Hourly watcher</title>
+   <title>Observador de hora em hora</title>
    <programlisting role="php">
 <![CDATA[
 <?php
 $hourly = EvPeriodic(0, 3600, NULL, function () {
- echo "once per hour\n";
+ echo "uma vez por hora\n";
 });
 ?>
 ]]>
@@ -171,7 +171,7 @@ $hourly = EvPeriodic(0, 3600, NULL, function () {
   &reftitle.seealso;
   <simplelist>
    <member>
-    <link linkend="ev.periodic-modes">Periodic watcher operation modes</link>
+    <link linkend="ev.periodic-modes">Modos de operação do observador periódico</link>
    </member>
    <member>
     <classname>EvTimer</classname>
diff --git a/reference/ev/evperiodic/createstopped.xml b/reference/ev/evperiodic/createstopped.xml
index 77f317b7d..ba34e198a 100644
--- a/reference/ev/evperiodic/createstopped.xml
+++ b/reference/ev/evperiodic/createstopped.xml
@@ -3,7 +3,7 @@
 <refentry xml:id="evperiodic.createstopped" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
   <refname>EvPeriodic::createStopped</refname>
-  <refpurpose>Create a stopped EvPeriodic watcher</refpurpose>
+  <refpurpose>Criar um observador EvPeriodic parado</refpurpose>
  </refnamediv>
  <refsect1 role="description">
   &reftitle.description;
@@ -43,9 +43,9 @@
    </methodparam>
   </methodsynopsis>
   <para>
-   Create EvPeriodic object. Unlike
-   <methodname>EvPeriodic::__construct</methodname>
-   this method doesn&apos;t start the watcher automatically.
+   Cria um objeto EvPeriodic. Ao contrário de
+   <methodname>EvPeriodic::__construct</methodname>,
+   este método não inicia o observador automaticamente.
   </para>
  </refsect1>
  <refsect1 role="parameters">
@@ -57,8 +57,8 @@
     </term>
     <listitem>
      <para>
-      See
-      <link linkend="ev.periodic-modes">Periodic watcher operation modes</link>
+      Veja
+      <link linkend="ev.periodic-modes">Modos de operação do observador periódico</link>
      </para>
     </listitem>
    </varlistentry>
@@ -68,8 +68,8 @@
     </term>
     <listitem>
      <para>
-      See
-      <link linkend="ev.periodic-modes">Periodic watcher operation modes</link>
+      Veja
+      <link linkend="ev.periodic-modes">Modos de operação do observador periódico</link>
      </para>
     </listitem>
    </varlistentry>
@@ -79,9 +79,9 @@
     </term>
     <listitem>
      <para>
-      Reschedule callback. You can pass &null;. See
-      <link linkend="ev.periodic-modes">Periodic watcher operation
-     modes</link>
+      Reprogramaa retorno de chamada. Você pode passar &null;. Veja
+      <link linkend="ev.periodic-modes">Modos de operação do observador
+      periódico</link>
      </para>
     </listitem>
    </varlistentry>
@@ -91,8 +91,8 @@
     </term>
     <listitem>
      <para>
-      See
-      <link linkend="ev.watcher-callbacks">Watcher callbacks</link>
+      Veja
+      <link linkend="ev.watcher-callbacks">Retornos de chamada do observador</link>
       .
      </para>
     </listitem>
@@ -103,7 +103,7 @@
     </term>
     <listitem>
      <para>
-      Custom data associated with the watcher.
+      Dados personalizados associados ao observador.
      </para>
     </listitem>
    </varlistentry>
@@ -113,7 +113,7 @@
     </term>
     <listitem>
      <para>
-      <link linkend="ev.constants.watcher-pri">Watcher priority</link>
+      <link linkend="ev.constants.watcher-pri">Prioridade do observador</link>
      </para>
     </listitem>
    </varlistentry>
@@ -122,7 +122,7 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   Returns EvPeriodic watcher object on success.
+   Retorna o objeto observador EvPeriodic em caso de sucesso.
   </para>
  </refsect1>
  <refsect1 role="seealso">
diff --git a/reference/ev/evperiodic/set.xml b/reference/ev/evperiodic/set.xml
index ca91fea4d..80bd3c403 100644
--- a/reference/ev/evperiodic/set.xml
+++ b/reference/ev/evperiodic/set.xml
@@ -3,7 +3,7 @@
 <refentry xml:id="evperiodic.set" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
   <refname>EvPeriodic::set</refname>
-  <refpurpose>Configures the watcher</refpurpose>
+  <refpurpose>Configura o observador</refpurpose>
  </refnamediv>
  <refsect1 role="description">
   &reftitle.description;
@@ -21,7 +21,7 @@
    </methodparam>
   </methodsynopsis>
   <para>
-   (Re-)Configures EvPeriodic watcher
+   (Re-)Configura o observador EvPeriodic
   </para>
  </refsect1>
  <refsect1 role="parameters">
@@ -33,10 +33,10 @@
     </term>
     <listitem>
      <para>
-      The same meaning as for
+      O mesmo significado que para
       <methodname>EvPeriodic::__construct</methodname>
-      . See
-      <link linkend="ev.periodic-modes">Periodic watcher operation modes</link>
+      . Veja
+      <link linkend="ev.periodic-modes">Modos de operação do observador periódico</link>
      </para>
     </listitem>
    </varlistentry>
@@ -46,10 +46,10 @@
     </term>
     <listitem>
      <para>
-      The same meaning as for
+      O mesmo significado que para
       <methodname>EvPeriodic::__construct</methodname>
-      . See
-      <link linkend="ev.periodic-modes">Periodic watcher operation modes</link>
+      . Veja
+      <link linkend="ev.periodic-modes">Modos de operação do observador periódico</link>
      </para>
     </listitem>
    </varlistentry>

From c2fe2b7bed7f27f73448716e44fe66a48ebd80a7 Mon Sep 17 00:00:00 2001
From: Leonardo Lara Rodrigues <leonardo.lara.rodrigues@gmail.com>
Date: Sat, 16 Nov 2024 15:14:13 -0300
Subject: [PATCH 3/3] Update createstopped.xml

---
 reference/ev/evperiodic/createstopped.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/reference/ev/evperiodic/createstopped.xml b/reference/ev/evperiodic/createstopped.xml
index ba34e198a..ad97ea6fe 100644
--- a/reference/ev/evperiodic/createstopped.xml
+++ b/reference/ev/evperiodic/createstopped.xml
@@ -3,7 +3,7 @@
 <refentry xml:id="evperiodic.createstopped" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
   <refname>EvPeriodic::createStopped</refname>
-  <refpurpose>Criar um observador EvPeriodic parado</refpurpose>
+  <refpurpose>Cria um observador EvPeriodic parado</refpurpose>
  </refnamediv>
  <refsect1 role="description">
   &reftitle.description;