From 87c1e47c25ebdc1ce22828a83f4f3cf76f2d4ee7 Mon Sep 17 00:00:00 2001
From: leonardolara <leonardo.lara.rodrigues@gmail.com>
Date: Fri, 11 Oct 2024 16:59:07 -0300
Subject: [PATCH] initial translation in reference/yac

---
 reference/yac/book.xml          |  42 ++++++++
 reference/yac/configure.xml     |  35 +++++++
 reference/yac/constants.xml     | 128 ++++++++++++++++++++++++
 reference/yac/ini.xml           | 172 ++++++++++++++++++++++++++++++++
 reference/yac/setup.xml         |  62 ++++++++++++
 reference/yac/yac.xml           |  90 +++++++++++++++++
 reference/yac/yac/add.xml       | 100 +++++++++++++++++++
 reference/yac/yac/construct.xml |  77 ++++++++++++++
 reference/yac/yac/delete.xml    |  73 ++++++++++++++
 reference/yac/yac/dump.xml      |  64 ++++++++++++
 reference/yac/yac/flush.xml     |  55 ++++++++++
 reference/yac/yac/get.xml       |  73 ++++++++++++++
 reference/yac/yac/getter.xml    |  64 ++++++++++++
 reference/yac/yac/info.xml      |  57 +++++++++++
 reference/yac/yac/set.xml       |  85 ++++++++++++++++
 reference/yac/yac/setter.xml    |  72 +++++++++++++
 16 files changed, 1249 insertions(+)
 create mode 100644 reference/yac/book.xml
 create mode 100644 reference/yac/configure.xml
 create mode 100644 reference/yac/constants.xml
 create mode 100644 reference/yac/ini.xml
 create mode 100644 reference/yac/setup.xml
 create mode 100644 reference/yac/yac.xml
 create mode 100644 reference/yac/yac/add.xml
 create mode 100644 reference/yac/yac/construct.xml
 create mode 100644 reference/yac/yac/delete.xml
 create mode 100644 reference/yac/yac/dump.xml
 create mode 100644 reference/yac/yac/flush.xml
 create mode 100644 reference/yac/yac/get.xml
 create mode 100644 reference/yac/yac/getter.xml
 create mode 100644 reference/yac/yac/info.xml
 create mode 100644 reference/yac/yac/set.xml
 create mode 100644 reference/yac/yac/setter.xml

diff --git a/reference/yac/book.xml b/reference/yac/book.xml
new file mode 100644
index 000000000..f05954164
--- /dev/null
+++ b/reference/yac/book.xml
@@ -0,0 +1,42 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- EN-Revision: 68c2c871505aadf983f16113c5b077b335ce8d76 Maintainer: leonardolara Status: ready -->
+
+<book xml:id="book.yac" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
+ <?phpdoc extension-membership="pecl" ?>
+ <title>Yac</title>
+ <titleabbrev>Yac</titleabbrev>
+
+ <preface xml:id="intro.yac">
+  &reftitle.intro;
+  <para>
+   Yac (Yet Another cache), é um cache de dados do usuário de memória compartilhada e sem bloqueio, que pode ser usado para substituir o APC ou o memcache local.
+  </para>
+ </preface>
+
+ &reference.yac.setup;
+ &reference.yac.constants;
+ <!-- &reference.yac.examples; -->
+ &reference.yac.yac;
+
+</book>
+
+<!-- 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/yac/configure.xml b/reference/yac/configure.xml
new file mode 100644
index 000000000..5172b439e
--- /dev/null
+++ b/reference/yac/configure.xml
@@ -0,0 +1,35 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- EN-Revision: b8be4b126c545a0b452be29b6b5ce185471814a1 Maintainer: leonardolara Status: ready -->
+
+<section xml:id="yac.installation" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
+ &reftitle.install;
+
+ <para>
+  &pecl.info;
+  <link xlink:href="&url.pecl.package;yac">&url.pecl.package;yac</link>
+ </para>
+
+
+</section>
+
+
+<!-- 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/yac/constants.xml b/reference/yac/constants.xml
new file mode 100644
index 000000000..7c9a8d1c6
--- /dev/null
+++ b/reference/yac/constants.xml
@@ -0,0 +1,128 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- EN-Revision: 86e6094e86b84a51d00ab217ac50ce8dde33d82a Maintainer: leonardolara Status: ready -->
+
+<appendix xml:id="yac.constants" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
+ &reftitle.constants;
+ &extension.constants;
+ <para>
+  <variablelist>
+   <varlistentry xml:id="constant.yac-version">
+    <term>
+     <constant>YAC_VERSION</constant>
+     (<type>string</type>)
+    </term>
+    <listitem>
+     <simpara>
+     </simpara>
+    </listitem>
+   </varlistentry>
+   <varlistentry xml:id="constant.yac-max-key-len">
+    <term>
+     <constant>YAC_MAX_KEY_LEN</constant>
+     (<type>int</type>)
+    </term>
+    <listitem>
+     <simpara>
+      O comprimento máximo de uma chave, 48 bytes.
+     </simpara>
+    </listitem>
+   </varlistentry>
+   <varlistentry xml:id="constant.yac-max-value-raw-len">
+    <term>
+     <constant>YAC_MAX_VALUE_RAW_LEN</constant>
+     (<type>int</type>)
+    </term>
+    <listitem>
+     <simpara>
+     </simpara>
+    </listitem>
+   </varlistentry>
+   <varlistentry xml:id="constant.yac-max-raw-compressed-len">
+    <term>
+     <constant>YAC_MAX_RAW_COMPRESSED_LEN</constant>
+     (<type>int</type>)
+    </term>
+    <listitem>
+     <simpara>
+     </simpara>
+    </listitem>
+   </varlistentry>
+   <varlistentry xml:id="constant.yac-serializer-php">
+    <term>
+     <constant>YAC_SERIALIZER_PHP</constant>
+     (<type>int</type>)
+    </term>
+    <listitem>
+     <simpara>
+      Usa o serializador do PHP "serialize".
+     </simpara>
+    </listitem>
+   </varlistentry>
+   <varlistentry xml:id="constant.yac-serializer-json">
+    <term>
+     <constant>YAC_SERIALIZER_JSON</constant>
+     (<type>int</type>)
+    </term>
+    <listitem>
+     <simpara>
+      Usa JSON como serializador (requer --enable-json)
+     </simpara>
+    </listitem>
+   </varlistentry>
+   <varlistentry xml:id="constant.yac-serializer-igbinary">
+    <term>
+     <constant>YAC_SERIALIZER_IGBINARY</constant>
+     (<type>int</type>)
+    </term>
+    <listitem>
+     <simpara>
+      Usa "igbinary" como serializador (requer --enable-igbinary)
+     </simpara>
+    </listitem>
+   </varlistentry>
+   <varlistentry xml:id="constant.yac-serializer-msgpack">
+    <term>
+     <constant>YAC_SERIALIZER_MSGPACK</constant>
+     (<type>int</type>)
+    </term>
+    <listitem>
+     <simpara>
+      Usa msgpack como serializador (requer --enable-msgpack)
+     </simpara>
+    </listitem>
+   </varlistentry>
+   <varlistentry xml:id="constant.yac-serializer">
+    <term>
+     <constant>YAC_SERIALIZER</constant>
+     (<type>string</type>)
+    </term>
+    <listitem>
+     <simpara>
+      Que serializador o Yac usa.
+     </simpara>
+    </listitem>
+   </varlistentry>
+  </variablelist>
+ </para>
+</appendix>
+
+<!-- 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/yac/ini.xml b/reference/yac/ini.xml
new file mode 100644
index 000000000..91d563d61
--- /dev/null
+++ b/reference/yac/ini.xml
@@ -0,0 +1,172 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- EN-Revision: d4d5216e7a965ca194f6b1c9dee84cecab2674e5 Maintainer: leonardolara Status: ready -->
+
+<section xml:id="yac.configuration" xmlns="http://docbook.org/ns/docbook">
+ &reftitle.runtime;
+ &extension.runtime;
+ <para>
+  <table>
+   <title>&ConfigureOptions; do Yac</title>
+   <tgroup cols="4">
+    <thead>
+     <row>
+      <entry>&Name;</entry>
+      <entry>&Default;</entry>
+      <entry>&Changeable;</entry>
+      <entry>&Changelog;</entry>
+     </row>
+    </thead>
+    <tbody>
+     <row>
+      <entry><link linkend="ini.yac.compress-threshold">yac.compress_threshold</link></entry>
+      <entry>-1</entry>
+      <entry><constant>INI_SYSTEM</constant></entry>
+      <entry><!-- leave empty, this will be filled by an automatic script --></entry>
+     </row>
+     <row>
+      <entry><link linkend="ini.yac.debug">yac.debug</link></entry>
+      <entry>0</entry>
+      <entry><constant>INI_ALL</constant></entry>
+      <entry><!-- leave empty, this will be filled by an automatic script --></entry>
+     </row>
+     <row>
+      <entry><link linkend="ini.yac.enable">yac.enable</link></entry>
+      <entry>1</entry>
+      <entry><constant>INI_SYSTEM</constant></entry>
+      <entry><!-- leave empty, this will be filled by an automatic script --></entry>
+     </row>
+     <row>
+      <entry><link linkend="ini.yac.enable-cli">yac.enable_cli</link></entry>
+      <entry>0</entry>
+      <entry><constant>INI_SYSTEM</constant></entry>
+      <entry><!-- leave empty, this will be filled by an automatic script --></entry>
+     </row>
+     <row>
+      <entry><link linkend="ini.yac.keys-memory-size">yac.keys_memory_size</link></entry>
+      <entry>4M</entry>
+      <entry><constant>INI_SYSTEM</constant></entry>
+      <entry><!-- leave empty, this will be filled by an automatic script --></entry>
+     </row>
+     <row>
+      <entry><link linkend="ini.yac.serializer">yac.serializer</link></entry>
+      <entry>php</entry>
+      <entry><constant>INI_SYSTEM</constant></entry>
+      <entry><!-- leave empty, this will be filled by an automatic script --></entry>
+     </row>
+     <row>
+      <entry><link linkend="ini.yac.values-memory-size">yac.values_memory_size</link></entry>
+      <entry>64M</entry>
+      <entry><constant>INI_SYSTEM</constant></entry>
+      <entry><!-- leave empty, this will be filled by an automatic script --></entry>
+     </row>
+    </tbody>
+   </tgroup>
+  </table>
+ </para>
+
+ &ini.descriptions.title;
+
+ <para>
+  <variablelist>
+   <varlistentry xml:id="ini.yac.compress-threshold">
+     <term>
+      <parameter>yac.compress_threshold</parameter>
+      <type>int</type>
+     </term>
+     <listitem>
+      <para>
+
+      </para>
+     </listitem>
+    </varlistentry>
+    <varlistentry xml:id="ini.yac.debug">
+     <term>
+      <parameter>yac.debug</parameter>
+      <type>int</type>
+     </term>
+     <listitem>
+      <para>
+
+      </para>
+     </listitem>
+    </varlistentry>
+    <varlistentry xml:id="ini.yac.enable">
+     <term>
+      <parameter>yac.enable</parameter>
+      <type>int</type>
+     </term>
+     <listitem>
+      <para>
+
+      </para>
+     </listitem>
+    </varlistentry>
+    <varlistentry xml:id="ini.yac.enable-cli">
+     <term>
+      <parameter>yac.enable_cli</parameter>
+      <type>int</type>
+     </term>
+     <listitem>
+      <para>
+
+      </para>
+     </listitem>
+    </varlistentry>
+    <varlistentry xml:id="ini.yac.keys-memory-size">
+     <term>
+      <parameter>yac.keys_memory_size</parameter>
+      <type>string</type>
+     </term>
+     <listitem>
+      <para>
+
+      </para>
+     </listitem>
+    </varlistentry>
+    <varlistentry xml:id="ini.yac.serializer">
+     <term>
+      <parameter>yac.serializer</parameter>
+      <type>string</type>
+     </term>
+     <listitem>
+      <para>
+
+      </para>
+     </listitem>
+    </varlistentry>
+    <varlistentry xml:id="ini.yac.values-memory-size">
+     <term>
+      <parameter>yac.values_memory_size</parameter>
+      <type>string</type>
+     </term>
+     <listitem>
+      <para>
+
+      </para>
+     </listitem>
+    </varlistentry>
+
+  </variablelist>
+ </para>
+</section>
+
+<!-- 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/yac/setup.xml b/reference/yac/setup.xml
new file mode 100644
index 000000000..e809a0f28
--- /dev/null
+++ b/reference/yac/setup.xml
@@ -0,0 +1,62 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- EN-Revision: 9dbf3a558f49ddc5b2e0097abd3f06cf5413f25d Maintainer: leonardolara Status: ready -->
+
+<chapter xml:id="yac.setup" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
+ &reftitle.setup;
+
+ <section xml:id="yac.requirements">
+  &reftitle.required;
+  <para>
+
+  </para>
+ </section>
+
+ <!-- {{{ Installation -->
+ <section xml:id="yac.installation">
+  &reftitle.install;
+  <para>
+   &pecl.moved;
+  </para>
+  <para>
+   &pecl.info;
+   <link xlink:href="&url.pecl.package;yac">&url.pecl.package;yac</link>.
+  </para>
+  <para>
+   &pecl.windows.download.avail;
+  </para>
+ </section>
+ <!-- }}} -->
+
+ <!-- {{{ Configuration -->
+ &reference.yac.ini;
+ <!-- }}} -->
+
+ <section xml:id="yac.resources">
+  &reftitle.resources;
+  <para>
+
+  </para>
+ </section>
+
+</chapter>
+
+<!-- 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/yac/yac.xml b/reference/yac/yac.xml
new file mode 100644
index 000000000..e93f664ce
--- /dev/null
+++ b/reference/yac/yac.xml
@@ -0,0 +1,90 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- EN-Revision: 4d17b7b4947e7819ff5036715dd706be87ae4def Maintainer: leonardolara Status: ready -->
+
+<reference xml:id="class.yac" role="class" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">
+
+ <title>A classe Yac</title>
+ <titleabbrev>Yac</titleabbrev>
+
+ <partintro>
+
+<!-- {{{ Yac intro -->
+  <section xml:id="yac.intro">
+   &reftitle.intro;
+   <para>
+
+   </para>
+  </section>
+<!-- }}} -->
+
+  <section xml:id="yac.synopsis">
+   &reftitle.classsynopsis;
+
+<!-- {{{ Synopsis -->
+   <classsynopsis>
+    <ooclass><classname>Yac</classname></ooclass>
+
+<!-- {{{ Class synopsis -->
+    <classsynopsisinfo>
+     <ooclass>
+      <classname>Yac</classname>
+     </ooclass>
+    </classsynopsisinfo>
+<!-- }}} -->
+    <classsynopsisinfo role="comment">&Properties;</classsynopsisinfo>
+    <fieldsynopsis>
+     <modifier>protected</modifier>
+     <varname linkend="yac.props.prefix">_prefix</varname>
+    </fieldsynopsis>
+
+
+    <classsynopsisinfo role="comment">&Methods;</classsynopsisinfo>
+    <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.yac')/db:refentry/db:refsect1[@role='description']/descendant::db:constructorsynopsis[not(@role='procedural')])" />
+    <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.yac')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[not(@role='procedural')])" />
+   </classsynopsis>
+<!-- }}} -->
+
+  </section>
+
+
+<!-- {{{ Yac properties -->
+  <section xml:id="yac.props">
+   &reftitle.properties;
+   <variablelist>
+    <varlistentry xml:id="yac.props.prefix">
+     <term><varname>_prefix</varname></term>
+     <listitem>
+      <para></para>
+     </listitem>
+    </varlistentry>
+   </variablelist>
+  </section>
+<!-- }}} -->
+
+
+ </partintro>
+
+ &reference.yac.entities.yac;
+
+</reference>
+
+<!-- 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/yac/yac/add.xml b/reference/yac/yac/add.xml
new file mode 100644
index 000000000..86c1a42ae
--- /dev/null
+++ b/reference/yac/yac/add.xml
@@ -0,0 +1,100 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- EN-Revision: 338bf692d6d24357c4a3b36b098131bc30372378 Maintainer: leonardolara Status: ready -->
+
+<refentry xml:id="yac.add" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
+ <refnamediv>
+  <refname>Yac::add</refname>
+  <refpurpose>Armazena em cache</refpurpose>
+ </refnamediv>
+
+ <refsect1 role="description">
+  &reftitle.description;
+  <methodsynopsis>
+   <modifier>public</modifier> <type>bool</type><methodname>Yac::add</methodname>
+   <methodparam><type>string</type><parameter>keys</parameter></methodparam>
+   <methodparam><type>mixed</type><parameter>value</parameter></methodparam>
+   <methodparam choice="opt"><type>int</type><parameter>ttl</parameter><initializer>0</initializer></methodparam>
+  </methodsynopsis>
+  <methodsynopsis>
+   <modifier>public</modifier> <type>bool</type><methodname>Yac::add</methodname>
+   <methodparam><type>array</type><parameter>key_vals</parameter></methodparam>
+  </methodsynopsis>
+  <para>
+   Adiciona um item ao cache.
+  </para>
+ </refsect1>
+
+ <refsect1 role="parameters">
+  &reftitle.parameters;
+  <variablelist>
+   <varlistentry>
+    <term><parameter>keys</parameter></term>
+    <listitem>
+     <para>
+       &string; de chaves.
+     </para>
+    </listitem>
+   </varlistentry>
+   <varlistentry>
+    <term><parameter>value</parameter></term>
+    <listitem>
+     <para>
+      Valor, todos os tipos do PHP podem ser armazenados, exceto &resource;.
+     </para>
+    </listitem>
+   </varlistentry>
+   <varlistentry>
+    <term><parameter>ttl</parameter></term>
+    <listitem>
+     <para>
+      Tempo de vida.
+     </para>
+    </listitem>
+   </varlistentry>
+  </variablelist>
+ </refsect1>
+
+ <refsect1 role="returnvalues">
+  &reftitle.returnvalues;
+  <para>
+   &boolean;, &true; em caso de sucesso, ou &false; em caso de falha.
+   <note>
+    <para>
+     <methodname>Yac::add</methodname> pode falhar se uma trava CAS não puder ser obtida,
+     portanto, se for necessário que o valor seja armazenado adequadamente, pode-se escrever um codigo como este:
+     <example>
+      <title>Garantindo que um item é armazenado</title>
+      <programlisting role="php">
+       <![CDATA[
+       while(!$yac->set("chave", "valor"));
+       ]]>
+      </programlisting>
+     </example>
+    </para>
+   </note>
+  </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/yac/yac/construct.xml b/reference/yac/yac/construct.xml
new file mode 100644
index 000000000..ec7d0bf82
--- /dev/null
+++ b/reference/yac/yac/construct.xml
@@ -0,0 +1,77 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- EN-Revision: 74155fb94bef0d0e0c6edd5994fc33ab40781701 Maintainer: leonardolara Status: ready -->
+
+<refentry xml:id="yac.construct" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
+ <refnamediv>
+  <refname>Yac::__construct</refname>
+  <refpurpose>Construtor</refpurpose>
+ </refnamediv>
+
+ <refsect1 role="description">
+  &reftitle.description;
+  <constructorsynopsis>
+   <modifier>public</modifier> <methodname>Yac::__construct</methodname>
+   <methodparam choice="opt"><type>string</type><parameter>prefix</parameter><initializer>""</initializer></methodparam>
+  </constructorsynopsis>
+  <para>
+   O parâmetro "prefix" é usado para prefixar chaves. Isso pode ser usado para evitar conflitos entre aplicações.
+  </para>
+
+ </refsect1>
+
+ <refsect1 role="parameters">
+  &reftitle.parameters;
+  <variablelist>
+   <varlistentry>
+    <term><parameter>prefix</parameter></term>
+    <listitem>
+     <para>
+       &string; de prefixo.
+     </para>
+    </listitem>
+   </varlistentry>
+  </variablelist>
+ </refsect1>
+
+ <!-- Return values commented out, as constructors generally don't return a
+      value. Uncomment this if you do need a return values section (for
+      example, because there's also a procedural version of the method).
+ <refsect1 role="returnvalues">
+  &reftitle.returnvalues;
+  <para>
+
+  </para>
+ </refsect1>
+ -->
+
+ <refsect1 role="errors">
+  &reftitle.errors;
+  <para>
+   Lança uma <classname>Exception</classname> se o Yac não estiver habilitado. Lança uma
+   <classname>Exception</classname> se <parameter>prefix</parameter> exceder
+   o comprimento máximo de 48 (<constant>YAC_MAX_KEY_LEN</constant>) bytes.
+  </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/yac/yac/delete.xml b/reference/yac/yac/delete.xml
new file mode 100644
index 000000000..f96489949
--- /dev/null
+++ b/reference/yac/yac/delete.xml
@@ -0,0 +1,73 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- EN-Revision: 53242ee6628dc1ae6989fe002231fddfd8f005c6 Maintainer: leonardolara Status: ready -->
+
+<refentry xml:id="yac.delete" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
+ <refnamediv>
+  <refname>Yac::delete</refname>
+  <refpurpose>Exclui itens do cache</refpurpose>
+ </refnamediv>
+
+ <refsect1 role="description">
+  &reftitle.description;
+  <methodsynopsis>
+   <modifier>public</modifier> <type>bool</type><methodname>Yac::delete</methodname>
+   <methodparam><type class="union"><type>string</type><type>array</type></type><parameter>keys</parameter></methodparam>
+   <methodparam choice="opt"><type>int</type><parameter>ttl</parameter></methodparam>
+  </methodsynopsis>
+  <para>
+   Exclui itens do cache.
+  </para>
+ </refsect1>
+
+ <refsect1 role="parameters">
+  &reftitle.parameters;
+  <variablelist>
+   <varlistentry>
+    <term><parameter>keys</parameter></term>
+    <listitem>
+     <para>
+      Chave string, ou array com múltiplas chaves a serem removidas.
+     </para>
+    </listitem>
+   </varlistentry>
+   <varlistentry>
+    <term><parameter>ttl</parameter></term>
+    <listitem>
+     <para>
+      Tempo em segundos para marcar os itens como inválidos.
+     </para>
+    </listitem>
+   </varlistentry>
+  </variablelist>
+ </refsect1>
+
+ <refsect1 role="returnvalues">
+  &reftitle.returnvalues;
+  <para>
+
+  </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/yac/yac/dump.xml b/reference/yac/yac/dump.xml
new file mode 100644
index 000000000..5b5f5c180
--- /dev/null
+++ b/reference/yac/yac/dump.xml
@@ -0,0 +1,64 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- EN-Revision: b8be4b126c545a0b452be29b6b5ce185471814a1 Maintainer: leonardolara Status: ready -->
+
+<refentry xml:id="yac.dump" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
+ <refnamediv>
+  <refname>Yac::dump</refname>
+  <refpurpose>Despeja o cache</refpurpose>
+ </refnamediv>
+
+ <refsect1 role="description">
+  &reftitle.description;
+  <methodsynopsis>
+   <modifier>public</modifier> <type>mixed</type><methodname>Yac::dump</methodname>
+   <methodparam><type>int</type><parameter>$num</parameter></methodparam>
+  </methodsynopsis>
+  <para>
+   Despeja os valores armazenados em cache.
+  </para>
+ </refsect1>
+
+ <refsect1 role="parameters">
+  &reftitle.parameters;
+  <variablelist>
+   <varlistentry>
+    <term><parameter>num</parameter></term>
+    <listitem>
+     <para>
+      O máximo número de itens que devem ser retornados.
+     </para>
+    </listitem>
+   </varlistentry>
+  </variablelist>
+ </refsect1>
+
+ <refsect1 role="returnvalues">
+  &reftitle.returnvalues;
+  <para>
+   Retorna os valores despejados.
+  </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/yac/yac/flush.xml b/reference/yac/yac/flush.xml
new file mode 100644
index 000000000..b00f61061
--- /dev/null
+++ b/reference/yac/yac/flush.xml
@@ -0,0 +1,55 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- EN-Revision: b8be4b126c545a0b452be29b6b5ce185471814a1 Maintainer: leonardolara Status: ready -->
+
+<refentry xml:id="yac.flush" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
+ <refnamediv>
+  <refname>Yac::flush</refname>
+  <refpurpose>Descarrega o cache</refpurpose>
+ </refnamediv>
+
+ <refsect1 role="description">
+  &reftitle.description;
+  <methodsynopsis>
+   <modifier>public</modifier> <type>bool</type><methodname>Yac::flush</methodname>
+   <void />
+  </methodsynopsis>
+  <para>
+   Remove todos os valores em cache.
+  </para>
+ </refsect1>
+
+ <refsect1 role="parameters">
+  &reftitle.parameters;
+  &no.function.parameters;
+ </refsect1>
+
+ <refsect1 role="returnvalues">
+  &reftitle.returnvalues;
+  <para>
+   Sempre retorna true.
+  </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/yac/yac/get.xml b/reference/yac/yac/get.xml
new file mode 100644
index 000000000..e0f25d4a8
--- /dev/null
+++ b/reference/yac/yac/get.xml
@@ -0,0 +1,73 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- EN-Revision: 53242ee6628dc1ae6989fe002231fddfd8f005c6 Maintainer: leonardolara Status: ready -->
+
+<refentry xml:id="yac.get" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
+ <refnamediv>
+  <refname>Yac::get</refname>
+  <refpurpose>Obtém valores do cache</refpurpose>
+ </refnamediv>
+
+ <refsect1 role="description">
+  &reftitle.description;
+  <methodsynopsis>
+   <modifier>public</modifier> <type>mixed</type><methodname>Yac::get</methodname>
+   <methodparam><type class="union"><type>string</type><type>array</type></type><parameter>key</parameter></methodparam>
+   <methodparam choice="opt"><type>int</type><parameter role="reference">cas</parameter><initializer>&null;</initializer></methodparam>
+  </methodsynopsis>
+  <para>
+   Obtém valores do cache.
+  </para>
+ </refsect1>
+
+ <refsect1 role="parameters">
+  &reftitle.parameters;
+  <variablelist>
+   <varlistentry>
+    <term><parameter>key</parameter></term>
+    <listitem>
+     <para>
+      Chaves &string; ou &array; de várias chaves.
+     </para>
+    </listitem>
+   </varlistentry>
+   <varlistentry>
+    <term><parameter>cas</parameter></term>
+    <listitem>
+     <para>
+      Se não for &null;, será definido para o CAS do item obtido.
+     </para>
+    </listitem>
+   </varlistentry>
+  </variablelist>
+ </refsect1>
+
+ <refsect1 role="returnvalues">
+  &reftitle.returnvalues;
+  <para>
+   Retorna o valor em caso de sucesso, false em caso de falha.
+  </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/yac/yac/getter.xml b/reference/yac/yac/getter.xml
new file mode 100644
index 000000000..07ba32b80
--- /dev/null
+++ b/reference/yac/yac/getter.xml
@@ -0,0 +1,64 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- EN-Revision: 338bf692d6d24357c4a3b36b098131bc30372378 Maintainer: leonardolara Status: ready -->
+
+<refentry xml:id="yac.getter" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
+ <refnamediv>
+  <refname>Yac::__get</refname>
+  <refpurpose>Obtém valores do cache</refpurpose>
+ </refnamediv>
+
+ <refsect1 role="description">
+  &reftitle.description;
+  <methodsynopsis>
+   <modifier>public</modifier> <type>mixed</type><methodname>Yac::__get</methodname>
+   <methodparam><type>string</type><parameter>key</parameter></methodparam>
+  </methodsynopsis>
+  <para>
+   Obtém valores do cache.
+  </para>
+ </refsect1>
+
+ <refsect1 role="parameters">
+  &reftitle.parameters;
+  <variablelist>
+   <varlistentry>
+    <term><parameter>key</parameter></term>
+    <listitem>
+     <para>
+       Chave &string;
+     </para>
+    </listitem>
+   </varlistentry>
+  </variablelist>
+ </refsect1>
+
+ <refsect1 role="returnvalues">
+  &reftitle.returnvalues;
+  <para>
+   Retorna o valor em caso de sucesso, &null; em caso de falha.
+  </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/yac/yac/info.xml b/reference/yac/yac/info.xml
new file mode 100644
index 000000000..19bdc687b
--- /dev/null
+++ b/reference/yac/yac/info.xml
@@ -0,0 +1,57 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- EN-Revision: d286e6182179363c926e03ced71d03f3b2879ad6 Maintainer: leonardolara Status: ready -->
+
+<refentry xml:id="yac.info" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
+ <refnamediv>
+  <refname>Yac::info</refname>
+  <refpurpose>Obtém o status do cache</refpurpose>
+ </refnamediv>
+
+ <refsect1 role="description">
+  &reftitle.description;
+  <methodsynopsis>
+   <modifier>public</modifier> <type>array</type><methodname>Yac::info</methodname>
+   <void />
+  </methodsynopsis>
+  <para>
+   Obtém o status do sistema de cache.
+  </para>
+ </refsect1>
+
+ <refsect1 role="parameters">
+  &reftitle.parameters;
+  &no.function.parameters;
+ </refsect1>
+
+ <refsect1 role="returnvalues">
+  &reftitle.returnvalues;
+  <para>
+   Retorna um array com as seguintes chaves:
+   "memory_size", "slots_memory_size", "values_memory_size", "segment_size", "segment_num",
+   "miss", "hits", "fails", "kicks", "recycles", "slots_size" e "slots_used".
+  </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/yac/yac/set.xml b/reference/yac/yac/set.xml
new file mode 100644
index 000000000..b18d34b4c
--- /dev/null
+++ b/reference/yac/yac/set.xml
@@ -0,0 +1,85 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- EN-Revision: 338bf692d6d24357c4a3b36b098131bc30372378 Maintainer: leonardolara Status: ready -->
+
+<refentry xml:id="yac.set" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
+ <refnamediv>
+  <refname>Yac::set</refname>
+  <refpurpose>Armazena no cache</refpurpose>
+ </refnamediv>
+
+ <refsect1 role="description">
+  &reftitle.description;
+  <methodsynopsis>
+   <modifier>public</modifier> <type>bool</type><methodname>Yac::set</methodname>
+   <methodparam><type>string</type><parameter>keys</parameter></methodparam>
+   <methodparam><type>mixed</type><parameter>value</parameter></methodparam>
+   <methodparam choice="opt"><type>int</type><parameter>ttl</parameter><initializer>0</initializer></methodparam>
+  </methodsynopsis>
+  <methodsynopsis>
+   <modifier>public</modifier> <type>bool</type><methodname>Yac::add</methodname>
+   <methodparam><type>array</type><parameter>key_vals</parameter></methodparam>
+  </methodsynopsis>
+  <para>
+   Adiciona um item ao cache e, se a chave já existir, substitui o item.
+  </para>
+ </refsect1>
+
+ <refsect1 role="parameters">
+  &reftitle.parameters;
+  <variablelist>
+   <varlistentry>
+    <term><parameter>keys</parameter></term>
+    <listitem>
+     <para>
+       Chave &string;.
+     </para>
+    </listitem>
+   </varlistentry>
+   <varlistentry>
+    <term><parameter>value</parameter></term>
+    <listitem>
+     <para>
+      Valor a ser armazenado, de qualquer tipo PHP exceto &resource;.
+     </para>
+    </listitem>
+   </varlistentry>
+   <varlistentry>
+    <term><parameter>ttl</parameter></term>
+    <listitem>
+     <para>
+      Tempo de vida.
+     </para>
+    </listitem>
+   </varlistentry>
+  </variablelist>
+ </refsect1>
+
+ <refsect1 role="returnvalues">
+  &reftitle.returnvalues;
+  <para>
+   O próprio valor.
+  </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/yac/yac/setter.xml b/reference/yac/yac/setter.xml
new file mode 100644
index 000000000..a099c8771
--- /dev/null
+++ b/reference/yac/yac/setter.xml
@@ -0,0 +1,72 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- EN-Revision: 5733f2023a2aa3112b2e6a560b130523dd8fce03 Maintainer: leonardolara Status: ready -->
+
+<refentry xml:id="yac.setter" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
+ <refnamediv>
+  <refname>Yac::__set</refname>
+  <refpurpose>Armazena no cache</refpurpose>
+ </refnamediv>
+
+ <refsect1 role="description">
+  &reftitle.description;
+  <methodsynopsis>
+   <modifier>public</modifier> <type>mixed</type><methodname>Yac::__set</methodname>
+   <methodparam><type>string</type><parameter>keys</parameter></methodparam>
+   <methodparam><type>mixed</type><parameter>value</parameter></methodparam>
+  </methodsynopsis>
+  <para>
+   Armazena um item no cache.
+  </para>
+ </refsect1>
+
+ <refsect1 role="parameters">
+  &reftitle.parameters;
+  <variablelist>
+   <varlistentry>
+    <term><parameter>keys</parameter></term>
+    <listitem>
+     <para>
+      Chave &string;.
+     </para>
+    </listitem>
+   </varlistentry>
+   <varlistentry>
+    <term><parameter>value</parameter></term>
+    <listitem>
+     <para>
+      Valor a ser armazenado, de qualquer tipo PHP exceto &resource;.
+     </para>
+    </listitem>
+   </varlistentry>
+  </variablelist>
+ </refsect1>
+
+ <refsect1 role="returnvalues">
+  &reftitle.returnvalues;
+  <para>
+   Sempre retorna o próprio valor.
+  </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
+-->