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
lmpx.com only provides a reader for public news (NNTP) servers. It is not affiliated with the servers or forums shown here and is not responsible for the content of articles, which is written by their respective authors.