[PHP-DOC] cvs: phpdoc /en/reference/zlib constants.xml ini.xml reference.xml

[Andr� Luis Ferreira da Silva Bacci]

ae              Thu Oct 10 01:01:32 2002 EDT

  Modified files:              
    /phpdoc/en/reference/zlib   constants.xml ini.xml reference.xml 
  Log:
  reverting incorrect commit
  
  
Index: phpdoc/en/reference/zlib/constants.xml
diff -u phpdoc/en/reference/zlib/constants.xml:1.3 
phpdoc/en/reference/zlib/constants.xml:1.4
--- phpdoc/en/reference/zlib/constants.xml:1.3  Thu Oct 10 00:43:15 2002
+++ phpdoc/en/reference/zlib/constants.xml      Thu Oct 10 01:01:31 2002
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- EN-Revision: 1.31 Maintainer: ernani Status: ready -->
+<!-- $Revision: 1.4 $ -->
 <section id="zlib.constants">
  &reftitle.constants;
  &extension.constants;
@@ -7,7 +7,7 @@
   <varlistentry>
    <term>
     <constant>FORCE_GZIP</constant> 
-    (<link linkend="language.types.integer">inteiro</link>)
+    (<link linkend="language.types.integer">integer</link>)
    </term>
    <listitem>
     <simpara>
@@ -18,7 +18,7 @@
   <varlistentry>
    <term>
     <constant>FORCE_DEFLATE</constant> 
-    (<link linkend="language.types.integer">inteiro</link>)
+    (<link linkend="language.types.integer">integer</link>)
    </term>
    <listitem>
     <simpara>
Index: phpdoc/en/reference/zlib/ini.xml
diff -u phpdoc/en/reference/zlib/ini.xml:1.2 phpdoc/en/reference/zlib/ini.xml:1.3
--- phpdoc/en/reference/zlib/ini.xml:1.2        Thu Oct 10 00:43:33 2002
+++ phpdoc/en/reference/zlib/ini.xml    Thu Oct 10 01:01:31 2002
@@ -1,21 +1,21 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- EN-Revision: 1.11 Maintainer: ernani Status: ready -->
+<!-- $Revision: 1.3 $ -->
 <section id="zlib.configuration">
  &reftitle.runtime;
  &extension.runtime;
  <para>
-  A extens�o zlib oferece a op��o de comprimir transparentemente
-  suas p�ginas em tempo real, se o navegador requisitante suportar isto.
-  Ent�o existem tr�s op��es no <link
-  linkend="configuration.file">arquivo de configura��o</link> &php.ini;.
+  The zlib extension offers the option to transparently compress
+  your pages on-the-fly, if the requesting browser supports
+  this. Therefore there are three options in the <link
+  linkend="configuration.file">configuration file</link> &php.ini;.
    <table>
-   <title>Op��es de Configura��o da Zlib</title>
+   <title>Zlib Configuration Options</title>
    <tgroup cols="3">
     <thead>
      <row>
-      <entry>Nome</entry>
-      <entry>Padr�o</entry>
-      <entry>Modific�vel</entry>
+      <entry>Name</entry>
+      <entry>Default</entry>
+      <entry>Changeable</entry>
      </row>
     </thead>
     <tbody>
@@ -37,43 +37,43 @@
     </tbody>
    </tgroup>
   </table>
-   Para maiores detalhes e defini��es das constantes PHP_INI_* veja a fun��o
+   For further details and definition of the PHP_INI_* constants see
   <function>ini_set</function>.
 </para>
  <para>
- Aqui est� uma breve explica��o das diretrizes de configura��o.
+ Here is a short explanation of the configuration directives.
  <variablelist>
   <varlistentry id="ini.zlib.output-compression">
    <term>
     <parameter>zlib.output_compression</parameter>
-    <type>booleano</type>/<type>inteiro</type>
+    <type>boolean</type>/<type>integer</type>
    </term>
    <listitem>
     <para>
-     Serve para comprimir p�ginas de modo transparente. Se esta op��o for
-     mudada para "On" no &php.ini; ou na configura��o do Apache, as p�ginas ser�o
-     comprimidas se o navegador enviar um cabe�alho "Accept-Encoding: gzip" ou
-     "deflate". "Content-Encoding: gzip" (respectivamente
-     "deflate") e cabe�alhos "Vary: Accept-Encoding" ser�o adicionados para
-     a saida.
+     Whether to transparently compress pages. If this option is set
+     to "On" in &php.ini; or the Apache configuration, pages are
+     compressed if the browser sends an "Accept-Encoding: gzip" or
+     "deflate" header. "Content-Encoding: gzip" (respectively
+     "deflate") and "Vary: Accept-Encoding" headers are added to
+     the output.
     </para>
     <para>
-     Voc� pode usar a fun��o <function>ini_set</function> para desabilitar isto em
-     seu script se os cabe�alhos ainda n�o foram enviados. Se voc� enviar um 
cabe�alho � sa�da
-     "Content-Type: image/" a compress�o ser� desabilitada,
-     tamb�m (para corrigir um defeito do Netscape). Voc� pode reabilitar
-     isto, se voc� adicionar a fun��o "ini_set('zlib.output_compression', 'On')"
-     depois da chamada do cabe�alho que que foi adicionado o content-type da imagem.
+     You can use <function>ini_set</function> to disable this in
+     your script if the headers aren't already sent. If you output
+     a "Content-Type: image/" header the compression is disabled,
+     too (in order to circumvent a Netscape bug). You can reenable
+     it, if you add "ini_set('zlib.output_compression', 'On')"
+     after the header call which added the image content-type.
     </para>
     <para>
-     Esta op��o tamb�m aceita valores inteiros em vez de valores booleanos
-     "On"/"Off", usando isto voc� pode configurar o tamanho do buffer de sa�da
-     (o padr�o � 4KB).
+     This option also accepts integer values instead of boolean
+     "On"/"Off", using this you can set the output buffer size
+     (default is 4KB).
     </para>
     <note>
      <para>
-      <link linkend="ini.output-handler">output_handler</link> deve estar
-      vazio se a diretriz estiver configurada em 'On'! Em vez disto voc� deve usar 
zlib.output_handler.
+      <link linkend="ini.output-handler">output_handler</link> must be 
+      empty if this is set 'On' ! Instead you must use zlib.output_handler.
      </para>
     </note>
    </listitem>
@@ -82,11 +82,11 @@
   <varlistentry id="ini.zlib.output-compression-level">
    <term>
     <parameter>zlib.output_compression_level</parameter>
-    <type>inteiro</type>
+    <type>integer</type>
    </term>
    <listitem>
     <para>
-     N�vel de compress�o usado para as sa�das.
+     Compression level used for transparent output compression.
     </para>
    </listitem>
   </varlistentry>
@@ -98,9 +98,9 @@
    </term>
    <listitem>
     <para>
-     Voc� n�o pode especificar tratamentos adicionais de sa�da se 
zlib.output_compression
-     for ativado. Esta configura��o faz o mesmo que a <link 
linkend="ini.output-handler">
-     output_handler</link> mas em uma ordem diferente.
+     You cannot specify additional output handlers if zlib.output_compression
+     is activated here. This setting does the same as <link 
+linkend="ini.output-handler">
+     output_handler</link> but in a different order.
     </para>
    </listitem>
   </varlistentry>
Index: phpdoc/en/reference/zlib/reference.xml
diff -u phpdoc/en/reference/zlib/reference.xml:1.9 
phpdoc/en/reference/zlib/reference.xml:1.10
--- phpdoc/en/reference/zlib/reference.xml:1.9  Thu Oct 10 00:43:47 2002
+++ phpdoc/en/reference/zlib/reference.xml      Thu Oct 10 01:01:31 2002
@@ -1,36 +1,36 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- EN-Revision: 1.11 Maintainer: ernani Status: ready -->
+<!-- $Revision: 1.10 $ -->
  <reference id="ref.zlib">
-  <title>Fun��es de Compress�o Zlib</title>
+  <title>Zlib Compression Functions</title>
   <titleabbrev>Zlib</titleabbrev>
 
   <partintro>
    <section id="zlib.intro">
     &reftitle.intro;
     <para>
-     Este m�dulo lhe possibilita ler e gerar transparentemente
-     arquivos comprimidos do tipo gzip (.gz), atrav�s de muitas das
-     fun��es <link linkend="ref.filesystem">filesystem</link>
-     nas quais funcionam com arquivos gzip comprimidos (e arquivos n�o comprimidos
-     tamb�m, mas n�o com sockets).
+     This module enables you to transparently read and write
+     gzip (.gz) compressed files, through versions of most of
+     the <link linkend="ref.filesystem">filesystem</link> functions
+     which work with gzip-compressed files (and uncompressed files,
+     too, but not with sockets).
     </para>
     <note>
      <para>
-      A Vers�o 4.0.4 introduziu a fun��o fopen-wrapper para arquivos .gz, ent�o
-      voc� pode usar o prefixo 'zlib:' especial para acessar arquivos comprimidos
-      transparentemente usando as fun��es normais de acesso a arquivos f*() se
-      voc� concatenar o nome do arquivo e ou seu caminho com o prefixo 'zlib:' quando 
usar a fun��o
+      Version 4.0.4 introduced a fopen-wrapper for .gz-files, so that
+      you can use a special 'zlib:' URL to access compressed files
+      transparently using the normal f*() file access functions if you
+      prepend the filename or path with a 'zlib:' prefix when calling
       <function>fopen</function>.
      </para>
      <para>
-      Na vers�o 4.3.0, este prefixo especial foi mudado para 'zlib://'
-      para previnir ambiguidades com nome de arquivos contendo ':'.
+      In version 4.3.0, this special prefix has been changed to 'zlib://'
+      to prevent ambiguities with filenames containing ':'.
      </para>
      <para>
-      Esta facilidade requer uma biblioteca em tempo de execu��o que prov� a fun��o
-      <literal>fopencookie()</literal>. Em meu conhecimento atual
-      a GNU libc � a �nica bliblioteca que prov�
-      esta facilidade.
+      This feature requires a C runtime library that provides the
+      <literal>fopencookie()</literal> function. To my current
+      knowledge the GNU libc is the only library that provides
+      this feature.
      </para>
     </note>
    </section>
@@ -38,9 +38,9 @@
    <section id="zlib.requirements">
     &reftitle.required;
     <para>
-     Este m�dulo usa as fun��es da <ulink url="&url.zlib;">zlib</ulink>
-     por Jean-loup Gailly e Mark Adler. Voc� ter� que usar uma vers�o zlib
-     &gt;= � 1.0.9 com este m�dulo.
+     This module uses the functions of <ulink url="&url.zlib;">zlib</ulink>
+     by Jean-loup Gailly and Mark Adler. You have to use a zlib
+     version &gt;= 1.0.9 with this module.
     </para>
    </section>
 
@@ -56,42 +56,42 @@
    <section id="zlib.examples">
     &reftitle.examples;
     <para>
-     Este exemplo abre um arquivo tempor�rio e gera uma string teste
-     dentro dele, ent�o ela mostra o conte�do deste arquivo duas vezes.
+     This example opens a temporary file and writes a test string 
+     to it, then it prints out the content of this file twice.
     </para>
     <example>
-     <title>Pequeno Exemplo das fun��es Zlib</title>
+     <title>Small Zlib Example</title>
      <programlisting role="php">
 <![CDATA[
 <?php
 
-$filename = tempnam ('/tmp', 'zlibteste').'.gz';
+$filename = tempnam ('/tmp', 'zlibtest').'.gz';
 print "<html>\n<head></head>\n<body>\n<pre>\n";
-$s = "Somente um teste, teste, teste, teste, teste, teste, teste, teste!\n";
+$s = "Only a test, test, test, test, test, test, test, test!\n";
 
-// abre o arquivo para gerar ele com a compress�o m�xima
+// open file for writing with maximum compression
 $zp = gzopen($filename, "w9");
 
-// escreve a string no arquivo
+// write string to file
 gzwrite($zp, $s);
 
-// fecha o arquivo
+// close file
 gzclose($zp);
 
-// abre o arquivo para leitura
+// open file for reading
 $zp = gzopen($filename, "r");
 
-// l� 3 caracteres
+// read 3 char
 print gzread($zp, 3);
 
-// mostra o conte�do at� o fim do arquivo e o fecha.
+// output until end of the file and close it.
 gzpassthru($zp);
 
 print "\n";
 
-// abre o arquivo e imprime o conte�do dele (pela segunda vez).
+// open file and print content (the 2nd time).
 if (readgzfile($filename) != strlen($s)) {
-        echo "Erro com as fun��es zlib!";
+        echo "Error with zlib functions!";
 }
 unlink($filename);
 print "</pre>\n</h1></body>\n</html>\n";


-- 
PHP Documentation Mailing List (http://www.php.net/)
To unsubscribe, visit: http://www.php.net/unsub.php