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>.