com doc/it: sync about.xml from EN: appendices/about.xml
[email protected] (Davide Pastore)
| Newsgroups | php.doc.it |
|---|---|
| Message-ID | <[email protected]> |
Commit: 60c815084abf1875cf79a3091422b996310aaa1f Author: Massimiliano Arione <[email protected]> Thu, 28 Jan 2021 14:42:50 +0100 Committer: Davide Pastore <[email protected]> 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_60c815084abf1875cf79a3091422b996310aaa1f.txt
(text/plain, 10.5 KB)
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