cucinato Sun Jul 11 18:47:21 2004 EDT
Modified files: /phpdoc/en/reference/zlib ini.xml reference.xml /phpdoc/en/reference/zlib/functions gzclose.xml gzcompress.xml gzdeflate.xml gzencode.xml Log: Sync to EN tree
http://cvs.php.net/diff.php/phpdoc/en/reference/zlib/ini.xml?r1=1.7&r2=1.8&ty=u Index: phpdoc/en/reference/zlib/ini.xml diff -u phpdoc/en/reference/zlib/ini.xml:1.7 phpdoc/en/reference/zlib/ini.xml:1.8 --- phpdoc/en/reference/zlib/ini.xml:1.7 Mon May 31 13:13:24 2004 +++ phpdoc/en/reference/zlib/ini.xml Sun Jul 11 18:47:20 2004 @@ -1,21 +1,21 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.7 $ --> +<!-- EN-Revision: 1.7 Maintainer: cucinato Status: ready --> <section id="zlib.configuration"> &reftitle.runtime; &extension.runtime; <para> - 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;. + L'estensione zlib permette di comprimere in modo trasparente + le pagine on-the-fly, se il browser supporta questa + funzionalità. Quindi ci sono due opzioni nel <link + linkend="configuration.file">file di configurazione</link> &php.ini;. <table> - <title>Zlib Configuration Options</title> + <title>Opzioni di configurazione di Zlib</title> <tgroup cols="3"> <thead> <row> - <entry>Name</entry> + <entry>Nome</entry> <entry>Default</entry> - <entry>Changeable</entry> + <entry>Configurabile in</entry> </row> </thead> <tbody> @@ -37,7 +37,7 @@ </tbody> </tgroup> </table> - For further details and definition of the PHP_INI_* constants see + Per ulteriori dettagli e definizioni delle costanti PHP_INI_* vedere <function>ini_set</function>. </para> @@ -52,22 +52,22 @@ </term> <listitem> <para> - 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. + Decide se comprimere le agine in maniera trasparente. Se questa opzione è impostata + a "On" in &php.ini; o nella configurazione di Apache, le pagine vengono + compresse se il browser invia un header "Accept-Encoding: gzip" o + "deflate". Gli header "Content-Encoding: gzip" (oppure + "deflate") e "Vary: Accept-Encoding" sono aggiunti + all'output. </para> <para> - This option also accepts integer values instead of boolean - "On"/"Off", using this you can set the output buffer size - (default is 4KB). + Questa opzione accetta anche valori interi oltre ai booleani + "On"/"Off", in questo modo è possibile impostare la dimensione del buffer + (il default è 4KB). </para> <note> <para> - <link linkend="ini.output-handler">output_handler</link> must be - empty if this is set 'On' ! Instead you must use zlib.output_handler. + <link linkend="ini.output-handler">output_handler</link> deve essere + vuoto se quest opzione è 'On' ! Altrimenti occorre utilizzare zlib.output_handler. </para> </note> </listitem> @@ -80,7 +80,7 @@ </term> <listitem> <para> - Compression level used for transparent output compression. + Livello di compressione utilizzato per la compressione trasparente dell'output. </para> </listitem> </varlistentry> @@ -92,9 +92,9 @@ </term> <listitem> <para> - 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. + Non si possino specificare ulteriori handler dell'output se zlib.output_compression + è attivo. Questa impostazione è come <link linkend="ini.output-handler"> + output_handler</link> ma con un ordine differente. </para> </listitem> </varlistentry> http://cvs.php.net/diff.php/phpdoc/en/reference/zlib/reference.xml?r1=1.14&r2=1.15&ty=u Index: phpdoc/en/reference/zlib/reference.xml diff -u phpdoc/en/reference/zlib/reference.xml:1.14 phpdoc/en/reference/zlib/reference.xml:1.15 --- phpdoc/en/reference/zlib/reference.xml:1.14 Fri Feb 27 06:01:35 2004 +++ phpdoc/en/reference/zlib/reference.xml Sun Jul 11 18:47:20 2004 @@ -1,36 +1,36 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.14 $ --> +<!-- EN-Revision: 1.14 Maintainer: cucinato Status: ready --> <reference id="ref.zlib"> - <title>Zlib Compression Functions</title> + <title>Funzioni di compressione Zlib</title> <titleabbrev>Zlib</titleabbrev> <partintro> <section id="zlib.intro"> &reftitle.intro; <para> - 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). + questo modulo permette di leggere e scrivere in modo trasparente + i file compressi con gzip (.gz), attraverso versioni di molte delle + funzioni del <link linkend="ref.filesystem">filesystem</link> + in grado di operare su file compressi con gzip (ed anche su file non compressi, + ma non con i socket). </para> <note> <para> - 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 + La versione 4.0.4 ha introdotto un wrapper di fopen per i file .gz, che + permette di usare una speciale URL 'zlib:' per accedere ai file compressi + utilizzando le normali funzioni di accesso ai file [ f*() ], semplicemente + anteponendo al nome del file o percorso il prefisso 'zlib:' nella chiamata a <function>fopen</function>. </para> <para> - In version 4.3.0, this special prefix has been changed to 'zlib://' - to prevent ambiguities with filenames containing ':'. + Nella versione 4.3.0, questo prefisso è stato cambiato in 'zlib://' + per evitare ambiguità con i nomi di file contenenti il carattere ':'. </para> <para> - 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. + Questa funzionalità richiedere una libreria di runtime C che fornisca la + funzione <literal>fopencookie()</literal>. Al momento sembra che + la GNU libc sia l'unica libreria a fornire + questa funzionalità. </para> </note> </section> @@ -38,9 +38,9 @@ <section id="zlib.requirements"> &reftitle.required; <para> - 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. + Questo modulo usa le funzioni di <ulink url="&url.zlib;">zlib</ulink> + di Jean-loup Gailly e Mark Adler. Si deve utilizzare una + versione >= 1.0.9 con questo modulo. </para> </section> @@ -58,11 +58,11 @@ <section id="zlib.examples"> &reftitle.examples; <para> - This example opens a temporary file and writes a test string - to it, then it prints out the content of this file twice. + Questo esempio apre un file temporaneo e vi scrive una stringa di prova, + quindi stampa il contenuto del file due volte. </para> <example> - <title>Small Zlib Example</title> + <title>Esempio di Zlib</title> <programlisting role="php"> <![CDATA[ <?php @@ -71,30 +71,30 @@ echo "<html>\n<head></head>\n<body>\n<pre>\n"; $s = "Only a test, test, test, test, test, test, test, test!\n"; -// open file for writing with maximum compression +// apre il file in scrittura con la massima compressione $zp = gzopen($filename, "w9"); -// write string to file +// scrive la stringa sul file gzwrite($zp, $s); -// close file +// chiude il file gzclose($zp); -// open file for reading +// apre il file in lettura $zp = gzopen($filename, "r"); -// read 3 char +// legge 3 caratteri echo gzread($zp, 3); -// output until end of the file and close it. +// stampa fino alla fine del file e lo chiude gzpassthru($zp); gzclose($zp); echo "\n"; -// open file and print content (the 2nd time). +// apre il file e stampa il contenuto (la seconda volta) if (readgzfile($filename) != strlen($s)) { - echo "Error with zlib functions!"; + echo "Errore nelle funzioni zlib!"; } unlink($filename); echo "</pre>\n</body>\n</html>\n"; http://cvs.php.net/diff.php/phpdoc/en/reference/zlib/functions/gzclose.xml?r1=1.4&r2=1.5&ty=u Index: phpdoc/en/reference/zlib/functions/gzclose.xml diff -u phpdoc/en/reference/zlib/functions/gzclose.xml:1.4 phpdoc/en/reference/zlib/functions/gzclose.xml:1.5 --- phpdoc/en/reference/zlib/functions/gzclose.xml:1.4 Fri Feb 27 13:06:01 2004 +++ phpdoc/en/reference/zlib/functions/gzclose.xml Sun Jul 11 18:47:21 2004 @@ -1,29 +1,29 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.4 $ --> +<!-- EN-Revision: 1.4 Maintainer: cucinato Status: ready --> <!-- splitted from ./en/functions/zlib.xml, last change in rev 1.2 --> <refentry id="function.gzclose"> <refnamediv> <refname>gzclose</refname> - <refpurpose>Close an open gz-file pointer</refpurpose> + <refpurpose>Chiude un puntatore a file gz</refpurpose> </refnamediv> <refsect1> - <title>Description</title> + <title>Descrizione</title> <methodsynopsis> <type>int</type><methodname>gzclose</methodname> <methodparam><type>resource</type><parameter>zp</parameter></methodparam> </methodsynopsis> <para> - The gz-file pointed to by <parameter>zp</parameter> is closed. + Il file gz puntato da <parameter>zp</parameter> viene chiuso. </para> <para> &return.success; </para> <para> - The gz-file pointer must be valid, and must point to a file - successfully opened by <function>gzopen</function>. + Il puntatore al file gz deve essere valido, e deve puntare ad un file + già aperto da <function>gzopen</function>. </para> <para> - See also <function>gzopen</function>. + Vedere anche <function>gzopen</function>. </para> </refsect1> </refentry> http://cvs.php.net/diff.php/phpdoc/en/reference/zlib/functions/gzcompress.xml?r1=1.3&r2=1.4&ty=u Index: phpdoc/en/reference/zlib/functions/gzcompress.xml diff -u phpdoc/en/reference/zlib/functions/gzcompress.xml:1.3 phpdoc/en/reference/zlib/functions/gzcompress.xml:1.4 --- phpdoc/en/reference/zlib/functions/gzcompress.xml:1.3 Wed May 7 17:31:31 2003 +++ phpdoc/en/reference/zlib/functions/gzcompress.xml Sun Jul 11 18:47:21 2004 @@ -1,39 +1,39 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> +<!-- EN-Revision: 1.3 Maintainer: cucinato status: ready --> <!-- splitted from ./en/functions/zlib.xml, last change in rev 1.4 --> <refentry id="function.gzcompress"> <refnamediv> <refname>gzcompress</refname> - <refpurpose>Compress a string</refpurpose> + <refpurpose>Comprime una stringa col metodo COMPRESS</refpurpose> </refnamediv> <refsect1> - <title>Description</title> + <title>Descrizione</title> <methodsynopsis> <type>string</type><methodname>gzcompress</methodname> - <methodparam><type>string</type><parameter>data</parameter></methodparam> - <methodparam choice="opt"><type>int</type><parameter>level</parameter></methodparam> + <methodparam><type>string</type><parameter>dati</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>livello</parameter></methodparam> </methodsynopsis> <para> - This function returns a compressed version of the input - <parameter>data</parameter> using the ZLIB data format, - or &false; if an error is encountered. The optional parameter - <parameter>level</parameter> can be given as 0 for no - compression up to 9 for maximum compression. + Questa funzione restituisce una versione compressa di + <parameter>dati</parameter> utilizzanto il formato dati ZLIB, + oppure &false; se si verifica un errore. Il parametro opzionale + <parameter>livello</parameter> varia tra 0 (nessuna + compressione) fino a 9 (compressione massima). </para> <para> - For details on the ZLIB compression algorithm see the document + Per i dettagli sull'algoritmo di compressione ZLIB vedere il documento "<ulink url="&url.rfc;1950">ZLIB Compressed Data Format Specification version 3.3</ulink>" (RFC 1950). </para> <note> <para> - This is <emphasis>not</emphasis> the same as gzip compression, - which includes some header data. See <function>gzencode</function> - for gzip compression. + Questa <emphasis>non</emphasis> è la compressione gzip, + che include alcuni dati di header. Vedere <function>gzencode</function> + per la compressione gzip. </para> </note> <para> - See also <function>gzdeflate</function>, + Vedere anche <function>gzdeflate</function>, <function>gzinflate</function>, <function>gzuncompress</function>, <function>gzencode</function>. http://cvs.php.net/diff.php/phpdoc/en/reference/zlib/functions/gzdeflate.xml?r1=1.4&r2=1.5&ty=u Index: phpdoc/en/reference/zlib/functions/gzdeflate.xml diff -u phpdoc/en/reference/zlib/functions/gzdeflate.xml:1.4 phpdoc/en/reference/zlib/functions/gzdeflate.xml:1.5 --- phpdoc/en/reference/zlib/functions/gzdeflate.xml:1.4 Fri Feb 27 13:06:01 2004 +++ phpdoc/en/reference/zlib/functions/gzdeflate.xml Sun Jul 11 18:47:21 2004 @@ -1,35 +1,35 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.4 $ --> +<!-- EN-Revision: 1.4 Maintainer: cucinato Status: ready --> <!-- splitted from ./en/functions/zlib.xml, last change in rev 1.11 --> <refentry id="function.gzdeflate"> <refnamediv> <refname>gzdeflate</refname> - <refpurpose>Deflate a string</refpurpose> + <refpurpose>Comprime una stringa con il metodo DEFLATE</refpurpose> </refnamediv> <refsect1> - <title>Description</title> + <title>Descrizione</title> <methodsynopsis> <type>string</type><methodname>gzdeflate</methodname> - <methodparam><type>string</type><parameter>data</parameter></methodparam> - <methodparam choice="opt"><type>int</type><parameter>level</parameter></methodparam> + <methodparam><type>string</type><parameter>dati</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>livello</parameter></methodparam> </methodsynopsis> <para> - This function returns a compressed version of the input - <parameter>data</parameter> using the DEFLATE data format, - or &false; if an error is encountered. The optional parameter - <parameter>level</parameter> can be given as 0 for no - compression up to 9 for maximum compression. If - <parameter>level</parameter> is not given the default - compression level will be the default compression level of the - zlib library. + Questa funzione restituisce una versione compressa di + <parameter>dati</parameter> utilizzando il formato dati DEFLATE, + oppure &false; se si verifica un errore. Il parametro opzionale + <parameter>livello</parameter> varia tra 0 (nessuna + compressione) fino a 9 (compressione massima). Se + <parameter>livello</parameter> inon viene specificato, il livello + di compressione di default sarà quello di default della + libreria zlib. </para> <para> - For details on the DEFLATE compression algorithm see the document + Per i dettagli sull'algoritmo di compressione DEFLATE vedere il documento "<ulink url="&url.rfc;1951">DEFLATE Compressed Data Format Specification version 1.3</ulink>" (RFC 1951). </para> <para> - See also + Vedere anche <function>gzinflate</function>, <function>gzcompress</function>, <function>gzuncompress</function>, http://cvs.php.net/diff.php/phpdoc/en/reference/zlib/functions/gzencode.xml?r1=1.4&r2=1.5&ty=u Index: phpdoc/en/reference/zlib/functions/gzencode.xml diff -u phpdoc/en/reference/zlib/functions/gzencode.xml:1.4 phpdoc/en/reference/zlib/functions/gzencode.xml:1.5 --- phpdoc/en/reference/zlib/functions/gzencode.xml:1.4 Fri Dec 19 10:50:07 2003 +++ phpdoc/en/reference/zlib/functions/gzencode.xml Sun Jul 11 18:47:21 2004 @@ -1,49 +1,49 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.4 $ --> +<!-- EN-Revision: 1.4 Maintainer: cucinato Status: ready --> <!-- splitted from ./en/functions/zlib.xml, last change in rev 1.4 --> <refentry id="function.gzencode"> <refnamediv> <refname>gzencode</refname> - <refpurpose>Create a gzip compressed string</refpurpose> + <refpurpose>Crea una stringa compressa con gzip</refpurpose> </refnamediv> <refsect1> - <title>Description</title> + <title>Descrizione</title> <methodsynopsis> <type>string</type><methodname>gzencode</methodname> - <methodparam><type>string</type><parameter>data</parameter></methodparam> - <methodparam choice="opt"><type>int</type><parameter>level</parameter></methodparam> + <methodparam><type>string</type><parameter>dati</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>livello</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter>encoding_mode</parameter></methodparam> </methodsynopsis> <para> - This function returns a compressed version of the input - <parameter>data</parameter> compatible with the output of the - <command>gzip</command> program, or &false; if an error is - encountered. The optional parameter <parameter>level</parameter> - can be given as 0 for no compression up to 9 for maximum - compression, if not given the default compression level will be - the default compression level of the zlib library. + Questa funzione restituisce una versione compressa di + <parameter>dati</parameter> compatibile con l'output del + programma <command>gzip</command>, oppure &false; se si verifica un + errore. Il parametro opzionale <parameter>livello</parameter> + varia da 0 (nessuna compressione) a 9 (compressione + massima), se il livello di compressione non viene specificato verrà + adottato quello di default della libreria zlib. </para> <para> - You can also give <constant>FORCE_GZIP</constant> (the default) - or <constant>FORCE_DEFLATE</constant> as optional third parameter - <parameter>encoding_mode</parameter>. If you use - <constant>FORCE_DEFLATE</constant>, you get a standard zlib - deflated string (inclusive zlib headers) after the gzip file - header but without the trailing crc32 checksum. + Si può anche impostare <constant>FORCE_GZIP</constant> (il default) + o <constant>FORCE_DEFLATE</constant> come terzo parametro opzionale + <parameter>encoding_mode</parameter>. Se si utilizza + <constant>FORCE_DEFLATE</constant>, si ottiene una stringa compressa + col DEFLATE standard di zlib (comprendente gli header zlib) dopo l'header del file gzip + ma senza il checksum crc32 finale. <note> <para> - <parameter>level</parameter> was added in PHP 4.2, before PHP - 4.2 <function>gzencode</function> only had the - <parameter>data</parameter> and (optional) - <parameter>encoding_mode</parameter> parameters.. + <parameter>livello</parameter> è stato aggiunto nel PHP 4.2, prima di + questa versione <function>gzencode</function> aveva solo + i parametri <parameter>dati</parameter> e (opzionale) + <parameter>encoding_mode</parameter>. </para> </note> </para> <para> - The resulting data contains the appropriate headers and data - structure to make a standard .gz file, e.g.: + I dati risultanti contengono gli header e la struttura adeguati + per creare un file .gz standard, ad esempio: <example> - <title>Creating a gzip file</title> + <title>Creare un file gzip</title> <programlisting role="php"> <![CDATA[ <?php @@ -58,12 +58,12 @@ </example> </para> <para> - For more information on the GZIP file format, see the document: + Per ulteriori informazioni sul formato dei file GZIP, consultare il documento: <ulink url="&url.rfc;1952">GZIP file format specification version 4.3</ulink> (RFC 1952). </para> <para> - See also <function>gzcompress</function>. + Vedere anche <function>gzcompress</function>. <function>gzuncompress</function>, <function>gzdeflate</function>, <function>gzinflate</function>.