cvs: phpdoc /en/reference/zlib constants.xml ini.xml reference.xml
| From: | Andr� Luis Ferreira da Silva Bacci | Date: | Thu, 10 Oct 2002 05:01:32 +0000 |
| Subject: | cvs: phpdoc /en/reference/zlib constants.xml ini.xml reference.xml | ||
| Groups: | php.doc | ||
| Request: | Send a blank email to phpdoc+get-969349097@lists.php.net to get a copy of this message | ||
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 - >= à 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 >= 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";
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 - >= à 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 >= 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";