Tradução em reference/rar (#650)

* inclusão dos arquivos originais com revisão atualizada

* Tradução em reference/rar

* Update reference.xml

* removed space

reference/rar/book.xml

@@ -0,0 +1,55 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- EN-Revision: 68c2c871505aadf983f16113c5b077b335ce8d76 Maintainer: fernandowobeto Status: ready --><!-- CREDITS: fernandowobeto -->
+
+<book xml:id="book.rar" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
+ <?phpdoc extension-membership="pecl" ?>
+ <title>Rar Archiving</title>
+ <titleabbrev>Rar</titleabbrev>
+
+ <!-- {{{ preface -->
+ <preface xml:id="intro.rar">
+  &reftitle.intro;
+  <para>
+   Rar é um arquivador poderoso e eficaz criado por Eugene Roshal.
+   Esta extensão dá a possibilidade de ler arquivos Rar, mas
+   não suporta a gravação de arquivos Rar, porque isso não é suportado
+   pela biblioteca UnRar e é diretamente proibido por sua licença.
+  </para>
+  <para>
+   Mais informações sobre Rar e UnRar pode ser encontrado em <link
+   xlink:href="&url.rar;">&url.rar;</link>.
+  </para>
+ </preface>
+ <!-- }}} -->
+
+ &reference.rar.setup;
+ &reference.rar.constants;
+ &reference.rar.examples;
+ &reference.rar.reference;
+ &reference.rar.rararchive;
+ &reference.rar.rarentry;
+ &reference.rar.rarexception;
+
+</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
+-->
+

reference/rar/constants.xml

@@ -0,0 +1,86 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- EN-Revision: 86e6094e86b84a51d00ab217ac50ce8dde33d82a Maintainer: fernandowobeto Status: ready --><!-- CREDITS: fernandowobeto -->
+
+<appendix xml:id="rar.constants" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
+ &reftitle.constants;
+ &extension.constants;
+ <variablelist>
+  <varlistentry xml:id="constant.rar-host-msdos">
+   <term>
+    <constant>RAR_HOST_MSDOS</constant>
+    (<type>int</type>)
+   </term>
+   <listitem>
+    <simpara>
+     Use <link linkend="rarentry.constants.host-msdos"><constant>RarEntry::HOST_MSDOS</constant></link> no lugar.
+    </simpara>
+   </listitem>
+  </varlistentry>
+  <varlistentry xml:id="constant.rar-host-os2">
+   <term>
+    <constant>RAR_HOST_OS2</constant>
+    (<type>int</type>)
+   </term>
+   <listitem>
+    <simpara>
+     Use <link linkend="rarentry.constants.host-os2"><constant>RarEntry::HOST_OS2</constant></link> no lugar.
+    </simpara>
+   </listitem>
+  </varlistentry>
+  <varlistentry xml:id="constant.rar-host-win32">
+   <term>
+    <constant>RAR_HOST_WIN32</constant>
+    (<type>int</type>)
+   </term>
+   <listitem>
+    <simpara>
+     Use <link linkend="rarentry.constants.host-win32"><constant>RarEntry::HOST_WIN32</constant></link> no lugar.
+    </simpara>
+   </listitem>
+  </varlistentry>
+  <varlistentry xml:id="constant.rar-host-unix">
+   <term>
+    <constant>RAR_HOST_UNIX</constant>
+    (<type>int</type>)
+   </term>
+   <listitem>
+    <simpara>
+     Use <link linkend="rarentry.constants.host-unix"><constant>RarEntry::HOST_UNIX</constant></link> no lugar.
+    </simpara>
+   </listitem>
+  </varlistentry>
+  <varlistentry xml:id="constant.rar-host-beos">
+   <term>
+    <constant>RAR_HOST_BEOS</constant>
+    (<type>int</type>)
+   </term>
+   <listitem>
+    <simpara>
+     Use <link linkend="rarentry.constants.host-beos"><constant>RarEntry::HOST_BEOS</constant></link> no lugar.
+    </simpara>
+   </listitem>
+  </varlistentry>
+ </variablelist>
+</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
+-->
+

reference/rar/examples.xml

@@ -0,0 +1,178 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- EN-Revision: 257719873bb67162f68ad4d855d259745b02378b Maintainer: fernandowobeto Status: ready --><!-- CREDITS: fernandowobeto -->
+
+<chapter xml:id="rar.examples" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
+ &reftitle.examples;
+
+ <para>
+  Veja também os exemplos em <link linkend="wrappers.rar"><literal>rar://</literal> wrapper</link>.
+ </para>
+
+ <para>
+  <example>
+   <title>Descompressão instantânea</title>
+   <programlisting role="php">
+<![CDATA[
+<?php
+
+if (!array_key_exists("i", $_GET) || !is_numeric($_GET["i"]))
+    die("Index unspecified or non-numeric");
+$index = (int) $_GET["i"];
+
+$arch = RarArchive::open("example.rar");
+if ($arch === FALSE)
+    die("Cannot open example.rar");
+
+$entries = $arch->getEntries();
+if ($entries === FALSE)
+    die("Cannot retrieve entries");
+
+if (!array_key_exists($index, $entries))
+    die("No such index: $index");
+
+$orfilename = $entries[$index]->getName(); //UTF-8 encoded
+
+$filesize = $entries[$index]->getUnpackedSize();
+
+/* você pode verificar HTTP_IF_MODIFIED_SINCE aqui e comparar com
+ * $entries[$index]->getFileTime(). Você também pode enviar um
+ * "Last modified" header */
+
+$fp = $entries[$index]->getStream();
+if ($fp === FALSE)
+    die("Cannot open file with index $index insided the archive.");
+
+$arch->close(); //não é mais necessário; fluxo é independente
+
+function detectUserAgent() {
+    if (!array_key_exists('HTTP_USER_AGENT', $_SERVER))
+        return "Other";
+
+    $uas = $_SERVER['HTTP_USER_AGENT'];
+    if (preg_match("@Opera/@", $uas))
+        return "Opera";
+    if (preg_match("@Firefox/@", $uas))
+        return "Firefox";
+    if (preg_match("@Chrome/@", $uas))
+        return "Chrome";
+    if (preg_match("@MSIE ([0-9.]+);@", $uas, $matches)) {
+        if (((float)$matches[1]) >= 7.0)
+            return "IE";
+    }
+
+    return "Other";
+}
+
+/*
+ * Temos 3 opções:
+ * - Para FF e Opera, que suportam RFC 2231, use esse formato.
+ * - Para IE e Chrome, use attwithfnrawpctenclong
+ *   (http://greenbytes.de/tech/tc2231/#attwithfnrawpctenclong)
+ * - Para os demais, converta para ISO-8859-1, se possível
+ */
+$formatRFC2231 = 'Content-Disposition: attachment; filename*=UTF-8\'\'%s';
+$formatDef = 'Content-Disposition: attachment; filename="%s"';
+
+switch (detectUserAgent()) {
+    case "Opera":
+    case "Firefox":
+        $orfilename = rawurlencode($orfilename);
+        $format = $formatRFC2231;
+        break;
+
+    case "IE":
+    case "Chrome":
+        $orfilename = rawurlencode($orfilename);
+        $format = $formatDef;
+        break;
+    default:
+        if (function_exists('iconv'))
+            $orfilename =
+                @iconv("UTF-8", "ISO-8859-1//TRANSLIT", $orfilename);
+        $format = $formatDef;
+}
+
+header(sprintf($format, $orfilename));
+//não é possível enviar mensagens de erro a partir de agora (cabeçalhos já enviados)
+
+//substitua pelo tipo de conteúdo real, talvez inferindo da extensão do arquivo
+$contentType = "application/octet-stream";
+header("Content-Type: $contentType");
+
+header("Content-Transfer-Encoding: binary");
+
+header("Content-Length: $filesize");
+
+if ($_SERVER['REQUEST_METHOD'] == "HEAD")
+    die();
+
+while (!feof($fp)) {
+    $s = @fread($fp, 8192);
+    if ($s === false)
+        break; //useless to send error messages
+
+    echo $s;
+}
+?>
+]]>
+   </programlisting>
+  </example>
+ </para>
+ <para>
+  Este exemplo abre um arquivo RAR e apresenta o arquivo solicitado dentro do arquivo RAR para download no cliente.
+ </para>
+
+ <para>
+  <example>
+   <title>Exemplo de extração de sistema de arquivos com extensão RAR</title>
+   <programlisting role="php">
+<![CDATA[
+<?php
+
+$rar_file = rar_open('example.rar') or die("Can't open Rar archive");
+
+$entries = rar_list($rar_file);
+
+foreach ($entries as $entry) {
+    echo 'Filename: ' . $entry->getName() . "\n";
+    echo 'Packed size: ' . $entry->getPackedSize() . "\n";
+    echo 'Unpacked size: ' . $entry->getUnpackedSize() . "\n";
+
+    $entry->extract('/dir/extract/to/');
+}
+
+rar_close($rar_file);
+
+?>
+]]>
+   </programlisting>
+  </example>
+ </para>
+ <para>
+  Este exemplo abre um arquivo RAR e extrai cada entrada para o
+  diretório especificado.
+ </para>
+
+</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
+-->
+

reference/rar/ini.xml

@@ -0,0 +1,27 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- EN-Revision: 96c9d88bad9a7d7d44bfb7f26c226df7ee9ddf26 Maintainer: fernandowobeto Status: ready --><!-- CREDITS: fernandowobeto -->
+<section xml:id="rar.configuration" xmlns="http://docbook.org/ns/docbook">
+ &reftitle.runtime;
+ &no.config;
+</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
+-->

reference/rar/rararchive.xml

@@ -0,0 +1,78 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- EN-Revision: ff65144390564426bdf289c2351c4e8a0f6a73e1 Maintainer: fernandowobeto Status: ready --><!-- CREDITS: fernandowobeto -->
+
+<phpdoc:classref xml:id="class.rararchive" xmlns:phpdoc="http://php.net/ns/phpdoc" 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 RarArchive</title>
+ <titleabbrev>RarArchive</titleabbrev>
+
+ <partintro>
+
+<!-- {{{ RarArchive intro -->
+  <section xml:id="rararchive.intro">
+   &reftitle.intro;
+   <para>
+    Esta classe representa um arquivo RAR, que pode ser formado por vários volumes (partes) e que contém
+    uma série de entradas RAR (ou seja, arquivos, diretórios e outros objetos especiais, como links simbólicos).
+   </para>
+   <para>
+    Objetos desta classe podem ser percorridos, gerando as entradas armazenadas no respectivo arquivo RAR.
+    Essas entradas também podem ser obtidas através de <methodname>RarArchive::getEntry</methodname> e
+    <methodname>RarArchive::getEntries</methodname>.
+   </para>
+  </section>
+<!-- }}} -->
+
+  <section xml:id="rararchive.synopsis">
+   &reftitle.classsynopsis;
+
+<!-- {{{ Synopsis -->
+   <classsynopsis>
+    <ooclass><classname>RarArchive</classname></ooclass>
+
+<!-- {{{ Class synopsis -->
+    <classsynopsisinfo>
+     <ooclass>
+      <modifier>final</modifier>
+      <classname>RarArchive</classname>
+     </ooclass>
+
+     <oointerface>
+      <interfacename>Traversable</interfacename>
+     </oointerface>
+    </classsynopsisinfo>
+<!-- }}} -->
+
+    <classsynopsisinfo role="comment">&Methods;</classsynopsisinfo>
+    <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.rararchive')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[1])" />
+   </classsynopsis>
+<!-- }}} -->
+
+  </section>
+
+ </partintro>
+
+ &reference.rar.entities.rararchive;
+
+</phpdoc:classref>
+
+<!-- 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
+-->

reference/rar/rarentry.xml

@@ -0,0 +1,682 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- EN-Revision: 86e6094e86b84a51d00ab217ac50ce8dde33d82a Maintainer: fernandowobeto Status: ready --><!-- CREDITS: fernandowobeto -->
+
+<phpdoc:classref xml:id="class.rarentry" xmlns:phpdoc="http://php.net/ns/phpdoc" 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 <classname>RarEntry</classname></title>
+ <titleabbrev>RarEntry</titleabbrev>
+
+ <partintro>
+
+<!-- {{{ RarEntry intro -->
+  <section xml:id="rarentry.intro">
+   &reftitle.intro;
+   <para>
+    Uma entrada RAR, representando um diretório ou arquivo compactado dentro de um arquivo RAR.
+   </para>
+  </section>
+<!-- }}} -->
+
+  <section xml:id="rarentry.synopsis">
+   &reftitle.classsynopsis;
+
+<!-- {{{ Synopsis -->
+   <classsynopsis>
+    <ooclass><classname>RarEntry</classname></ooclass>
+
+<!-- {{{ Class synopsis -->
+    <classsynopsisinfo>
+     <ooclass>
+      <modifier>final</modifier>
+      <classname>RarEntry</classname>
+     </ooclass>
+    </classsynopsisinfo>
+<!-- }}} -->
+    <classsynopsisinfo role="comment">&Constants;</classsynopsisinfo>
+    <fieldsynopsis>
+     <modifier>const</modifier>
+     <type>int</type>
+     <varname linkend="rarentry.constants.host-msdos">RarEntry::HOST_MSDOS</varname>
+     <initializer>0</initializer>
+    </fieldsynopsis>
+    <fieldsynopsis>
+     <modifier>const</modifier>
+     <type>int</type>
+     <varname linkend="rarentry.constants.host-os2">RarEntry::HOST_OS2</varname>
+     <initializer>1</initializer>
+    </fieldsynopsis>
+    <fieldsynopsis>
+     <modifier>const</modifier>
+     <type>int</type>
+     <varname linkend="rarentry.constants.host-win32">RarEntry::HOST_WIN32</varname>
+     <initializer>2</initializer>
+    </fieldsynopsis>
+    <fieldsynopsis>
+     <modifier>const</modifier>
+     <type>int</type>
+     <varname linkend="rarentry.constants.host-unix">RarEntry::HOST_UNIX</varname>
+     <initializer>3</initializer>
+    </fieldsynopsis>
+    <fieldsynopsis>
+     <modifier>const</modifier>
+     <type>int</type>
+     <varname linkend="rarentry.constants.host-macos">RarEntry::HOST_MACOS</varname>
+     <initializer>4</initializer>
+    </fieldsynopsis>
+    <fieldsynopsis>
+     <modifier>const</modifier>
+     <type>int</type>
+     <varname linkend="rarentry.constants.host-beos">RarEntry::HOST_BEOS</varname>
+     <initializer>5</initializer>
+    </fieldsynopsis>
+    <fieldsynopsis>
+     <modifier>const</modifier>
+     <type>int</type>
+     <varname linkend="rarentry.constants.attribute-win-readonly">RarEntry::ATTRIBUTE_WIN_READONLY</varname>
+     <initializer>1</initializer>
+    </fieldsynopsis>
+    <fieldsynopsis>
+     <modifier>const</modifier>
+     <type>int</type>
+     <varname linkend="rarentry.constants.attribute-win-hidden">RarEntry::ATTRIBUTE_WIN_HIDDEN</varname>
+     <initializer>2</initializer>
+    </fieldsynopsis>
+    <fieldsynopsis>
+     <modifier>const</modifier>
+     <type>int</type>
+     <varname linkend="rarentry.constants.attribute-win-system">RarEntry::ATTRIBUTE_WIN_SYSTEM</varname>
+     <initializer>4</initializer>
+    </fieldsynopsis>
+    <fieldsynopsis>
+     <modifier>const</modifier>
+     <type>int</type>
+     <varname linkend="rarentry.constants.attribute-win-directory">RarEntry::ATTRIBUTE_WIN_DIRECTORY</varname>
+     <initializer>16</initializer>
+    </fieldsynopsis>
+    <fieldsynopsis>
+     <modifier>const</modifier>
+     <type>int</type>
+     <varname linkend="rarentry.constants.attribute-win-archive">RarEntry::ATTRIBUTE_WIN_ARCHIVE</varname>
+     <initializer>32</initializer>
+    </fieldsynopsis>
+    <fieldsynopsis>
+     <modifier>const</modifier>
+     <type>int</type>
+     <varname linkend="rarentry.constants.attribute-win-device">RarEntry::ATTRIBUTE_WIN_DEVICE</varname>
+     <initializer>64</initializer>
+    </fieldsynopsis>
+    <fieldsynopsis>
+     <modifier>const</modifier>
+     <type>int</type>
+     <varname linkend="rarentry.constants.attribute-win-normal">RarEntry::ATTRIBUTE_WIN_NORMAL</varname>
+     <initializer>128</initializer>
+    </fieldsynopsis>
+    <fieldsynopsis>
+     <modifier>const</modifier>
+     <type>int</type>
+     <varname linkend="rarentry.constants.attribute-win-temporary">RarEntry::ATTRIBUTE_WIN_TEMPORARY</varname>
+     <initializer>256</initializer>
+    </fieldsynopsis>
+    <fieldsynopsis>
+     <modifier>const</modifier>
+     <type>int</type>
+     <varname linkend="rarentry.constants.attribute-win-sparse-file">RarEntry::ATTRIBUTE_WIN_SPARSE_FILE</varname>
+     <initializer>512</initializer>
+    </fieldsynopsis>
+    <fieldsynopsis>
+     <modifier>const</modifier>
+     <type>int</type>
+     <varname linkend="rarentry.constants.attribute-win-reparse-point">RarEntry::ATTRIBUTE_WIN_REPARSE_POINT</varname>
+     <initializer>1024</initializer>
+    </fieldsynopsis>
+    <fieldsynopsis>
+     <modifier>const</modifier>
+     <type>int</type>
+     <varname linkend="rarentry.constants.attribute-win-compressed">RarEntry::ATTRIBUTE_WIN_COMPRESSED</varname>
+     <initializer>2048</initializer>
+    </fieldsynopsis>
+    <fieldsynopsis>
+     <modifier>const</modifier>
+     <type>int</type>
+     <varname linkend="rarentry.constants.attribute-win-offline">RarEntry::ATTRIBUTE_WIN_OFFLINE</varname>
+     <initializer>4096</initializer>
+    </fieldsynopsis>
+    <fieldsynopsis>
+     <modifier>const</modifier>
+     <type>int</type>
+     <varname linkend="rarentry.constants.attribute-win-not-content-indexed">RarEntry::ATTRIBUTE_WIN_NOT_CONTENT_INDEXED</varname>
+     <initializer>8192</initializer>
+    </fieldsynopsis>
+    <fieldsynopsis>
+     <modifier>const</modifier>
+     <type>int</type>
+     <varname linkend="rarentry.constants.attribute-win-encrypted">RarEntry::ATTRIBUTE_WIN_ENCRYPTED</varname>
+     <initializer>16384</initializer>
+    </fieldsynopsis>
+    <fieldsynopsis>
+     <modifier>const</modifier>
+     <type>int</type>
+     <varname linkend="rarentry.constants.attribute-win-virtual">RarEntry::ATTRIBUTE_WIN_VIRTUAL</varname>
+     <initializer>65536</initializer>
+    </fieldsynopsis>
+    <fieldsynopsis>
+     <modifier>const</modifier>
+     <type>int</type>
+     <varname linkend="rarentry.constants.attribute-unix-world-execute">RarEntry::ATTRIBUTE_UNIX_WORLD_EXECUTE</varname>
+     <initializer>1</initializer>
+    </fieldsynopsis>
+    <fieldsynopsis>
+     <modifier>const</modifier>
+     <type>int</type>
+     <varname linkend="rarentry.constants.attribute-unix-world-write">RarEntry::ATTRIBUTE_UNIX_WORLD_WRITE</varname>
+     <initializer>2</initializer>
+    </fieldsynopsis>
+    <fieldsynopsis>
+     <modifier>const</modifier>
+     <type>int</type>
+     <varname linkend="rarentry.constants.attribute-unix-world-read">RarEntry::ATTRIBUTE_UNIX_WORLD_READ</varname>
+     <initializer>4</initializer>
+    </fieldsynopsis>
+    <fieldsynopsis>
+     <modifier>const</modifier>
+     <type>int</type>
+     <varname linkend="rarentry.constants.attribute-unix-group-execute">RarEntry::ATTRIBUTE_UNIX_GROUP_EXECUTE</varname>
+     <initializer>8</initializer>
+    </fieldsynopsis>
+    <fieldsynopsis>
+     <modifier>const</modifier>
+     <type>int</type>
+     <varname linkend="rarentry.constants.attribute-unix-group-write">RarEntry::ATTRIBUTE_UNIX_GROUP_WRITE</varname>
+     <initializer>16</initializer>
+    </fieldsynopsis>
+    <fieldsynopsis>
+     <modifier>const</modifier>
+     <type>int</type>
+     <varname linkend="rarentry.constants.attribute-unix-group-read">RarEntry::ATTRIBUTE_UNIX_GROUP_READ</varname>
+     <initializer>32</initializer>
+    </fieldsynopsis>
+    <fieldsynopsis>
+     <modifier>const</modifier>
+     <type>int</type>
+     <varname linkend="rarentry.constants.attribute-unix-owner-execute">RarEntry::ATTRIBUTE_UNIX_OWNER_EXECUTE</varname>
+     <initializer>64</initializer>
+    </fieldsynopsis>
+    <fieldsynopsis>
+     <modifier>const</modifier>
+     <type>int</type>
+     <varname linkend="rarentry.constants.attribute-unix-owner-write">RarEntry::ATTRIBUTE_UNIX_OWNER_WRITE</varname>
+     <initializer>128</initializer>
+    </fieldsynopsis>
+    <fieldsynopsis>
+     <modifier>const</modifier>
+     <type>int</type>
+     <varname linkend="rarentry.constants.attribute-unix-owner-read">RarEntry::ATTRIBUTE_UNIX_OWNER_READ</varname>
+     <initializer>256</initializer>
+    </fieldsynopsis>
+    <fieldsynopsis>
+     <modifier>const</modifier>
+     <type>int</type>
+     <varname linkend="rarentry.constants.attribute-unix-sticky">RarEntry::ATTRIBUTE_UNIX_STICKY</varname>
+     <initializer>512</initializer>
+    </fieldsynopsis>
+    <fieldsynopsis>
+     <modifier>const</modifier>
+     <type>int</type>
+     <varname linkend="rarentry.constants.attribute-unix-setgid">RarEntry::ATTRIBUTE_UNIX_SETGID</varname>
+     <initializer>1024</initializer>
+    </fieldsynopsis>
+    <fieldsynopsis>
+     <modifier>const</modifier>
+     <type>int</type>
+     <varname linkend="rarentry.constants.attribute-unix-setuid">RarEntry::ATTRIBUTE_UNIX_SETUID</varname>
+     <initializer>2048</initializer>
+    </fieldsynopsis>
+    <fieldsynopsis>
+     <modifier>const</modifier>
+     <type>int</type>
+     <varname linkend="rarentry.constants.attribute-unix-final-quartet">RarEntry::ATTRIBUTE_UNIX_</varname>
+     <initializer>61440</initializer>
+    </fieldsynopsis>
+    <fieldsynopsis>
+     <modifier>const</modifier>
+     <type>int</type>
+     <varname linkend="rarentry.constants.attribute-unix-fifo">RarEntry::ATTRIBUTE_UNIX_FIFO</varname>
+     <initializer>4096</initializer>
+    </fieldsynopsis>
+    <fieldsynopsis>
+     <modifier>const</modifier>
+     <type>int</type>
+     <varname linkend="rarentry.constants.attribute-unix-char-dev">RarEntry::ATTRIBUTE_UNIX_CHAR_DEV</varname>
+     <initializer>8192</initializer>
+    </fieldsynopsis>
+    <fieldsynopsis>
+     <modifier>const</modifier>
+     <type>int</type>
+     <varname linkend="rarentry.constants.attribute-unix-directory">RarEntry::ATTRIBUTE_UNIX_DIRECTORY</varname>
+     <initializer>16384</initializer>
+    </fieldsynopsis>
+    <fieldsynopsis>
+     <modifier>const</modifier>
+     <type>int</type>
+     <varname linkend="rarentry.constants.attribute-unix-block-dev">RarEntry::ATTRIBUTE_UNIX_BLOCK_DEV</varname>
+     <initializer>24576</initializer>
+    </fieldsynopsis>
+    <fieldsynopsis>
+     <modifier>const</modifier>
+     <type>int</type>
+     <varname linkend="rarentry.constants.attribute-unix-regular-file">RarEntry::ATTRIBUTE_UNIX_REGULAR_FILE</varname>
+     <initializer>32768</initializer>
+    </fieldsynopsis>
+    <fieldsynopsis>
+     <modifier>const</modifier>
+     <type>int</type>
+     <varname linkend="rarentry.constants.attribute-unix-sym-link">RarEntry::ATTRIBUTE_UNIX_SYM_LINK</varname>
+     <initializer>40960</initializer>
+    </fieldsynopsis>
+    <fieldsynopsis>
+     <modifier>const</modifier>
+     <type>int</type>
+     <varname linkend="rarentry.constants.attribute-unix-socket">RarEntry::ATTRIBUTE_UNIX_SOCKET</varname>
+     <initializer>49152</initializer>
+    </fieldsynopsis>
+
+    <classsynopsisinfo role="comment">&Methods;</classsynopsisinfo>
+    <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.rarentry')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[1])" />
+   </classsynopsis>
+<!-- }}} -->
+
+  </section>
+
+<!-- {{{ RarEntry constants -->
+  <section xml:id="rarentry.constants">
+   &reftitle.constants;
+   <variablelist>
+
+    <varlistentry xml:id="rarentry.constants.host-msdos">
+     <term><constant>RarEntry::HOST_MSDOS</constant></term>
+     <listitem>
+      <para>Se o valor de retorno de <methodname>RarEntry::getHostOs</methodname> for igual a esta constante, o MS-DOS foi usado para
+      adicionar esta entrada. Use em vez de <constant>RAR_HOST_MSDOS</constant>.</para>
+     </listitem>
+    </varlistentry>
+
+    <varlistentry xml:id="rarentry.constants.host-os2">
+     <term><constant>RarEntry::HOST_OS2</constant></term>
+     <listitem>
+      <para>Se o valor de retorno de <methodname>RarEntry::getHostOs</methodname> for igual a esta constante, o OS/2 foi utilizado para
+      adicionar esta entrada. Destinado a substituir <constant>RAR_HOST_OS2</constant>.</para>
+     </listitem>
+    </varlistentry>
+
+    <varlistentry xml:id="rarentry.constants.host-win32">
+     <term><constant>RarEntry::HOST_WIN32</constant></term>
+     <listitem>
+      <para>Se o valor de retorno de <methodname>RarEntry::getHostOs</methodname> for igual a essa constante, o Microsoft Windows foi usado para
+      adicionar essa entrada. Destinado a substituir <constant>RAR_HOST_WIN32</constant>.</para>
+     </listitem>
+    </varlistentry>
+
+    <varlistentry xml:id="rarentry.constants.host-unix">
+     <term><constant>RarEntry::HOST_UNIX</constant></term>
+     <listitem>
+      <para>Se o valor de retorno de <methodname>RarEntry::getHostOs</methodname> for igual a esta constante, um sistema operacional UNIX não especificado foi usado para
+      adicionar esta entrada. Destinado a substituir <constant>RAR_HOST_UNIX</constant>.</para>
+     </listitem>
+    </varlistentry>
+
+    <varlistentry xml:id="rarentry.constants.host-macos">
+     <term><constant>RarEntry::HOST_MACOS</constant></term>
+     <listitem>
+      <para>Se o valor de retorno de <methodname>RarEntry::getHostOs</methodname> for igual a esta constante, o Mac OS foi usado para
+      adicionar esta entrada.</para>
+     </listitem>
+    </varlistentry>
+
+    <varlistentry xml:id="rarentry.constants.host-beos">
+     <term><constant>RarEntry::HOST_BEOS</constant></term>
+     <listitem>
+      <para>Se o valor de retorno de <methodname>RarEntry::getHostOs</methodname> for igual a esta constante, o BeOS foi usado para
+      adicionar esta entrada. Destinado a substituir <constant>RAR_HOST_BEOS</constant>.</para>
+     </listitem>
+    </varlistentry>
+
+    <varlistentry xml:id="rarentry.constants.attribute-win-readonly">
+     <term><constant>RarEntry::ATTRIBUTE_WIN_READONLY</constant></term>
+     <listitem>
+      <para>Bit que representa uma entrada do Windows com um atributo somente leitura. Para ser usado com
+      <methodname>RarEntry::getAttr</methodname> em entradas cujo sistema operacional host é o Microsoft Windows.</para>
+     </listitem>
+    </varlistentry>
+
+    <varlistentry xml:id="rarentry.constants.attribute-win-hidden">
+     <term><constant>RarEntry::ATTRIBUTE_WIN_HIDDEN</constant></term>
+     <listitem>
+      <para>Bit that represents a Windows entry with a hidden attribute. To be used with
+      <methodname>RarEntry::getAttr</methodname> on entries whose host OS is Microsoft Windows.</para>
+     </listitem>
+    </varlistentry>
+
+    <varlistentry xml:id="rarentry.constants.attribute-win-system">
+     <term><constant>RarEntry::ATTRIBUTE_WIN_SYSTEM</constant></term>
+     <listitem>
+      <para>Bit que representa uma entrada do Windows com um atributo oculto. Para ser usado com
+      <methodname>RarEntry::getAttr</methodname> em entradas cujo sistema operacional host é o Microsoft Windows.</para>
+     </listitem>
+    </varlistentry>
+
+    <varlistentry xml:id="rarentry.constants.attribute-win-directory">
+     <term><constant>RarEntry::ATTRIBUTE_WIN_DIRECTORY</constant></term>
+     <listitem>
+      <para>Bit que representa uma entrada do Windows com um atributo de diretório (a entrada é um diretório). Para ser usado com
+      <methodname>RarEntry::getAttr</methodname> em entradas cujo sistema operacional host é o Microsoft Windows. Veja também
+      <methodname>RarEntry::isDirectory</methodname>, que também funciona com entradas que não foram adicionadas no WinRAR.</para>
+     </listitem>
+    </varlistentry>
+
+    <varlistentry xml:id="rarentry.constants.attribute-win-archive">
+     <term><constant>RarEntry::ATTRIBUTE_WIN_ARCHIVE</constant></term>
+     <listitem>
+      <para>Bit que representa uma entrada do Windows com um atributo de arquivo. Para ser usado com
+      <methodname>RarEntry::getAttr</methodname> em entradas cujo sistema operacional host é o Microsoft Windows.</para>
+     </listitem>
+    </varlistentry>
+
+    <varlistentry xml:id="rarentry.constants.attribute-win-device">
+     <term><constant>RarEntry::ATTRIBUTE_WIN_DEVICE</constant></term>
+     <listitem>
+      <para>Bit que representa uma entrada do Windows com um atributo de dispositivo. Para ser usado com
+      <methodname>RarEntry::getAttr</methodname> em entradas cujo sistema operacional host é o Microsoft Windows.</para>
+     </listitem>
+    </varlistentry>
+
+    <varlistentry xml:id="rarentry.constants.attribute-win-normal">
+     <term><constant>RarEntry::ATTRIBUTE_WIN_NORMAL</constant></term>
+     <listitem>
+      <para>Bit que representa uma entrada do Windows com um atributo de arquivo normal (a entrada NÃO é um diretório). Para ser usado com
+      <methodname>RarEntry::getAttr</methodname> em entradas cujo sistema operacional host é o Microsoft Windows. Veja também
+      <methodname>RarEntry::isDirectory</methodname>, que também funciona com entradas que não foram adicionadas no WinRAR.</para>
+     </listitem>
+    </varlistentry>
+
+    <varlistentry xml:id="rarentry.constants.attribute-win-temporary">
+     <term><constant>RarEntry::ATTRIBUTE_WIN_TEMPORARY</constant></term>
+     <listitem>
+      <para>Bit que representa uma entrada do Windows com um atributo temporário. Para ser usado com
+      <methodname>RarEntry::getAttr</methodname> em entradas cujo sistema operacional host é o Microsoft Windows.</para>
+     </listitem>
+    </varlistentry>
+
+    <varlistentry xml:id="rarentry.constants.attribute-win-sparse-file">
+     <term><constant>RarEntry::ATTRIBUTE_WIN_SPARSE_FILE</constant></term>
+     <listitem>
+      <para>Bit que representa uma entrada do Windows com um atributo de arquivo esparso (o arquivo é um arquivo esparso NTFS). Para ser usado com
+      <methodname>RarEntry::getAttr</methodname> em entradas cujo sistema operacional host é o Microsoft Windows.</para>
+     </listitem>
+    </varlistentry>
+
+    <varlistentry xml:id="rarentry.constants.attribute-win-reparse-point">
+     <term><constant>RarEntry::ATTRIBUTE_WIN_REPARSE_POINT</constant></term>
+     <listitem>
+      <para>Bit que representa uma entrada do Windows com um atributo de ponto de nova análise (a entrada é um ponto de nova análise NTFS, por exemplo, uma junção
+      de diretório ou um sistema de arquivos de montagem). Para ser usado com
+      <methodname>RarEntry::getAttr</methodname> em entradas cujo sistema operacional host é o Microsoft Windows.</para>
+     </listitem>
+    </varlistentry>
+
+    <varlistentry xml:id="rarentry.constants.attribute-win-compressed">
+     <term><constant>RarEntry::ATTRIBUTE_WIN_COMPRESSED</constant></term>
+     <listitem>
+      <para>Bit que representa uma entrada do Windows com um atributo compactado (somente NTFS). Para ser usado com
+      <methodname>RarEntry::getAttr</methodname> em entradas cujo sistema operacional host é o Microsoft Windows.</para>
+     </listitem>
+    </varlistentry>
+
+    <varlistentry xml:id="rarentry.constants.attribute-win-offline">
+     <term><constant>RarEntry::ATTRIBUTE_WIN_OFFLINE</constant></term>
+     <listitem>
+      <para>Bit que representa uma entrada do Windows com um atributo offline (a entrada está offline e não acessível). Para ser usado com
+      <methodname>RarEntry::getAttr</methodname> em entradas cujo sistema operacional host é o Microsoft Windows.</para>
+     </listitem>
+    </varlistentry>
+
+    <varlistentry xml:id="rarentry.constants.attribute-win-not-content-indexed">
+     <term><constant>RarEntry::ATTRIBUTE_WIN_NOT_CONTENT_INDEXED</constant></term>
+     <listitem>
+      <para>Bit que representa uma entrada do Windows com um atributo não indexado por conteúdo (a entrada deve ser indexada). Para ser usado com
+      <methodname>RarEntry::getAttr</methodname> em entradas cujo sistema operacional host é o Microsoft Windows.</para>
+     </listitem>
+    </varlistentry>
+
+    <varlistentry xml:id="rarentry.constants.attribute-win-encrypted">
+     <term><constant>RarEntry::ATTRIBUTE_WIN_ENCRYPTED</constant></term>
+     <listitem>
+      <para>Bit que representa uma entrada do Windows com um atributo criptografado (somente NTFS). Para ser usado com
+      <methodname>RarEntry::getAttr</methodname> em entradas cujo sistema operacional host é o Microsoft Windows.</para>
+     </listitem>
+    </varlistentry>
+
+    <varlistentry xml:id="rarentry.constants.attribute-win-virtual">
+     <term><constant>RarEntry::ATTRIBUTE_WIN_VIRTUAL</constant></term>
+     <listitem>
+      <para>Bit que representa uma entrada do Windows com um atributo virtual. Para ser usado com
+      <methodname>RarEntry::getAttr</methodname> em entradas cujo sistema operacional host é o Microsoft Windows.</para>
+     </listitem>
+    </varlistentry>
+
+    <varlistentry xml:id="rarentry.constants.attribute-unix-world-execute">
+     <term><constant>RarEntry::ATTRIBUTE_UNIX_WORLD_EXECUTE</constant></term>
+     <listitem>
+      <para>Bit que representa uma entrada UNIX que é executável mundialmente. Para ser usado com
+      <methodname>RarEntry::getAttr</methodname> em entradas cujo sistema operacional host é UNIX.</para>
+     </listitem>
+    </varlistentry>
+
+    <varlistentry xml:id="rarentry.constants.attribute-unix-world-write">
+     <term><constant>RarEntry::ATTRIBUTE_UNIX_WORLD_WRITE</constant></term>
+     <listitem>
+      <para>Bit que representa uma entrada UNIX que pode ser escrita mundialmente. Para ser usado com
+      <methodname>RarEntry::getAttr</methodname> em entradas cujo sistema operacional host é UNIX.</para>
+     </listitem>
+    </varlistentry>
+
+    <varlistentry xml:id="rarentry.constants.attribute-unix-world-read">
+     <term><constant>RarEntry::ATTRIBUTE_UNIX_WORLD_READ</constant></term>
+     <listitem>
+      <para>Bit que representa uma entrada UNIX legível mundialmente. Para ser usado com
+      <methodname>RarEntry::getAttr</methodname> em entradas cujo sistema operacional host é UNIX.</para>
+     </listitem>
+    </varlistentry>
+
+    <varlistentry xml:id="rarentry.constants.attribute-unix-group-execute">
+     <term><constant>RarEntry::ATTRIBUTE_UNIX_GROUP_EXECUTE</constant></term>
+     <listitem>
+      <para>Bit que representa uma entrada UNIX executável em grupo. Para ser usado com
+      <methodname>RarEntry::getAttr</methodname> em entradas cujo sistema operacional host é UNIX.</para>
+     </listitem>
+    </varlistentry>
+
+    <varlistentry xml:id="rarentry.constants.attribute-unix-group-write">
+     <term><constant>RarEntry::ATTRIBUTE_UNIX_GROUP_WRITE</constant></term>
+     <listitem>
+      <para>Bit que representa uma entrada UNIX que pode ser escrita em grupo. Para ser usado com
+      <methodname>RarEntry::getAttr</methodname> em entradas cujo sistema operacional host é UNIX.</para>
+     </listitem>
+    </varlistentry>
+
+    <varlistentry xml:id="rarentry.constants.attribute-unix-group-read">
+     <term><constant>RarEntry::ATTRIBUTE_UNIX_GROUP_READ</constant></term>
+     <listitem>
+      <para>Bit que representa uma entrada UNIX legível em grupo. Para ser usado com
+      <methodname>RarEntry::getAttr</methodname> em entradas cujo sistema operacional host é UNIX.</para>
+     </listitem>
+    </varlistentry>
+
+    <varlistentry xml:id="rarentry.constants.attribute-unix-owner-execute">
+     <term><constant>RarEntry::ATTRIBUTE_UNIX_OWNER_EXECUTE</constant></term>
+     <listitem>
+      <para>Bit que representa uma entrada UNIX executável pelo proprietário. Para ser usado com
+      <methodname>RarEntry::getAttr</methodname> em entradas cujo sistema operacional host é UNIX.</para>
+     </listitem>
+    </varlistentry>
+
+    <varlistentry xml:id="rarentry.constants.attribute-unix-owner-write">
+     <term><constant>RarEntry::ATTRIBUTE_UNIX_OWNER_WRITE</constant></term>
+     <listitem>
+      <para>Bit que representa uma entrada UNIX que pode ser escrita pelo proprietário. Para ser usado com
+      <methodname>RarEntry::getAttr</methodname> em entradas cujo sistema operacional host é UNIX.</para>
+     </listitem>
+    </varlistentry>
+
+    <varlistentry xml:id="rarentry.constants.attribute-unix-owner-read">
+     <term><constant>RarEntry::ATTRIBUTE_UNIX_OWNER_READ</constant></term>
+     <listitem>
+      <para>Bit que representa uma entrada UNIX legível pelo proprietário. Para ser usado com
+      <methodname>RarEntry::getAttr</methodname> em entradas cujo sistema operacional host é UNIX.</para>
+     </listitem>
+    </varlistentry>
+
+    <varlistentry xml:id="rarentry.constants.attribute-unix-sticky">
+     <term><constant>RarEntry::ATTRIBUTE_UNIX_STICKY</constant></term>
+     <listitem>
+      <para>Bit que representa o sticky bit do UNIX. Para ser usado com
+      <methodname>RarEntry::getAttr</methodname> em entradas cujo sistema operacional host é UNIX.</para>
+     </listitem>
+    </varlistentry>
+
+    <varlistentry xml:id="rarentry.constants.attribute-unix-setgid">
+     <term><constant>RarEntry::ATTRIBUTE_UNIX_SETGID</constant></term>
+     <listitem>
+      <para>Bit que representa o atributo setgid do UNIX. Para ser usado com
+      <methodname>RarEntry::getAttr</methodname> em entradas cujo sistema operacional host é UNIX.</para>
+     </listitem>
+    </varlistentry>
+
+    <varlistentry xml:id="rarentry.constants.attribute-unix-setuid">
+     <term><constant>RarEntry::ATTRIBUTE_UNIX_SETUID</constant></term>
+     <listitem>
+      <para>Bit que representa o atributo setuid do UNIX. Para ser usado com
+      <methodname>RarEntry::getAttr</methodname> em entradas cujo sistema operacional host é UNIX.</para>
+     </listitem>
+    </varlistentry>
+
+    <varlistentry xml:id="rarentry.constants.attribute-unix-final-quartet">
+     <term><constant>RarEntry::ATTRIBUTE_UNIX_FINAL_QUARTET</constant></term>
+     <listitem>
+      <para>Máscara para isolar os últimos quatro bits (nibble) dos atributos UNIX
+      (_S_IFMT, o tipo de máscara de arquivo). Para ser usado com
+      <methodname>RarEntry::getAttr</methodname> em entradas cujo sistema operacional host é UNIX e com as
+      constantes <link linkend="rarentry.constants.attribute-unix-fifo"><constant>RarEntry::ATTRIBUTE_UNIX_FIFO</constant></link>,
+      <link linkend="rarentry.constants.attribute-unix-char-dev"><constant>RarEntry::ATTRIBUTE_UNIX_CHAR_DEV</constant></link>,
+      <link linkend="rarentry.constants.attribute-unix-directory"><constant>RarEntry::ATTRIBUTE_UNIX_DIRECTORY</constant></link>,
+      <link linkend="rarentry.constants.attribute-unix-block-dev"><constant>RarEntry::ATTRIBUTE_UNIX_BLOCK_DEV</constant></link>,
+      <link linkend="rarentry.constants.attribute-unix-regular-file"><constant>RarEntry::ATTRIBUTE_UNIX_REGULAR_FILE</constant></link>,
+      <link linkend="rarentry.constants.attribute-unix-sym-link"><constant>RarEntry::ATTRIBUTE_UNIX_SYM_LINK</constant></link> e
+      <link linkend="rarentry.constants.attribute-unix-socket"><constant>RarEntry::ATTRIBUTE_UNIX_SOCKET</constant></link>.</para>
+     </listitem>
+    </varlistentry>
+
+    <varlistentry xml:id="rarentry.constants.attribute-unix-fifo">
+     <term><constant>RarEntry::ATTRIBUTE_UNIX_FIFO</constant></term>
+     <listitem>
+      <para>FIFOs Unix terão atributos cujos últimos quatro bits possuem este valor. Para ser usado com
+      <methodname>RarEntry::getAttr</methodname> em entradas cujo sistema operacional host é UNIX e com a
+      constante <link linkend="rarentry.constants.attribute-unix-final-quartet">
+      <constant>RarEntry::ATTRIBUTE_UNIX_FINAL_QUARTET</constant></link>.</para>
+     </listitem>
+    </varlistentry>
+
+    <varlistentry xml:id="rarentry.constants.attribute-unix-char-dev">
+     <term><constant>RarEntry::ATTRIBUTE_UNIX_CHAR_DEV</constant></term>
+     <listitem>
+      <para>Dispositivos de caracteres Unix terão atributos cujos últimos quatro bits possuem este valor. Para ser usado com
+      <methodname>RarEntry::getAttr</methodname> em entradas cujo sistema operacional host é UNIX e com a
+      constante <link linkend="rarentry.constants.attribute-unix-final-quartet">
+      <constant>RarEntry::ATTRIBUTE_UNIX_FINAL_QUARTET</constant></link>.</para>
+     </listitem>
+    </varlistentry>
+
+    <varlistentry xml:id="rarentry.constants.attribute-unix-directory">
+     <term><constant>RarEntry::ATTRIBUTE_UNIX_DIRECTORY</constant></term>
+     <listitem>
+      <para>Os diretórios Unix terão atributos cujos últimos quatro bits possuem este valor. Para ser usado com
+      <methodname>RarEntry::getAttr</methodname> em entradas cujo sistema operacional host é UNIX e com a
+      constante <link linkend="rarentry.constants.attribute-unix-final-quartet">
+      <constant>RarEntry::ATTRIBUTE_UNIX_FINAL_QUARTET</constant></link>. Consulte também
+      <methodname>RarEntry::isDirectory</methodname>, que também funciona com entradas que
+      foram adicionadas em outros sistemas operacionais.</para>
+     </listitem>
+    </varlistentry>
+
+    <varlistentry xml:id="rarentry.constants.attribute-unix-block-dev">
+     <term><constant>RarEntry::ATTRIBUTE_UNIX_BLOCK_DEV</constant></term>
+     <listitem>
+      <para>Dispositivos de bloco Unix terão atributos cujos últimos quatro bits possuem este valor. Para ser usado com
+      <methodname>RarEntry::getAttr</methodname> em entradas cujo sistema operacional host é UNIX e com a
+      constante <link linkend="rarentry.constants.attribute-unix-final-quartet">
+      <constant>RarEntry::ATTRIBUTE_UNIX_FINAL_QUARTET</constant></link>.</para>
+     </listitem>
+    </varlistentry>
+
+    <varlistentry xml:id="rarentry.constants.attribute-unix-regular-file">
+     <term><constant>RarEntry::ATTRIBUTE_UNIX_REGULAR_FILE</constant></term>
+     <listitem>
+      <para>Arquivos regulares Unix (não diretórios) terão atributos cujos últimos quatro bits possuem este valor. Para ser usado com
+      <methodname>RarEntry::getAttr</methodname> em entradas cujo sistema operacional host é UNIX e com a
+      constante <link linkend="rarentry.constants.attribute-unix-final-quartet">
+      <constant>RarEntry::ATTRIBUTE_UNIX_FINAL_QUARTET</constant></link>. Consulte também
+      <methodname>RarEntry::isDirectory</methodname>, que também funciona com entradas que
+      foram adicionadas em outros sistemas operacionais.</para>
+     </listitem>
+    </varlistentry>
+
+    <varlistentry xml:id="rarentry.constants.attribute-unix-sym-link">
+     <term><constant>RarEntry::ATTRIBUTE_UNIX_SYM_LINK</constant></term>
+     <listitem>
+      <para>Links simbólicos Unix terão atributos cujos últimos quatro bits possuem este valor. Para ser usado com
+      <methodname>RarEntry::getAttr</methodname> em entradas cujo sistema operacional host é UNIX e com a
+      constante <link linkend="rarentry.constants.attribute-unix-final-quartet">
+      <constant>RarEntry::ATTRIBUTE_UNIX_FINAL_QUARTET</constant></link>.</para>
+     </listitem>
+    </varlistentry>
+
+    <varlistentry xml:id="rarentry.constants.attribute-unix-socket">
+     <term><constant>RarEntry::ATTRIBUTE_UNIX_SOCKET</constant></term>
+     <listitem>
+      <para>Os soquetes Unix terão atributos cujos últimos quatro bits possuem este valor. Para ser usado com
+      <methodname>RarEntry::getAttr</methodname> em entradas cujo sistema operacional host é UNIX e com a
+      constante <link linkend="rarentry.constants.attribute-unix-final-quartet">
+      <constant>RarEntry::ATTRIBUTE_UNIX_FINAL_QUARTET</constant></link>.</para>
+     </listitem>
+    </varlistentry>
+
+   </variablelist>
+  </section>
+<!-- }}} -->
+
+
+ </partintro>
+
+ &reference.rar.entities.rarentry;
+
+</phpdoc:classref>
+
+<!-- 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
+-->

reference/rar/rarexception.xml

@@ -0,0 +1,159 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- EN-Revision: 708c4884f2400b7f788b728ea2fa73ea8aa789bb Maintainer: fernandowobeto Status: ready --><!-- CREDITS: fernandowobeto -->
+
+<phpdoc:classref xml:id="class.rarexception" xmlns:phpdoc="http://php.net/ns/phpdoc" 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 RarException</title>
+ <titleabbrev>RarException</titleabbrev>
+
+ <partintro>
+
+<!-- {{{ RarException intro -->
+  <section xml:id="rarexception.intro">
+   &reftitle.intro;
+   <para>
+    Esta classe tem dois propósitos: é o tipo de exceções lançadas pelas funções e
+    métodos da extensão RAR e permite, através de métodos estáticos consultar e definir o comportamento de erro
+    da extensão, ou seja, se exceções são lançadas ou apenas avisos são emitidos.
+   </para>
+   <para>
+    Os seguintes códigos de erro são usados:
+   </para>
+   <itemizedlist>
+    <listitem>
+     <simpara>
+      -1 - erro fora da biblioteca UnRAR
+     </simpara>
+    </listitem>
+    <listitem>
+     <simpara>
+      11 - memória insuficiente
+     </simpara>
+    </listitem>
+
+    <listitem>
+     <simpara>
+      12 - dados ruins
+     </simpara>
+    </listitem>
+
+    <listitem>
+     <simpara>
+      13 - arquivo ruim
+     </simpara>
+    </listitem>
+
+    <listitem>
+     <simpara>
+      14 - formato desconhecido
+     </simpara>
+    </listitem>
+
+    <listitem>
+     <simpara>
+      15 - erro ao abrir arquivo
+     </simpara>
+    </listitem>
+
+    <listitem>
+     <simpara>
+      16 - erro de criação de arquivo
+     </simpara>
+    </listitem>
+
+    <listitem>
+     <simpara>
+      17 - erro de fechamento de arquivo
+     </simpara>
+    </listitem>
+
+    <listitem>
+     <simpara>
+      18 - erro de leitura
+     </simpara>
+    </listitem>
+     <listitem>
+     <simpara>
+      19 - erro de gravação
+     </simpara>
+    </listitem>
+
+    <listitem>
+     <simpara>
+      20 - buffer muito pequeno
+     </simpara>
+    </listitem>
+
+    <listitem>
+     <simpara>
+      21 - erro RAR desconhecido
+     </simpara>
+    </listitem>
+
+    <listitem>
+     <simpara>
+      22 - senha necessária, mas não fornecida
+     </simpara>
+    </listitem>
+   </itemizedlist>
+  </section>
+<!-- }}} -->
+
+  <section xml:id="rarexception.synopsis">
+   &reftitle.classsynopsis;
+
+<!-- {{{ Synopsis -->
+   <classsynopsis>
+    <ooclass><classname>RarException</classname></ooclass>
+
+<!-- {{{ Class synopsis -->
+    <classsynopsisinfo>
+     <ooclass>
+      <modifier>final</modifier>
+      <classname>RarException</classname>
+     </ooclass>
+
+     <ooclass>
+      <modifier>extends</modifier>
+      <classname>Exception</classname>
+     </ooclass>
+    </classsynopsisinfo>
+<!-- }}} -->
+
+    <classsynopsisinfo role="comment">&Methods;</classsynopsisinfo>
+    <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.rarexception')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[1])" />
+
+    <classsynopsisinfo role="comment">&InheritedMethods;</classsynopsisinfo>
+    <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.exception')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[1])" />
+
+   </classsynopsis>
+<!-- }}} -->
+
+  </section>
+
+ </partintro>
+
+ &reference.rar.entities.rarexception;
+
+</phpdoc:classref>
+
+<!-- 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
+-->

reference/rar/reference.xml

@@ -0,0 +1,29 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- EN-Revision: bd0c7e71a2452e3046d917b65b647afabf32949b Maintainer: fernandowobeto Status: ready --><!-- CREDITS: fernandowobeto -->
+
+<reference xml:id="ref.rar" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
+ <title>&Functions; de Rar</title>
+
+ &reference.rar.entities.functions;
+
+</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
+-->

reference/rar/setup.xml

@@ -0,0 +1,91 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- EN-Revision: d3ad869d16be772d43d85a8c982592b4a57a085a Maintainer: fernandowobeto Status: ready --><!-- CREDITS: fernandowobeto -->
+
+<chapter xml:id="rar.setup" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
+ &reftitle.setup;
+
+ <!-- {{{ Requirements -->
+ <section xml:id="rar.requirements">
+  &reftitle.required;
+  &no.requirement;
+ </section>
+ <!-- }}} -->
+
+ <!-- {{{ Installation -->
+ <section xml:id="rar.installation">
+  &reftitle.install;
+  <para>
+   Rar está atualmente disponível através do PECL
+   <link xlink:href="&url.pecl.package;rar">&url.pecl.package;rar</link>.
+  </para>
+  <para>
+   Além disso, você pode usar o instalador PECL para instalar a extensão Rar,
+   usando o seguinte comando: <command>pecl -v install rar</command>.
+  </para>
+  <para>
+   Você sempre pode baixar o pacote <filename>tar.gz</filename> e instalar o Rar manualmente:
+   <example>
+    <title>Instalação Rar</title>
+    <programlisting role="shell">
+<![CDATA[
+gunzip rar-xxx.tgz
+tar -xvf rar-xxx.tar
+cd rar-xxx
+phpize
+./configure && make && make install
+]]>
+    </programlisting>
+   </example>
+  </para>
+  <para>
+   Os usuários do Windows ativarão o <filename>php_rar.dll</filename> dentro
+   do &php.ini; para usar essas funções.
+   &pecl.windows.download;
+  </para>
+ </section>
+ <!-- }}} -->
+
+ <!-- {{{ Configuration -->
+ &reference.rar.ini;
+ <!-- }}} -->
+
+ <!-- {{{ Resources -->
+ <section xml:id="rar.resources">
+  &reftitle.resources;
+  <para>
+   Esta extensão registra três classes internas:
+   as representações de arquivo retornadas por <function>rar_open</function> –
+   <type>RarArchive</type>, as representações de entrada retornadas por
+   <function>rar_list</function> e <function>rar_entry_get</function> –
+   <type>RarEntry</type> e o tipo de exceção <type>RarException</type>.
+  </para>
+  <para>
+   Esta extensão também registra um recurso de fluxo, denominado "rar" e um wrapper de
+   URL denominado "rar wrapper" e registrado sob o prefixo "rar".
+  </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
+-->
+