com doc/it: sync about.xml from EN: appendices/about.xml

Commit: 60c815084abf1875cf79a3091422b996310aaa1f Author: Massimiliano Arione <garakkio@gmail.com> Thu, 28 Jan 2021 14:42:50 +0100 Committer: Davide Pastore <d.pastore@logispin.com> Sat, 30 Jan 2021 18:43:09 +0100 Parents: 3500c9be3af961f259cde02708831120fd992926 Branches: master Link: http://git.php.net/?p=doc/it.git;a=commitdiff;h=60c815084abf1875cf79a3091422b996310aaa1f Log: sync about.xml from EN Changed paths: M appendices/about.xml

diff --git a/appendices/about.xml b/appendices/about.xml index b42c11f4..c85db6eb 100644 --- a/appendices/about.xml +++ b/appendices/about.xml @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="utf-8"?> -<!-- EN-Revision: e121a3a894a377685208abd6f0fd2731e432dc87 Maintainer: cucinato Status: ready --> +<!-- EN-Revision: 9ffcc250271e62382436b7952691284cd98042f5 Maintainer: garak Status: ready --> <appendix xml:id="about" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <title>Informazioni sul manuale</title> @@ -18,10 +18,9 @@ </para> </note> <para> - Si può leggere il manuale online sul <link xlink:href="&url.php;">sito PHP.net</link> - e sui numerosi siti mirror. Per ottenere risultati migliori, scegliere - il mirror più vicino. La versione online del manuale PHP ha attualmente due - stylesheet <acronym>CSS</acronym>, uno per il web e uno per la stampa. + Si può leggere il manuale online sul <link xlink:href="&url.php;">sito PHP.net</link>. + La versione online del manuale PHP ha attualmente due stylesheet + <acronym>CSS</acronym>, uno per il web e uno per la stampa. </para> <para> Due vantaggi del manuale online sulla maggior parte dei formati offline @@ -101,10 +100,10 @@ <para> Dal punto di vista della licenza i contributi degli utenti sono considerati parte del manuale PHP, e quindi coperti dalla - stessa licenza che si applica a questa cocumentazione (Creative Commons Attribution + stessa licenza che si applica a questa documentazione (Creative Commons Attribution al momento). Per maggiori dettagli vedere la pagina - <link linkend="copyright">Manual's Copyright</link>. + <link linkend="copyright">Copyright del manuale </link>. </para> </note> </sect1> @@ -114,7 +113,7 @@ <para> Nel manuale ciascuna funzione è documentata per un rapido riferimento. Conoscendo come leggere e capendo il testo si è in grado di apprendere - il PHP molto più facilmente. Piuttosto che appoggiarsi sugli esempi o sul copia e incolla, + PHP molto più facilmente. Piuttosto che appoggiarsi sugli esempi o sul copia e incolla, preferirai sicuramente sapere come leggere la definizione di una funzione. Cominciamo: </para> <note> @@ -122,7 +121,7 @@ Pre-requisito: comprensione di base dei <link linkend="language.types">tipi di variabili</link> </title> <para> - Sebbene il PHP sia un linguaggio poco tipizzato (loosely typed), è importante avere + Sebbene PHP sia un linguaggio poco tipizzato (loosely typed), è importante avere una conoscenza di base delle <link linkend="language.types">tipologie</link> di variabili per il loro importante significato. </para> @@ -168,30 +167,30 @@ Restituisce la lunghezza di una stringa. </row> <row> <entry> - (PHP 4, PHP 5) + (PHP 4, PHP 5, PHP 7) </entry> <entry> - strlen() è disponibile in tutte le versioni di PHP 4 e PHP 5 + strlen() è disponibile in tutte le versioni di PHP 4, 5 e 7 </entry> </row> <row> <entry> - int + ( string $string ) </entry> <entry> - Tipo di valore restituito dalla funzione, il quale è un - <type>integer</type> (la lunghezza di una stringa si misura in - numeri). + Il primo (ed in questo caso unico) parametro/argomento per questa funzione + si chiama <parameter>string</parameter>, ed è una + <type>string</type>. </entry> </row> <row> <entry> - ( string $string ) - </entry> + int + </entry> <entry> - Il primo (ed in questo caso unico) parametro/argomento per questa funzione - si chiama <parameter>string</parameter>, ed è una - <type>string</type>. + Tipo di valore restituito dalla funzione, il quale è un + <type>integer</type> (la lunghezza di una stringa si misura in + numeri). </entry> </row> </tbody> @@ -204,7 +203,7 @@ Restituisce la lunghezza di una stringa. <para> <screen> <![CDATA[ - returned type function name ( parameter type parameter name ) + function name ( parameter type parameter name ) : returned type ]]> </screen> </para> @@ -215,7 +214,7 @@ Restituisce la lunghezza di una stringa. <para> <screen> <![CDATA[ - bool in_array ( mixed $needle, array $haystack [, bool $strict = FALSE ] ) + in_array ( mixed $needle, array $haystack , bool $strict = false ) : bool ]]> </screen> </para> @@ -246,9 +245,9 @@ Restituisce la lunghezza di una stringa. </para> <para> <screen> -<![CDATA[ - int preg_match ( string $pattern , string $subject [, array &$matches - [, int $flags = 0 [, int $offset = 0 ]]] ) +<![CDATA[ + preg_match ( string $pattern , string $subject , array &$matches = null, + int $flags = 0 , int $offset = 0 ) : int|false ]]> </screen> </para> @@ -263,7 +262,7 @@ Restituisce la lunghezza di una stringa. <para> <screen> <![CDATA[ -(PHP 4 >= 4.3.0, PHP 5) +(PHP 4 >= 4.3.0, PHP 5, PHP 7) ]]> </screen> </para> @@ -279,7 +278,7 @@ Restituisce la lunghezza di una stringa. Questa documentazione contiene informazioni sulle versioni presenti, passate e future di PHP. Cambiamenti nel comportamento sono documentati come annotazioni, cronologie e testo nelle pagine del manuale. - La versione documentata più vecchia è PHP 5.0.0. + La versione documentata più vecchia è PHP 7.0.0. </para> <para> Quando la documentazione esiste per l'ultima versione in sviluppo (non rilasciata) @@ -294,20 +293,20 @@ Restituisce la lunghezza di una stringa. </para> <para> Il manuale fa riferimento a versioni major, minor e point di PHP. - Usando PHP <literal>5.3.1</literal> come esempio, il <emphasis>5</emphasis> + Usando PHP <literal>7.3.1</literal> come esempio, il <emphasis>7</emphasis> si riferisce alla versione major, <emphasis>3</emphasis> alla minor, e <emphasis>1</emphasis> al "point release". Normalmente PHP aggiunge funzionalità - solo a versioni major e minor, e risolve i bug nelle versioni point. Comunque, + solo a versioni major e minor, e risolve i bug nelle versioni point. Comunque, questa convenzione non è sempre seguita. </para> <para> Si noti che il manuale PHP è scritto al presente, non al futuro, anche per funzionalità documentate che non sono ancora disponibili. La ragione di questo è che il manuale deve essere stabile nel tempo, e non debba richiedere fastidiose correzioni - grammaticali ad ongni nuovo rilascio di PHP. + grammaticali ad ogni nuovo rilascio di PHP. </para> <para> - In diverse occasioni il manuale del PHP presenta dei "valori di default" per le configurazioni di PHP. Questi + In diverse occasioni il manuale di PHP presenta dei "valori di default" per le configurazioni di PHP. Questi valori sono basati su come PHP si comporta senza un file di configurazione &php.ini;, quindi questi valori possono essere differenti da quelli trovati nei file <filename>php.ini-development</filename> e <filename>php.ini-production</filename>. @@ -318,7 +317,7 @@ Restituisce la lunghezza di una stringa. </sect1> <sect1 xml:id="about.more"> - <title>Come trovare più informazioni sul PHP</title> + <title>Come trovare più informazioni su PHP</title> <para> Lo scopo di questo manuale non è quello di fornire istruzioni sulla pratica in generale della programmazione. Gli sviluppatori principianti o alle prime armi @@ -328,8 +327,8 @@ Restituisce la lunghezza di una stringa. </para> <para> Ci sono diverse mailing list attive per discutere su tutti gli aspetti del - programmare con il PHP. Se si ha un problema, si utilizzino queste liste. - Per le opzioni di supporto, tra cui le maling list, vedere<link + programmare con PHP. Se si ha un problema, si utilizzino queste liste. + Per le opzioni di supporto, tra cui le mailing list, vedere<link xlink:href="&url.php.support;">le pagine di supporto di PHP.net</link>. </para> </sect1> @@ -341,7 +340,7 @@ Restituisce la lunghezza di una stringa. </para> <para> Se si trova un errore all'interno di questo manuale, in qualsiasi lingua esso sia, - comunicarlo usando ilsistema per segnalare bug su <link xlink:href="&url.php.bugs;"> + comunicarlo usando il sistema per segnalare bug su <link xlink:href="&url.php.bugs;"> &url.php.bugs;</link>, classificando il bug come "Errore nella documentazione". Allo stesso indirizzo si possono anche segnalare problemi relativi ad uno specifico formato di manuale. @@ -360,6 +359,10 @@ Restituisce la lunghezza di una stringa. puoi leggere la sezione <link linkend="about.notes">Sistema di invio delle note</link>. </para> <para> + È anche possibile inviare pull request al + <link xlink:href="&url.php.git.mirror;doc-en">repository Github mirror della documentazione</link>. + </para> + <para> Il manuale PHP è tradotto in parecchie lingue. Se si conosce l'inglese e una lingua straniera, si può lavorare con il team di traduzione per migliorare il manuale PHP. Per maggiori informazioni su come iniziare una nuova @@ -405,9 +408,9 @@ Restituisce la lunghezza di una stringa. <sect1 xml:id="about.translations"> <title>Traduzioni</title> <para> - Il manuale PHP è disponibile non solo in vari formati, am + Il manuale PHP è disponibile non solo in vari formati, ma anche in varie lingue. Il testo originale è scritto - in inglese, mentre gruppi di persone da tutto il modno + in inglese, mentre gruppi di persone da tutto il mondo si occupano di tradurlo nelle rispettive lingue. Se non esiste la traduzione per un specifico capitolo o funzione la procedura di compila del manuale utilizza la @@ -415,7 +418,7 @@ Restituisce la lunghezza di una stringa. </para> <para> Le persone che si occupano della traduzioni iniziano dal codice <acronym>XML</acronym> - disponibile da <link xlink:href="&url.php.svn;">&url.php.svn;</link> + disponibile da <link xlink:href="&url.php.git.mirror;doc-en">&url.php.git.mirror;doc-en"</link> e da questo partono per la traduzione nella propria lingua. <emphasis>Non si usano</emphasis> le versioni generate (come <acronym>HTML</acronym> o il testo normale) in quanto è il sistema di compilazione che si occupa