svn: /phpdoc/pt_BR/trunk/reference/zip/ configure.xml constants.xml examples.xml functions/zip-entry-read.xml functions/zip-open.xml functions/zip-read.xml setup.xml

Modified: phpdoc/pt_BR/trunk/reference/zip/configure.xml
===================================================================
--- phpdoc/pt_BR/trunk/reference/zip/configure.xml	2019-10-06 11:16:22 UTC (rev 348138)
+++ phpdoc/pt_BR/trunk/reference/zip/configure.xml	2019-10-06 13:48:42 UTC (rev 348139)
@@ -1,50 +1,26 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- EN-Revision: 297028 Maintainer: felipe Status: ready -->
+<!-- EN-Revision: 346299 Maintainer: felipe Status: ready --><!-- CREDITS: @lisaldo -->
 <section xml:id="zip.installation" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  &reftitle.install;

- <section xml:id="zip.old.installation">
-  <title>PHP 4</title>
+ <section xml:id="zip.installation.new">

-  <note>
-   <para>
-    O suporte a Zip antes do PHP 4.1.0 é experimental.
-   </para>
-  </note>
-
-  <warning>
-   <para>
-    Por causa da extensão zip no PHP 4 zip não ser mantida nós recomendamos que a
-    extensão PECL seja usada.
-   </para>
-  </warning>
-
-  <section xml:id="zip.installation.old.linux">
+  <section xml:id="zip.installation.new.linux">
    <title>Sistemas Linux</title>
    <para>
-    Para usar estas funções você precisa compilar o PHP com suporte a zip
-    usando a opção de configuração <option role="configure">--with-zip[=DIR]</option>,
-    onde [DIR] é o prefixo da biblioteca instalada ZZIPlib. <!-- Removed link to fix the build ~sobak 12/06/2016 -->
+    Para utilizar esta função com suporte ao zip é necessário compilar o PHP
+    utilizando a opção de configuração
+    <option role="configure">--enable-zip</option>
    </para>
-  </section>
-
-  <section xml:id="zip.installation.old.windows">
-   <title>Windows</title>
    <para>
-    Usuários Windows precisam habilitar <filename>php_zip.dll</filename> no
-    &php.ini; para usar estas funções.
+    A partir do PHP 5.6.0 a configuração <option role="configure">--with-libzip=DIR</option>
+    foi adicionada para utilizar uma instalação do libzip do sistema. É preciso
+    ter a versão 0.11, sendo a 0.11.2 ou superior a recomendada.
    </para>
-  </section>
- </section>
-
- <section xml:id="zip.installation.new">
-  <title>PHP 5.2.0 e superior</title>
-
-  <section xml:id="zip.installation.new.linux">
-   <title>Sistemas Linux</title>
    <para>
-    Para usar estas funções você precisa compilar o PHP com suporte a zip
-    usando a opção de configuração <option role="configure">--enable-zip</option>.
+    A partir do PHP 7.3.0, compilar sem a libzip interna não é recomendado, mas
+    ainda possível adicionando a opção
+    <option role="configure">--without-libzip</option>
    </para>
   </section>

@@ -51,8 +27,9 @@
   <section xml:id="zip.installation.new.windows">
    <title>Windows</title>
    <para>
-    Usuários Windows precisam habilitar <filename>php_zip.dll</filename> no
-    &php.ini; para usar estas funções.
+    A partir do PHP 5.3, esta extensão se tornou interna do PHP. Antes,
+    os usuários do Windows precisavem habilitar <filename>php_zip.dll</filename> dentro
+    do &php.ini; para utilizar esta função;
    </para>
   </section>
  </section>
@@ -63,11 +40,6 @@
    &pecl.info;
    <link xlink:href="&url.pecl.package;zip">&url.pecl.package;zip</link>.
   </para>
-  <para>
-   &pecl.windows.download;
-  </para>
-  <para>
-  </para>
  </section>

 </section>

Modified: phpdoc/pt_BR/trunk/reference/zip/constants.xml
===================================================================
--- phpdoc/pt_BR/trunk/reference/zip/constants.xml	2019-10-06 11:16:22 UTC (rev 348138)
+++ phpdoc/pt_BR/trunk/reference/zip/constants.xml	2019-10-06 13:48:42 UTC (rev 348139)
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 342244 Maintainer: ae Status: ready --><!-- CREDITS: felipe,ae -->
+<!-- EN-Revision: 344995 Maintainer: ae Status: ready --><!-- CREDITS: felipe, ae, @lisaldo -->
 <appendix xml:id="zip.constants" xmlns="http://docbook.org/ns/docbook">
  &reftitle.constants;
  &extension.constants;
@@ -31,8 +31,8 @@
    </term>
    <listitem>
     <simpara>
-     Sempre inicia um novo arquivo, este modo sobreescreverá o arquivo se
-     ele já existir.
+     Se o arquivo existir, ignora o conteúdo atual.
+     Em outras palavras, funciona da mesma fora que um arquivo vazio
     </simpara>
    </listitem>
   </varlistentry>

Modified: phpdoc/pt_BR/trunk/reference/zip/examples.xml
===================================================================
--- phpdoc/pt_BR/trunk/reference/zip/examples.xml	2019-10-06 11:16:22 UTC (rev 348138)
+++ phpdoc/pt_BR/trunk/reference/zip/examples.xml	2019-10-06 13:48:42 UTC (rev 348139)
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- EN-Revision: 297028 Maintainer: felipe Status: ready -->
+<!-- EN-Revision: 330320 Maintainer: felipe Status: ready --><!-- CREDITS: @lisaldo -->

 <chapter xml:id="zip.examples" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  &reftitle.examples;
@@ -12,7 +12,7 @@
 $zip = new ZipArchive();
 $filename = "./test112.zip";

-if ($zip->open($filename, ZIPARCHIVE::CREATE)!==TRUE) {
+if ($zip->open($filename, ZipArchive::CREATE)!==TRUE) {
     exit("cannot open <$filename>\n");
 }

@@ -82,7 +82,8 @@
   Este exemplo usa a velha API (PHP 4), ela abre um arquivo ZIP,
   ler cada arquivo do arquivo e imprime o conteúdo deles.
   O arquivo <filename>test2.zip</filename> usado neste exemplo
-  é um arquivo de teste do fonte da distruição ZZIPlib.
+  é um arquivo de teste do fonte da distruição
+  ZZIPlib.
  </para>
  <example>
   <title>Exemplo de uso</title>

Modified: phpdoc/pt_BR/trunk/reference/zip/functions/zip-entry-read.xml
===================================================================
--- phpdoc/pt_BR/trunk/reference/zip/functions/zip-entry-read.xml	2019-10-06 11:16:22 UTC (rev 348138)
+++ phpdoc/pt_BR/trunk/reference/zip/functions/zip-entry-read.xml	2019-10-06 13:48:42 UTC (rev 348139)
@@ -1,5 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- EN-Revision: 297028 Maintainer: felipe Status: ready -->
+<!-- EN-Revision: 330312 Maintainer: felipe Status: ready -->
+<!-- splitted from ./en/functions/zip.xml, last change in rev 1.11 -->
   <refentry xml:id="function.zip-entry-read" xmlns="http://docbook.org/ns/docbook">
    <refnamediv>
     <refname>zip_entry_read</refname>
@@ -10,7 +11,7 @@
      <methodsynopsis>
       <type>string</type><methodname>zip_entry_read</methodname>
       <methodparam><type>resource</type><parameter>zip_entry</parameter></methodparam>
-      <methodparam choice="opt"><type>int</type><parameter>length</parameter></methodparam>
+      <methodparam choice="opt"><type>int</type><parameter>length</parameter><initializer>1024</initializer></methodparam>
      </methodsynopsis>
     <para>
      Lê de um arquivo aberto.
@@ -32,8 +33,7 @@
      <term><parameter>length</parameter></term>
      <listitem>
       <para>
-       O número de bytes para retornar. Se não especificado, esta função irá
-       tentar ler 1024 bytes.
+       O número de bytes para retornar.
     </para>
     <note>
      <para>
@@ -48,7 +48,7 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
     <para>
-     Retorna a informação lida, ou &false; se o fim do arquivo for encontrado.
+     Retorna a informação lida, string vazia no fim de um arquivo, ou &false; em caso de erro.
     </para>
  </refsect1>
  <refsect1 role="seealso">

Modified: phpdoc/pt_BR/trunk/reference/zip/functions/zip-open.xml
===================================================================
--- phpdoc/pt_BR/trunk/reference/zip/functions/zip-open.xml	2019-10-06 11:16:22 UTC (rev 348138)
+++ phpdoc/pt_BR/trunk/reference/zip/functions/zip-open.xml	2019-10-06 13:48:42 UTC (rev 348139)
@@ -1,5 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- EN-Revision: 297028 Maintainer: felipe Status: ready -->
+<!-- EN-Revision: 323289 Maintainer: felipe Status: ready -->
+<!-- splitted from ./en/functions/zip.xml, last change in rev 1.11 -->
   <refentry xml:id="function.zip-open" xmlns="http://docbook.org/ns/docbook">
    <refnamediv>
     <refname>zip_open</refname>
@@ -8,7 +9,7 @@
  <refsect1 role="description">
   &reftitle.description;
      <methodsynopsis>
-      <type>mixed</type><methodname>zip_open</methodname>
+      <type>resource</type><methodname>zip_open</methodname>
       <methodparam><type>string</type><parameter>filename</parameter></methodparam>
      </methodsynopsis>
     <para>
@@ -33,7 +34,7 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
     <para>
-     Retorna a conexão com o arquivo que será usado com as funções
+     Retorna a conexão com o arquivo que será usado com as funções
      <function>zip_read</function> e <function>zip_close</function>
      ou retorna o número de erros se <parameter>filename</parameter> não existir
      or em outro caso erro.

Modified: phpdoc/pt_BR/trunk/reference/zip/functions/zip-read.xml
===================================================================
--- phpdoc/pt_BR/trunk/reference/zip/functions/zip-read.xml	2019-10-06 11:16:22 UTC (rev 348138)
+++ phpdoc/pt_BR/trunk/reference/zip/functions/zip-read.xml	2019-10-06 13:48:42 UTC (rev 348139)
@@ -1,5 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- EN-Revision: 297028 Maintainer: felipe Status: ready -->
+<!-- EN-Revision: 323290 Maintainer: felipe Status: ready --><!-- CREDITS: @lisaldo -->
+<!-- splitted from ./en/functions/zip.xml, last change in rev 1.11 -->
   <refentry xml:id="function.zip-read" xmlns="http://docbook.org/ns/docbook">
    <refnamediv>
     <refname>zip_read</refname>
@@ -8,7 +9,7 @@
  <refsect1 role="description">
   &reftitle.description;
      <methodsynopsis>
-      <type>mixed</type><methodname>zip_read</methodname>
+      <type>resource</type><methodname>zip_read</methodname>
       <methodparam><type>resource</type><parameter>zip</parameter></methodparam>
      </methodsynopsis>
     <para>
@@ -34,8 +35,9 @@
   &reftitle.returnvalues;
     <para>
      Retorna uma conexao com o arquivo ZIP para ser usado com as funções
-     <literal>zip_entry_...</literal> ou &false; se não houver
-     arquivos para serem lidos ou número de erros no caso de outro erro.
+     <literal>zip_entry_...</literal>, ou &false; se não houver
+     arquivos para serem lidos, ou um código de erro caso ocorra
+     algum.
     </para>
  </refsect1>
  <refsect1 role="seealso">

Modified: phpdoc/pt_BR/trunk/reference/zip/setup.xml
===================================================================
--- phpdoc/pt_BR/trunk/reference/zip/setup.xml	2019-10-06 11:16:22 UTC (rev 348138)
+++ phpdoc/pt_BR/trunk/reference/zip/setup.xml	2019-10-06 13:48:42 UTC (rev 348139)
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- EN-Revision: 288721 Maintainer: felipe Status: ready -->
+<!-- EN-Revision: 339992 Maintainer: felipe Status: ready --><!-- CREDITS: @lisaldo -->

 <chapter xml:id="zip.setup" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  &reftitle.setup;
@@ -7,15 +7,10 @@
  <!-- {{{ Requirements -->
  <section xml:id="zip.requirements">
   &reftitle.required;
-  <!-- Already removed PHP 4 section to fix the build ~sobak 12/06/2016 -->
-
-  <section xml:id="zip.requirements.new">
-   <title>PHP 5.2.0 ou superior</title>
-   <para>
-    Esta extenção usa funções da <link xlink:href="&url.zlib;">zlib</link>
-    criada por Jean-loup Gailly e Mark Adler.
-   </para>
-  </section>
+  <para>
+    Esta extensão tem como requisito a biblioteca <link xlink:href="&url.libzip;">libzip</link> que
+    vem com o PHP.
+  </para>
  </section>
  <!-- }}} -->

@@ -34,7 +29,7 @@
  <section xml:id="zip.resources">
   &reftitle.resources;
   <para>
-   Há dois tipos de tipos resource usada neste módulo. O primeiro é
+   Há dois tipos de tipos de recursos neste módulo. O primeiro é
    um Zip directory para arquivo Zip, o segundo Zip Entry para
    entradas de arquivos.
   </para>