From 937a2bfeade72843543305ddca41870a4b5bfa66 Mon Sep 17 00:00:00 2001
From: Manuel della Gala <74384683+ManueldG@users.noreply.github.com>
Date: Thu, 6 Feb 2025 21:59:20 +0100
Subject: [PATCH 01/47] array-change-key-case.xml

---
 reference/array/functions/array-change-key-case.xml | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/reference/array/functions/array-change-key-case.xml b/reference/array/functions/array-change-key-case.xml
index a8e276c4b..d1bab21e5 100644
--- a/reference/array/functions/array-change-key-case.xml
+++ b/reference/array/functions/array-change-key-case.xml
@@ -1,9 +1,9 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 96c9d88bad9a7d7d44bfb7f26c226df7ee9ddf26 Maintainer: cucinato Status: ready -->
+<!-- EN-Revision: 58d11dfe19531e1355980b2892964c07dd8e8068 Maintainer: Manuel dG Status: ready -->
 <refentry xml:id="function.array-change-key-case" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>array_change_key_case</refname>
-  <refpurpose>Restituisce un array con tutte le chiavi cambiate in maiuscolo o in minuscolo</refpurpose>
+  <refpurpose>Cambia case a tutte le chiavi dell'array</refpurpose>
  </refnamediv>
  
  <refsect1 role="description">
@@ -14,8 +14,8 @@
    <methodparam choice="opt"><type>int</type><parameter>case</parameter><initializer>CASE_LOWER</initializer></methodparam>
   </methodsynopsis>
   <para>
-   Restituisce un array con tutte le chiavi in <parameter>input</parameter> cambiate
-   in maiuscolo o minuscolo. Gli indici numerati non sono modificati.
+   Restituisce un array con tutte le chiavi di un <parameter>array</parameter> convertite
+   in maiuscolo o minuscolo. Gli indici numerici non vengono modificati.
   </para>
  </refsect1>
 

From 38d379dd8afab04fb26321136dcc1d0ec77051f9 Mon Sep 17 00:00:00 2001
From: Manuel della Gala <74384683+ManueldG@users.noreply.github.com>
Date: Fri, 7 Feb 2025 13:48:52 +0100
Subject: [PATCH 02/47] array-combine.xml

---
 reference/array/functions/array-combine.xml | 34 ++++++++++++++++++---
 1 file changed, 30 insertions(+), 4 deletions(-)

diff --git a/reference/array/functions/array-combine.xml b/reference/array/functions/array-combine.xml
index e72bf9576..8c5776a5c 100644
--- a/reference/array/functions/array-combine.xml
+++ b/reference/array/functions/array-combine.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- EN-Revision: 3e15d2894fb35432d2a111db36fe8ba8ebc62024 Maintainer: pastore Status: ready -->
+<!-- EN-Revision: 71e3c74047f04b26aa1be51215d7129e15dc2993 Maintainer: Manuel dG Status: ready -->
 <!-- CREDITS: gurugeek -->
 <refentry xml:id="function.array-combine" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
@@ -30,7 +30,7 @@
      <term><parameter>keys</parameter></term>
      <listitem>
       <para>
-       Un array di chiavi da utilizzare. Valori illegali per le chiavi saranno
+       Un array di chiavi da utilizzare. Valori non validi per le chiavi saranno
        convertiti in <type>string</type>.
       </para>
      </listitem>
@@ -52,7 +52,7 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   Restituisce l'<type>array</type> combinato, &false; se il numero degli elementi
+   Restituisce l'<type>array</type> combinato, o &false; se il numero degli elementi
    per ogni array non è uguale.
   </para>
  </refsect1>
@@ -60,11 +60,37 @@
  <refsect1 role="errors">
   &reftitle.errors;
   <para>
-   Genera un <constant>E_WARNING</constant> se il numero degli elementi di
+   A partire da PHP 8.0.0, viene generato un <classname>ValueError</classname> se il numero di elementi in
    <parameter>keys</parameter> e <parameter>values</parameter> non
    corrisponde.
+   Prima di PHP 8.0.0, veniva invece emesso un <constant>E_WARNING</constant>.
   </para>
  </refsect1>
+
+ <refsect1 role="changelog">
+  &reftitle.changelog;
+  <informaltable>
+   <tgroup cols="2">
+    <thead>
+     <row>
+      <entry>&Version;</entry>
+      <entry>&Description;</entry>
+     </row>
+    </thead>
+    <tbody>
+     <row>
+      <entry>8.0.0</entry>
+      <entry>
+       <function>array_combine</function> genererà un
+       <classname>ValueError</classname> se il numbero degli elementi
+       degli array non è uguale;
+       invece prima la funzione riturnava un &false;.
+      </entry>
+     </row>
+    </tbody>
+   </tgroup>
+  </informaltable>
+ </refsect1>
  
  <refsect1 role="examples">
   &reftitle.examples;

From 69bfaea93fcd033228e36dcb61f915f2cdc367b4 Mon Sep 17 00:00:00 2001
From: Manuel della Gala <74384683+ManueldG@users.noreply.github.com>
Date: Fri, 7 Feb 2025 14:29:13 +0100
Subject: [PATCH 03/47] array-map.xml update

---
 reference/array/functions/array-map.xml | 85 ++++++++++++++++++++-----
 1 file changed, 68 insertions(+), 17 deletions(-)

diff --git a/reference/array/functions/array-map.xml b/reference/array/functions/array-map.xml
index 7475c51b7..5299d9864 100644
--- a/reference/array/functions/array-map.xml
+++ b/reference/array/functions/array-map.xml
@@ -1,10 +1,10 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 80872147aa52367137bd3d168412f70cbe2ddf9c Maintainer: pastore Status: ready -->
+<!-- EN-Revision: 33968dfebb9b847733d02ee221b3b8054a101b41c Maintainer: Manuel dG Status: ready -->
 <!-- CREDITS: cucinato -->
 <refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.array-map">
  <refnamediv>
   <refname>array_map</refname>
-  <refpurpose>Applica la funzione callback a tutti gli elementi degli array dati</refpurpose>
+  <refpurpose>Applica la callback a tutti gli elementi dell'array in input</refpurpose>
  </refnamediv>
  
  <refsect1 role="description">
@@ -16,14 +16,17 @@
    <methodparam choice="opt"><type>array</type><parameter>...</parameter></methodparam>
   </methodsynopsis>
   <para>
-   <function>array_map</function> restituisce un &array; contenente
-   i risultati dell'applicazione della <parameter>callback</parameter>
-   all'indice corrispondente di <parameter>array1</parameter>
-   (e <parameter>...</parameter> se vengono forniti più array)
-   usati come argomenti per la callback.
+   <function>array_map</function> restituisce un &array; che contiene
+   i risultati della <parameter>callback</parameter>
+   all'indice corrispondente dell'elemento dell'<parameter>array</parameter>
+   (o <parameter>arrays</parameter> se vengono forniti più array)
+   usato/i come argomento per la callback.
    Il numero di parametri che la funzione <parameter>callback</parameter>
    accetta dovrebbe corrispondere al numero di array
-   passati ad <function>array_map</function>.
+   passati a <function>array_map</function>.
+   I parametri in eccesso sono ignorati.
+   Un <classname>ArgumentCountError</classname>
+   viene generato se sarà fornito un numero insufficente di argomenti.   
   </para>
  </refsect1>
 
@@ -35,13 +38,18 @@
      <term><parameter>callback</parameter></term>
      <listitem>
       <para>
-       Una <type>callable</type> da eseguire per ogni elemento in ogni array.
+       Una funzione <type>callable</type> da eseguire per ogni elemento in ogni array.
       </para>
       <para>
        &null; può essere passato come valore alla <parameter>callback</parameter>
-       per eseguire un'operazione zip su più array.
-       Se viene fornito solo <parameter>array1</parameter>,
-       <methodname>array_map</methodname> restituirà l'array di input.
+       per eseguire un'operazione zip su più array e ritornerà un'array 
+       i cui elementi sono ciascuno un sub-array contenente gli elementi degli 
+       array di input con lo stesso indice (vedere l'esempio seguente).
+       
+        Se viene fornito un solo <parameter>array</parameter>,
+        <methodname>array_map</methodname> restituirà l'array di input.
+
+      </para>
       </para>
      </listitem>
     </varlistentry>
@@ -57,8 +65,8 @@
      <term><parameter>...</parameter></term>
      <listitem>
       <para>
-       Lista di variabili supplementari di argomenti di array da eseguire nella
-       funzione <parameter>callback</parameter>.
+       Array di argomenti supplementari da eseguire nella
+       <parameter>callback</parameter>.
       </para>
      </listitem>
     </varlistentry>
@@ -69,9 +77,9 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>  
-   Restituisce un array contenente i risultati dell'applicazione della funzione
+   Restituisce un array contenente i risultati dell'applicazione della
    <parameter>callback</parameter> all'indice corrispondente di <parameter>array1</parameter>
-   (e <parameter>...</parameter> se vengono forniti più array)
+   (o <parameter>arrays</parameter> se vengono forniti più array)
    usati come argomenti per la callback.
   </para>
   <para>
@@ -128,6 +136,11 @@ $func = function($value) {
 };
 
 print_r(array_map($func, range(1, 5)));
+
+// O come in PHP 7.4.0:
+
+print_r(array_map(fn($value): int => $value * 2, range(1, 5)));
+
 ?>
 ]]>
     </programlisting>
@@ -153,7 +166,7 @@ Array
 <?php
 function show_Spanish($n, $m)
 {
-    return "Il numero {$n} è chiamato {$m} in spagnolo";
+    return "Il numero {$n} si dice {$m} in Spagnolo";
 }
 
 function map_Spanish($n, $m)
@@ -372,6 +385,44 @@ array(1) {
     string(5) "value"
   }
 }
+]]>
+    </screen>
+   </example>
+   <example>
+    <title><function>array_map</function> - array associativi</title>
+    <para>
+     Mentre <function>array_map</function> non supporta direttamente
+     di arrray associativi come input, questo può essere simulato con <function>array_keys</function>.
+    </para>
+    <programlisting role="php">
+<![CDATA[
+<?php
+$arr = [
+    'v1' => 'Prima release',
+    'v2' => 'Seconda release',
+    'v3' => 'Terza release',
+];
+
+// Note: Prima della 7.4.0,invece si usava una versione estesa per le funzioni anonime.
+$callback = fn(string $k, string $v): string => "$k was the $v";
+
+$result = array_map($callback, array_keys($arr), array_values($arr));
+
+var_dump($result);
+?>
+]]>
+    </programlisting>
+    &example.outputs;
+    <screen>
+<![CDATA[
+array(3) {
+  [0]=>
+  string(24) "v1 was the First release"
+  [1]=>
+  string(25) "v2 was the Second release"
+  [2]=>
+  string(24) "v3 was the Third release"
+}
 ]]>
     </screen>
    </example>

From 14db1db7e283e9651a4070f547776d2e590aec65 Mon Sep 17 00:00:00 2001
From: Manuel della Gala <74384683+ManueldG@users.noreply.github.com>
Date: Fri, 7 Feb 2025 14:41:25 +0100
Subject: [PATCH 04/47] fix error array-map.xml : Opening and ending tag
 mismatch: listitem line 39 and para

---
 reference/array/functions/array-map.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/reference/array/functions/array-map.xml b/reference/array/functions/array-map.xml
index 5299d9864..f4f6f9b1c 100644
--- a/reference/array/functions/array-map.xml
+++ b/reference/array/functions/array-map.xml
@@ -49,7 +49,7 @@
         Se viene fornito un solo <parameter>array</parameter>,
         <methodname>array_map</methodname> restituirà l'array di input.
 
-      </para>
+     
       </para>
      </listitem>
     </varlistentry>

From 5020be01e84d7eb2a745aaa2013008e4158bb853 Mon Sep 17 00:00:00 2001
From: Manuel della Gala <74384683+ManueldG@users.noreply.github.com>
Date: Fri, 7 Feb 2025 16:22:19 +0100
Subject: [PATCH 05/47] array-diff-assoc.xml updated

---
 .../array/functions/array-diff-assoc.xml      | 40 ++++++++++++++-----
 1 file changed, 31 insertions(+), 9 deletions(-)

diff --git a/reference/array/functions/array-diff-assoc.xml b/reference/array/functions/array-diff-assoc.xml
index fd7d5dcba..9e1848b0c 100644
--- a/reference/array/functions/array-diff-assoc.xml
+++ b/reference/array/functions/array-diff-assoc.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 9e0f03ac354d797d1d16c0fcc1663e5e170f2727 Maintainer: pastore Status: ready -->
+<!-- EN-Revision: 6b64170daac5587bee4bb63c0020cb2fbf7f1253 Maintainer: Manuel dG Status: ready -->
 <!-- CREDITS: cucinato -->
 <refentry xml:id="function.array-diff-assoc" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
@@ -15,7 +15,7 @@
    <methodparam rep="repeat"><type>array</type><parameter>arrays</parameter></methodparam>
   </methodsynopsis>
   <para>
-   Confronta <parameter>array</parameter> con <parameter>arrays</parameter> e
+   Confronta un'<parameter>array</parameter> con <parameter>arrays</parameter> e
    restituisce la differenza. A differenza di <function>array_diff</function>, nel confronto
    vengono utilizzate anche le chiavi dell'array.
   </para>
@@ -30,7 +30,7 @@
      <term><parameter>array</parameter></term>
      <listitem>
       <para>
-       L'array da confrontare
+       The array to compare from
       </para>
      </listitem>
     </varlistentry>
@@ -39,7 +39,7 @@
      <term><parameter>arrays</parameter></term>
      <listitem>
       <para>
-       Gli array con cui confrontare
+       Arrays to compare against
       </para>
      </listitem>
     </varlistentry>
@@ -51,8 +51,29 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
+  
    Restituisce un <type>array</type> contenente tutti i valori dell'
    <parameter>array</parameter> che non sono presenti in nessuno degli altri array.
+
+  </para>
+ </refsect1>
+
+ <refsect1 role="changelog">
+  &reftitle.changelog;
+  <para>
+   <informaltable>
+    <tgroup cols="2">
+     <thead>
+      <row>
+       <entry>&Version;</entry>
+       <entry>&Description;</entry>
+      </row>
+     </thead>
+     <tbody>
+      &array.changelog.require-only-one;
+     </tbody>
+    </tgroup>
+   </informaltable>
   </para>
  </refsect1>
 
@@ -102,9 +123,9 @@ Array
    <example>
     <title>Esempio di <function>array_diff_assoc</function></title>
     <para>
-     Due valori delle coppie <emphasis>chiave =&gt; valore</emphasis> sono
+     I due valori delle coppie <emphasis>chiave =&gt; valore</emphasis> sono
      considerati uguali solo se <literal>(string) $elem1 === (string)
-     $elem2 </literal>. In altre parole c'è un controllo stringente che si accerta
+     $elem2 </literal>. In altre parole c'è un controllo preciso che si accerta
      che le rappresentazioni sotto forma di stringa siano uguali.
     </para>
     <programlisting role="php">
@@ -124,7 +145,7 @@ Array
 (
     [0] => 0
     [1] => 1
-    )
+)
 ]]>
     </screen>
    </example>
@@ -135,8 +156,9 @@ Array
   &reftitle.notes;
   <note>
    <simpara>
-    Si noti che questa funzione controlla solo una dimensione di un array
-    n-dimensionale. Ovviamente è possibile controllare le altre dimensioni usando, per esempio,
+    Questa funzione controlla una sola dimensione di un array n-dimensioni. 
+    E' possile controllare più in profondità l'array usando per esempio
+
     <literal>array_diff_assoc($array1[0], $array2[0]);</literal>.
    </simpara>
   </note>

From ee11e092d1291751c5226dc8b9f96e139ec05147 Mon Sep 17 00:00:00 2001
From: Manuel della Gala <74384683+ManueldG@users.noreply.github.com>
Date: Fri, 7 Feb 2025 17:56:17 +0100
Subject: [PATCH 06/47] array-count-values.xml

---
 reference/array/functions/array-count-values.xml | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/reference/array/functions/array-count-values.xml b/reference/array/functions/array-count-values.xml
index 2eebf7ab3..d4c1af022 100644
--- a/reference/array/functions/array-count-values.xml
+++ b/reference/array/functions/array-count-values.xml
@@ -1,10 +1,10 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 86e6094e86b84a51d00ab217ac50ce8dde33d82a Maintainer: pastore Status: ready -->
+<!-- EN-Revision: 6b56e6f444e49396ee5122258ee85b99a8543f6a Maintainer: Manuel dG Status: ready -->
 <!-- CREDITS: cucinato -->
 <refentry xml:id="function.array-count-values" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>array_count_values</refname>
-  <refpurpose>Conta tutti i valori di un array</refpurpose>
+  <refpurpose>Conta tutte le occorrenze di ogni singolo valore in un array</refpurpose>
  </refnamediv>
  
  <refsect1 role="description">
@@ -15,8 +15,8 @@
   </methodsynopsis>
   <para>
    <function>array_count_values</function> restituisce un array usando
-   i valori di <parameter>array</parameter> come chiavi e
-   la loro frequenza in <parameter>array</parameter> come valori.
+   i valori dell'<parameter>array</parameter> (che devono  essere &integer; o &string;) 
+   come chiavi e la frequenza degli elementi nell'<parameter>array</parameter> come valori.   
   </para>
  </refsect1>
 
@@ -41,7 +41,7 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   Restituisce un array associativo di valori da <parameter>array</parameter> come
+   Restituisce un array associativo di valori da un'<parameter>array</parameter> come
    chiavi ed il loro conteggio come valore.
   </para>
  </refsect1>

From 0f029984f9c52ac558642d3e5630386bcb1e35de Mon Sep 17 00:00:00 2001
From: Manuel della Gala <74384683+ManueldG@users.noreply.github.com>
Date: Fri, 7 Feb 2025 19:46:16 +0100
Subject: [PATCH 07/47] update array-count-values.xml

---
 reference/array/functions/array-count-values.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/reference/array/functions/array-count-values.xml b/reference/array/functions/array-count-values.xml
index d4c1af022..1e470da0c 100644
--- a/reference/array/functions/array-count-values.xml
+++ b/reference/array/functions/array-count-values.xml
@@ -115,4 +115,4 @@ End:
 vim600: syn=xml fen fdm=syntax fdl=2 si
 vim: et tw=78 syn=sgml
 vi: ts=1 sw=1
--->
+-->
\ No newline at end of file

From 3c11a941ac7c80b0bd25d6c1eae0c13585157b54 Mon Sep 17 00:00:00 2001
From: Manuel della Gala <74384683+ManueldG@users.noreply.github.com>
Date: Fri, 7 Feb 2025 20:13:18 +0100
Subject: [PATCH 08/47] array-key-exist.xml

---
 .../array/functions/array-key-exists.xml      | 43 +++++++++++++++----
 1 file changed, 34 insertions(+), 9 deletions(-)

diff --git a/reference/array/functions/array-key-exists.xml b/reference/array/functions/array-key-exists.xml
index 145781c96..5b5ba4199 100644
--- a/reference/array/functions/array-key-exists.xml
+++ b/reference/array/functions/array-key-exists.xml
@@ -1,10 +1,10 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: a6655e3f9508eee6860b02f55e33560a790f42d1 Maintainer: pastore Status: ready -->
+<!-- EN-Revision: 89fe795cc8bcf1b5ff9eb894bff51f006db66a65 Maintainer: Manuel dG Status: ready -->
 <!-- CREDITS: cucinato -->
 <refentry xml:id="function.array-key-exists" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>array_key_exists</refname>
-  <refpurpose>Controlla se l'indice o la chiave specificato esiste nell'array</refpurpose>
+  <refpurpose>Checks if the given key or index exists in the array</refpurpose>
  </refnamediv>
  
  <refsect1 role="description">
@@ -16,8 +16,8 @@
   </methodsynopsis>
   <para>
    <function>array_key_exists</function> restituisce &true; se la
-   <parameter>key</parameter> data è impostata nell'array.
-   <parameter>key</parameter> può essere qualsiasi valore possibile
+   <parameter>key</parameter> data è presente nell'array.
+   <parameter>key</parameter> può essere un qualsiasi valore possibile
    per un indice di array.
   </para>
  </refsect1>
@@ -30,7 +30,7 @@
      <term><parameter>key</parameter></term>
      <listitem>
       <para>
-       Il valore da verificare.
+       Il valore da controllare.
       </para>
      </listitem>
     </varlistentry>
@@ -59,6 +59,31 @@
   </note>
  </refsect1>
 
+ <refsect1 role="changelog">
+  &reftitle.changelog;
+  <informaltable>
+   <tgroup cols="2">
+    <thead>
+     <row>
+      <entry>&Version;</entry>
+      <entry>&Description;</entry>
+     </row>
+    </thead>
+    <tbody>
+     <row>
+      <entry>8.0.0</entry>
+      <entry>
+       The <parameter>key</parameter> parametri ora accettati
+       <parameter>bool</parameter>, <parameter>float</parameter>, <parameter>int</parameter>,
+       <parameter>null</parameter>, <parameter>resource</parameter>, e
+       <parameter>string</parameter> come argomenti.
+      </entry>
+     </row>
+    </tbody>
+   </tgroup>
+  </informaltable>
+ </refsect1>
+
  <refsect1 role="examples">
   &reftitle.examples;
   <para>
@@ -80,8 +105,8 @@ if (array_key_exists('primo', $search_array)) {
    <title><function>array_key_exists</function> vs <function>isset</function></title>
    <para>
     <function>isset</function> non restituisce &true; per le chiavi di array
-    che corrispondono ad un valore &null;, mentre
-    <function>array_key_exists</function> lo fa.
+    che corrispondono ad un valore &null;, è possibile usare
+    <function>array_key_exists</function>.
    </para>
    <programlisting role="php">
 <![CDATA[
@@ -103,8 +128,8 @@ array_key_exists('primo', $search_array);
   &reftitle.notes;
   <note>
     <para>
-     Per motivi di retrocompatibilità, anche <function>array_key_exists</function>
-     restituirà &true; se <parameter>key</parameter> è una proprietà
+     Per motivi di retrocompatibilità, <function>array_key_exists</function>
+     restituirà &true; se la <parameter>key</parameter> è una proprietà
      definita all'interno di un <type>object</type> dato come
      <parameter>array</parameter>. Questo comportamento è deprecato a partire da PHP 7.4.0
      e rimosso a partire da PHP 8.0.0.

From 4f932e8ab5b61e6a4e60ad7cc4fce81a04cde9b3 Mon Sep 17 00:00:00 2001
From: Manuel della Gala <74384683+ManueldG@users.noreply.github.com>
Date: Fri, 7 Feb 2025 21:30:38 +0100
Subject: [PATCH 09/47] updated :array-merge-recursive.xml updated
 :array-replace-recursive.xml

---
 .../array/functions/array-merge-recursive.xml |  54 +++--
 .../functions/array_replace_recursive.xml     | 191 ++++++++++++++++++
 2 files changed, 228 insertions(+), 17 deletions(-)
 create mode 100644 reference/array/functions/array_replace_recursive.xml

diff --git a/reference/array/functions/array-merge-recursive.xml b/reference/array/functions/array-merge-recursive.xml
index 29e6e2366..ac7c607aa 100644
--- a/reference/array/functions/array-merge-recursive.xml
+++ b/reference/array/functions/array-merge-recursive.xml
@@ -1,26 +1,25 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 96c9d88bad9a7d7d44bfb7f26c226df7ee9ddf26 Maintainer: cucinato Status: ready -->
+<!-- EN-Revision: 9e0f03ac354d797d1d16c0fcc1663e5e170f2727 Maintainer: ManueldG Status: ready -->
 <refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.array-merge-recursive">
  <refnamediv>
   <refname>array_merge_recursive</refname>
-  <refpurpose>Fonde due o più array in modo ricorsivo</refpurpose>
+  <refpurpose>Fonde due o più array ricorsivamente</refpurpose>
  </refnamediv>
  
  <refsect1 role="description">
   &reftitle.description;
   <methodsynopsis>
    <type>array</type><methodname>array_merge_recursive</methodname>
-   <methodparam><type>array</type><parameter>array1</parameter></methodparam>
-   <methodparam choice="opt"><type>array</type><parameter>...</parameter></methodparam>
+   <methodparam rep="repeat"><type>array</type><parameter>arrays</parameter></methodparam>
   </methodsynopsis>
   <para>
-   <function>Array_merge_recursive</function> fonde gli elementi di
-   uno o più array in modo tale che i valori di un array siano accodati
-   all'array precedente.  Restituisce l'array risultante.
+   <function>array_merge_recursive</function>
+   fonde gli elementi di uno o più array in modo tale che i valori di un'array siano accodati
+   alla fine del precedente e restituisce l'array così elaborato.
   </para>
   <para>
    Se gli array in input hanno le stesse chiavi stringa, i valori di
-   queste chiavi vengono fusi in un array, e questo è fatto in modo
+   queste chiavi vengono fusi in un array, in modo
    ricorsivo, cioè se uno dei valori è un array, la
    funzione lo fonderà con una voce corrispondente in un altro array
    Comunque, se gli array hanno la stessa chiave numerica, l'ultimo valore
@@ -33,15 +32,7 @@
   <para>
    <variablelist>
     <varlistentry>
-     <term><parameter>array1</parameter></term>
-     <listitem>
-      <para>
-       Array iniziale da fondere.
-      </para>
-     </listitem>
-    </varlistentry>
-    <varlistentry>
-     <term><parameter>...</parameter></term>
+     <term><parameter>arrays</parameter></term>
      <listitem>
       <para>
        Lista variabile di array da fondere ricorsivamente.
@@ -56,6 +47,34 @@
   &reftitle.returnvalues;
   <para>
    Un array di valori risultante dalla fusione degli argomenti.
+   Se usata senza nessun argomento, ritorna un &array; vuoto.
+   An array of values resulted from merging the arguments together.
+   If called without any arguments, returns an empty &array;.
+  </para>
+ </refsect1>
+
+ <refsect1 role="changelog">
+  &reftitle.changelog;
+  <para>
+   <informaltable>
+    <tgroup cols="2">
+     <thead>
+      <row>
+       <entry>&Version;</entry>
+       <entry>&Description;</entry>
+      </row>
+     </thead>
+     <tbody>
+      <row>
+       <entry>7.4.0</entry>
+       <entry>
+        Questa funzione può essere chiamata senza parametro,
+        Formalmente, almeno un parametro è richiesto.
+       </entry>
+      </row>
+     </tbody>
+    </tgroup>
+   </informaltable>
   </para>
  </refsect1>
 
@@ -104,6 +123,7 @@ Array
   <para>
    <simplelist>
     <member><function>array_merge</function></member>
+    <member><function>array_replace_recursive</function></member>
    </simplelist>
   </para>
  </refsect1>
diff --git a/reference/array/functions/array_replace_recursive.xml b/reference/array/functions/array_replace_recursive.xml
new file mode 100644
index 000000000..77a4122bc
--- /dev/null
+++ b/reference/array/functions/array_replace_recursive.xml
@@ -0,0 +1,191 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- EN-Revision: a51ec6735093d3f71d8b2139967851a7b6df3d65 Maintainer: ManueldG Status: ready -->
+
+<refentry xml:id="function.array-replace-recursive" xmlns="http://docbook.org/ns/docbook">
+ <refnamediv>
+  <refname>array_replace_recursive</refname>
+  <refpurpose>Replaces elements from passed arrays into the first array recursively</refpurpose>
+  <refpurpose>Sostituisce gli elementi dall'array passato come parametro dal primo array in modo ricorsivo.</refpurpose>
+
+ </refnamediv>
+ <refsect1 role="description">
+  &reftitle.description;
+  <methodsynopsis>
+   <type>array</type><methodname>array_replace_recursive</methodname>
+   <methodparam><type>array</type><parameter>array</parameter></methodparam>
+   <methodparam rep="repeat"><type>array</type><parameter>replacements</parameter></methodparam>
+  </methodsynopsis>
+  <para>
+   <function>array_replace_recursive</function>
+    sostituisce i valori dell'<parameter>array</parameter> con gli stessi
+    valori da tutti i seguenti array. Se una chiave del primo array esiste 
+    nel secondo array, il suo valore verrà sostituito dal valore del 
+    secondo array. Se la chiave esiste nel secondo array e non il primo, 
+    la chiave verrà creato nel primo array. Se una chiave esiste 
+    solo nel primo array, verrà lasciata così com'è. Se vengono passati 
+    più array per la sostituzione, verranno elaborati in ordine, 
+    l'array successivo sovrascrive i valori precedenti.
+  </para>
+  <para>
+   <function>array_replace_recursive</function> è ricorsiva : la funzione 
+   scorrerà l'array e verrà applicata anche ai
+   valori più interni.
+  </para>
+  <para>
+   Quando il valore nel primo array è scalare, verrà sostituito
+   dal valore del secondo array, può essere sia uno scalare che un'array.
+   Quando il valore nel primo array e nel secondo array
+   sono entrambi array, <function>array_replace_recursive</function> sostituirà
+   il loro rispettivo valore in modo ricorsivo.
+  </para>
+ </refsect1>
+ <refsect1 role="parameters">
+  &reftitle.parameters;
+  <para>
+   <variablelist>
+    <varlistentry>
+     <term><parameter>array</parameter></term>
+     <listitem>
+      <para>
+       L'array nel quale gli elementi sono sostituiti.
+      </para>
+     </listitem>
+    </varlistentry>
+    <varlistentry>
+     <term><parameter>sostituzioni</parameter></term>
+     <listitem>
+      <para>
+       Array da cui verranno estratti gli elementi.
+      </para>
+     </listitem>
+    </varlistentry>
+   </variablelist>
+  </para>
+ </refsect1>
+ <refsect1 role="returnvalues">
+  &reftitle.returnvalues;
+  <para>
+   Ritorna un'<type>array</type>.
+  </para>
+ </refsect1>
+ <refsect1 role="examples">
+  &reftitle.examples;
+  <para>
+   <example>
+    <title><function>array_replace_recursive</function> esempi</title>
+    <programlisting role="php">
+<![CDATA[
+<?php
+$base = array('citrus' => array( "orange") , 'berries' => array("blackberry", "raspberry"), );
+$replacements = array('citrus' => array('pineapple'), 'berries' => array('blueberry'));
+
+$basket = array_replace_recursive($base, $replacements);
+print_r($basket);
+
+$basket = array_replace($base, $replacements);
+print_r($basket);
+?>
+]]>
+    </programlisting>
+    &example.outputs;
+    <screen role="php">
+<![CDATA[
+Array
+(
+    [citrus] => Array
+        (
+            [0] => pineapple
+        )
+
+    [berries] => Array
+        (
+            [0] => blueberry
+            [1] => raspberry
+        )
+
+)
+Array
+(
+    [citrus] => Array
+        (
+            [0] => pineapple
+        )
+
+    [berries] => Array
+        (
+            [0] => blueberry
+        )
+
+)
+
+]]>
+    </screen>
+   </example>
+   <example>
+    <title><function>array_replace_recursive</function>e il comportamento ricorsivo.</title>
+    <programlisting role="php">
+<![CDATA[
+<?php
+$base = array('citrus' => array("orange") , 'berries' => array("blackberry", "raspberry"), 'others' => 'banana' );
+$replacements = array('citrus' => 'pineapple', 'berries' => array('blueberry'), 'others' => array('litchis'));
+$replacements2 = array('citrus' => array('pineapple'), 'berries' => array('blueberry'), 'others' => 'litchis');
+
+$basket = array_replace_recursive($base, $replacements, $replacements2);
+print_r($basket);
+
+?>
+]]>
+    </programlisting>
+    &example.outputs;
+    <screen role="php">
+<![CDATA[
+Array
+(
+    [citrus] => Array
+        (
+            [0] => pineapple
+        )
+
+    [berries] => Array
+        (
+            [0] => blueberry
+            [1] => raspberry
+        )
+
+    [others] => litchis
+)
+]]>
+    </screen>
+   </example>
+  </para>
+ </refsect1>
+ <refsect1 role="seealso">
+  &reftitle.seealso;
+  <para>
+   <simplelist>
+    <member><function>array_replace</function></member>
+    <member><function>array_merge_recursive</function></member>
+   </simplelist>
+  </para>
+ </refsect1>
+</refentry>
+<!-- Keep this comment at the end of the file
+Local variables:
+mode: sgml
+sgml-omittag:t
+sgml-shorttag:t
+sgml-minimize-attributes:nil
+sgml-always-quote-attributes:t
+sgml-indent-step:1
+sgml-indent-data:t
+indent-tabs-mode:nil
+sgml-parent-document:nil
+sgml-default-dtd-file:"~/.phpdoc/manual.ced"
+sgml-exposed-tags:nil
+sgml-local-catalogs:nil
+sgml-local-ecat-files:nil
+End:
+vim600: syn=xml fen fdm=syntax fdl=2 si
+vim: et tw=78 syn=sgml
+vi: ts=1 sw=1
+-->
\ No newline at end of file

From 34a47f64544a6ff44ea4d37055743947f970ff52 Mon Sep 17 00:00:00 2001
From: Manuel della Gala <74384683+ManueldG@users.noreply.github.com>
Date: Fri, 7 Feb 2025 21:51:15 +0100
Subject: [PATCH 10/47] added array_replace_recursive.xml, updated
 array-merge-recursive.xml

---
 reference/array/functions/array_replace_recursive.xml | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/reference/array/functions/array_replace_recursive.xml b/reference/array/functions/array_replace_recursive.xml
index 77a4122bc..549b63acd 100644
--- a/reference/array/functions/array_replace_recursive.xml
+++ b/reference/array/functions/array_replace_recursive.xml
@@ -4,7 +4,6 @@
 <refentry xml:id="function.array-replace-recursive" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>array_replace_recursive</refname>
-  <refpurpose>Replaces elements from passed arrays into the first array recursively</refpurpose>
   <refpurpose>Sostituisce gli elementi dall'array passato come parametro dal primo array in modo ricorsivo.</refpurpose>
 
  </refnamediv>
@@ -17,7 +16,7 @@
   </methodsynopsis>
   <para>
    <function>array_replace_recursive</function>
-    sostituisce i valori dell'<parameter>array</parameter> con gli stessi
+    Sostituisce i valori dell'<parameter>array</parameter> con gli stessi
     valori da tutti i seguenti array. Se una chiave del primo array esiste 
     nel secondo array, il suo valore verrà sostituito dal valore del 
     secondo array. Se la chiave esiste nel secondo array e non il primo, 
@@ -188,4 +187,5 @@ End:
 vim600: syn=xml fen fdm=syntax fdl=2 si
 vim: et tw=78 syn=sgml
 vi: ts=1 sw=1
--->
\ No newline at end of file
+-->
+

From 2c01b7b5f73a1135cf2c3b00a180463eee73fb42 Mon Sep 17 00:00:00 2001
From: Manuel della Gala <74384683+ManueldG@users.noreply.github.com>
Date: Sat, 8 Feb 2025 10:43:14 +0100
Subject: [PATCH 11/47] array-filter.xml updated

---
 reference/array/functions/array-filter.xml | 313 +++++++++++++++------
 1 file changed, 229 insertions(+), 84 deletions(-)

diff --git a/reference/array/functions/array-filter.xml b/reference/array/functions/array-filter.xml
index cc0c996b5..d7a2d82b5 100644
--- a/reference/array/functions/array-filter.xml
+++ b/reference/array/functions/array-filter.xml
@@ -1,67 +1,171 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<!-- EN-Revision: n/a Maintainer: cucinato Status: ready -->
+<?xml version="1.0" encoding="utf-8"?>
+<!-- EN-Revision: 596c11440dc232b8ed1836d7e3afe2ed5b225a7b Maintainer: Manuel dG Status: ready -->
 <!-- splitted from ./it/functions/array.xml, last change in rev 1.1 -->
 <!-- last change to 'array-filter' in en/ tree in rev 1.62 -->
 <!-- OLD-Revision: 1.173/EN.1.62 -->
-  <refentry xml:id="function.array-filter" xmlns="http://docbook.org/ns/docbook">
-   <refnamediv>
-    <refname>array_filter</refname>
-    <refpurpose>
-      Filtra gli elementi di un array usando una funzione callback
-    </refpurpose>
-   </refnamediv>
-   <refsect1>
-    <title>Descrizione</title>
-     <methodsynopsis>
-      <type>array</type><methodname>array_filter</methodname>
-      <methodparam><type>array</type><parameter>input</parameter></methodparam>
-      <methodparam choice="opt"><type>callback</type><parameter>callback</parameter></methodparam>
-     </methodsynopsis>
-    <para>
-     <function>array_filter</function> esegue un'iterazione su ogni valore
-     nell' array <parameter>input</parameter> passandolo alla
-     <parameter>funzione</parameter>. Se <parameter>
-     funzione</parameter> restituisce &true;, il valore corrente
-    di <parameter>input</parameter> viene restituito nell'array
-    risultato. Le chiavi sono mantenute.
-    </para>
-    <para>
-     <example>
-      <title>Esempio di <function>array_filter</function></title>
-      <programlisting role="php">
+<refentry xml:id="function.array-filter" xmlns="http://docbook.org/ns/docbook">
+ <refnamediv>
+  <refname>array_filter</refname>
+  <refpurpose>Filtra gli elementi di un array tramite una callback</refpurpose>
+ </refnamediv>
+
+ <refsect1 role="description">
+  &reftitle.description;
+  <methodsynopsis>
+   <type>array</type><methodname>array_filter</methodname>
+   <methodparam><type>array</type><parameter>array</parameter></methodparam>
+   <methodparam choice="opt"><type class="union"><type>callable</type><type>null</type></type><parameter>callback</parameter><initializer>&null;</initializer></methodparam>
+   <methodparam choice="opt"><type>int</type><parameter>mode</parameter><initializer>0</initializer></methodparam>
+  </methodsynopsis>
+  <para>
+   Itera ogni valore dell'<parameter>array</parameter>
+   passandoli alla <parameter>callback</parameter>.
+   Se la <parameter>callback</parameter> restituisce &true;, il
+   valore corrente dall'<parameter>array</parameter> viene aggiunto nel
+   risultato &array;.
+  </para>
+  <para>
+   Le chiavi dell'array vengono mantenute ma potrebbero essere delle lacune se l'<parameter>array</parameter> 
+   è stato indicizzato. Il risultato &array; può essere reindicizzato utilizzando la funzione 
+   <function>array_values</function>.
+  </para>
+</refsect1>
+
+ <refsect1 role="parameters">
+  &reftitle.parameters;
+  <para>
+   <variablelist>
+
+    <varlistentry>
+     <term><parameter>array</parameter></term>
+     <listitem>
+      <para>
+       L'array su cui iterare.
+      </para>
+     </listitem>
+    </varlistentry>
+
+    <varlistentry>
+     <term><parameter>callback</parameter></term>
+     <listitem>
+      <para>
+       La funzione callback da usare.
+      </para>
+      <para>
+       Se non viene fornito alcun <parameter>callback</parameter>, tutte le voci vuote 
+       dell'<parameter>array</parameter> verranno rimosse. Andare a vedere <function>empty</function>
+       per sapere come PHP definisce empty in questo caso.
+      </para>
+     </listitem>
+    </varlistentry>
+
+    <varlistentry>
+     <term><parameter>mode</parameter></term>
+     <listitem>
+      <para>
+       Flag che determina quali argomenti sono inviati alla <parameter>callback</parameter>:
+       <itemizedlist>
+        <listitem>
+         <simpara>
+          <constant>ARRAY_FILTER_USE_KEY</constant> - passa la chiave come unico argomento alla
+          <parameter>callback</parameter> invece del valore.
+         </simpara>
+        </listitem>
+        <listitem>
+         <simpara>
+          <constant>ARRAY_FILTER_USE_BOTH</constant> - passa sia il valore che la chiave 
+          come argomenti alla <parameter>callback</parameter> invece del valore.
+         </simpara>
+        </listitem>
+       </itemizedlist>
+        Il valore di Default è <literal>0</literal> che passerà il valore come unico argomento
+        alla <parameter>callback</parameter>.
+      </para>
+     </listitem>
+    </varlistentry>
+
+   </variablelist>
+  </para>
+ </refsect1>
+
+ <refsect1 role="returnvalues">
+  &reftitle.returnvalues;
+  <para>
+   Restituisce l'array filtrato.
+  </para>
+ </refsect1>
+
+ <refsect1 role="changelog">
+  &reftitle.changelog;
+  <informaltable>
+   <tgroup cols="2">
+    <thead>
+     <row>
+      <entry>&Version;</entry>
+      <entry>&Description;</entry>
+     </row>
+    </thead>
+    <tbody>
+     <row>
+      <entry>8.0.0</entry>
+      <entry>
+       La <parameter>callback</parameter> può anche non essere usata.
+      </entry>
+     </row>
+     &array.changelog.by-ref;
+    </tbody>
+   </tgroup>
+  </informaltable>
+ </refsect1>
+
+<!--
+ <refsect1 role="errors">
+  &reftitle.errors;
+  &errors.no.unusual.errors;
+ </refsect1>
+-->
+
+ <refsect1 role="examples">
+  &reftitle.examples;
+  <para>
+   <example>
+    <title><function>array_filter</function> example</title>
+    <programlisting role="php">
 <![CDATA[
 <?php
-function dispari($var) 
+function odd($var)
 {
-    return($var % 2 == 1);
+    // returns whether the input integer is odd
+    return $var & 1;
 }
 
-function pari($var) 
+function even($var)
 {
-    return($var % 2 == 0);
+    // returns whether the input integer is even
+    return !($var & 1);
 }
 
-$array1 = array("a"=>1, "b"=>2, "c"=>3, "d"=>4, "e"=>5);
-$array2 = array(6, 7, 8, 9, 10, 11, 12);
+$array1 = ['a' => 1, 'b' => 2, 'c' => 3, 'd' => 4, 'e' => 5];
+$array2 = [6, 7, 8, 9, 10, 11, 12];
 
-echo "Dispari :\n";
-print_r(array_filter($array1, "dispari");
-echo "Pari :\n";
-print_r(array_filter($array2, "pari");
+echo "Odd :\n";
+print_r(array_filter($array1, "odd"));
+echo "Even:\n";
+print_r(array_filter($array2, "even"));
 ?>
 ]]>
-      </programlisting>
-      &example.outputs;
-      <screen role="php">
+    </programlisting>
+    &example.outputs;
+    <screen role="php">
 <![CDATA[
-Dispari :
+Odd :
 Array
 (
     [a] => 1
     [c] => 3
     [e] => 5
 )
-Pari:
+Even:
 Array
 (
     [0] => 6
@@ -70,61 +174,102 @@ Array
     [6] => 12
 )
 ]]>
-      </screen>
-     </example>
-    </para>
-    <para>
-     Gli utenti non possono modificare l'array attraverso la funzione
-     di callback, ad esempio aggiungere/togliere un elemento, o cancellare l'array su cui
-     <function>array_filter</function> è applicata. Se l'array viene
-     cambiato, il comportamento di questa funzione non è definito.
-    </para>
-    <para>
-     Se la funzione <parameter>callback</parameter> non viene indicata,
-     <function>array_filter</function> rimuoverà tutti gli elementi di
-     <parameter>input</parameter> che siano uguali a &false;. Vedere <link
-     linkend="language.types.boolean.casting">conversione a boolean</link>
-     per ulteriori informazioni.
-    </para>
-    <para>
-     <example>
-      <title><function>array_filter</function> senza
-      <parameter>callback</parameter></title>
-      <programlisting role="php">
+    </screen>
+   </example>
+   <example>
+    <title><function>array_filter</function> senza
+    <parameter>callback</parameter></title>
+    <programlisting role="php">
 <![CDATA[
 <?php
 
-$entry = array(
-             0 => 'pippo',
-             1 => false,
-             2 => -1,
-             3 => null,
-             4 => ''
-          );
+$entry = [
+    0 => 'foo',
+    1 => false,
+    2 => -1,
+    3 => null,
+    4 => '',
+    5 => '0',
+    6 => 0,
+];
 
 print_r(array_filter($entry));
 ?>
 ]]>
-      </programlisting>
-      &example.outputs;
-      <screen>
+    </programlisting>
+    &example.outputs;
+    <screen>
 <![CDATA[
 Array
 (
-    [0] => pippo
+    [0] => foo
     [2] => -1
 )
 ]]>
-      </screen>
-     </example>
-    </para>
-    <para>
-     Vedere anche <function>array_map</function> e
-     <function>array_reduce</function>.
-    </para>
-   </refsect1>
-  </refentry>
+    </screen>
+   </example>
+   <example>
+    <title><function>array_filter</function> con 
+    <parameter>mode</parameter></title>
+    <programlisting role="php">
+<![CDATA[
+<?php
+
+$arr = ['a' => 1, 'b' => 2, 'c' => 3, 'd' => 4];
+
+var_dump(array_filter($arr, function($k) {
+    return $k == 'b';
+}, ARRAY_FILTER_USE_KEY));
+
+var_dump(array_filter($arr, function($v, $k) {
+    return $k == 'b' || $v == 4;
+}, ARRAY_FILTER_USE_BOTH));
+?>
+]]>
+    </programlisting>
+    &example.outputs;
+    <screen>
+<![CDATA[
+array(1) {
+  ["b"]=>
+  int(2)
+}
+array(2) {
+  ["b"]=>
+  int(2)
+  ["d"]=>
+  int(4)
+}
+]]>
+    </screen>
+   </example>
+  </para>
+ </refsect1>
+
+ <refsect1 role="notes">
+  &reftitle.notes;
+  <caution>
+   <para>
+     Se l'array viene modificato dalla callback (Es.: elemento aggiunto o rimosso)
+     il comportamento di questa funzione non è definito.
+   </para>
+  </caution>
+ </refsect1>
+
+ <refsect1 role="seealso">
+  &reftitle.seealso;
+  <para>
+   <simplelist>
+    <member><function>array_intersect</function></member>
+    <member><function>array_find</function></member>
+    <member><function>array_any</function></member>
+    <member><function>array_map</function></member>
+    <member><function>array_reduce</function></member>
+   </simplelist>
+  </para>
+ </refsect1>
 
+</refentry>
 <!-- Keep this comment at the end of the file
 Local variables:
 mode: sgml

From 3c5c3b5d3b5ccaad8cab3d0a0a4b0f82c962caf1 Mon Sep 17 00:00:00 2001
From: Manuel della Gala <74384683+ManueldG@users.noreply.github.com>
Date: Fri, 7 Feb 2025 15:19:55 +0100
Subject: [PATCH 12/47] function updated: array-change-key-case.xml ,
 array-chunk.xml, arrray-combine.xml, array-map.xml

---
 .../array/functions/array-change-key-case.xml |  6 +--
 reference/array/functions/array-chunk.xml     | 52 ++++++++++++++-----
 reference/array/functions/array-combine.xml   |  1 +
 reference/array/functions/array-map.xml       | 34 ++++++++----
 4 files changed, 67 insertions(+), 26 deletions(-)

diff --git a/reference/array/functions/array-change-key-case.xml b/reference/array/functions/array-change-key-case.xml
index d1bab21e5..e1733ac46 100644
--- a/reference/array/functions/array-change-key-case.xml
+++ b/reference/array/functions/array-change-key-case.xml
@@ -10,8 +10,8 @@
   &reftitle.description;
   <methodsynopsis>
    <type>array</type><methodname>array_change_key_case</methodname>
-   <methodparam><type>array</type><parameter>input</parameter></methodparam>
-   <methodparam choice="opt"><type>int</type><parameter>case</parameter><initializer>CASE_LOWER</initializer></methodparam>
+   <methodparam><type>array</type><parameter>array</parameter></methodparam>
+   <methodparam choice="opt"><type>int</type><parameter>case</parameter><initializer><constant>CASE_LOWER</constant></initializer></methodparam>
   </methodsynopsis>
   <para>
    Restituisce un array con tutte le chiavi di un <parameter>array</parameter> convertite
@@ -25,7 +25,7 @@
    <variablelist>
 
     <varlistentry>
-     <term><parameter>input</parameter></term>
+     <term><parameter>array</parameter></term>
      <listitem>
       <para>
        L'array su cui lavorare
diff --git a/reference/array/functions/array-chunk.xml b/reference/array/functions/array-chunk.xml
index c0da003aa..eae20499e 100644
--- a/reference/array/functions/array-chunk.xml
+++ b/reference/array/functions/array-chunk.xml
@@ -1,21 +1,21 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 965f8ae1ca8d21ba03e80e76105ee1d84bbbc81d Maintainer: cucinato Status: ready -->
+<!-- EN-Revision: 214519fdbdd6bfe2942775d3554fa8f440f85404  Maintainer: Manuel dG Status: ready -->
 <refentry xml:id="function.array-chunk" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>array_chunk</refname>
-  <refpurpose>Spezza un array in tronconi</refpurpose>
+  <refpurpose>Divide un array in più subarray</refpurpose>
  </refnamediv>
  
  <refsect1 role="description">
   &reftitle.description;
   <methodsynopsis>
    <type>array</type><methodname>array_chunk</methodname>
-   <methodparam><type>array</type><parameter>input</parameter></methodparam>
-   <methodparam><type>int</type><parameter>size</parameter></methodparam>
-   <methodparam choice="opt"><type>bool</type><parameter>preserve_keys</parameter><initializer>false</initializer></methodparam>
+   <methodparam><type>array</type><parameter>array</parameter></methodparam>
+   <methodparam><type>int</type><parameter>length</parameter></methodparam>
+   <methodparam choice="opt"><type>bool</type><parameter>preserve_keys</parameter><initializer>&false;</initializer></methodparam>
   </methodsynopsis>
   <para>
-   Spezza l'array in più array di dimensione <parameter>size</parameter>.
+   Divide l'array in più array di dimensione <parameter>length</parameter>.
    L'ultimo array potrebbe ovviamente avere una dimensione inferiore.
   </para>
  </refsect1>
@@ -26,7 +26,7 @@
    <variablelist>
 
     <varlistentry>
-     <term><parameter>input</parameter></term>
+     <term><parameter>array</parameter></term>
      <listitem>
       <para>
        L'array su cui lavorare
@@ -35,7 +35,7 @@
     </varlistentry>
 
     <varlistentry>
-     <term><parameter>size</parameter></term>
+     <term><parameter>length</parameter></term>
      <listitem>
       <para>
        La dimensione di ogni pezzo
@@ -47,8 +47,8 @@
      <term><parameter>preserve_keys</parameter></term>
      <listitem>
       <para>
-       Quando è &true; le chiavi sono mantenute.
-       Il default è &false; che reindicizza le chiavi con valori numerici
+       Quando è impostato a &true; le chiavi sono mantenute.
+       Il valore di default è &false; che reindicizza le chiavi con valori numerici
       </para>
      </listitem>
     </varlistentry>
@@ -61,18 +61,43 @@
   &reftitle.returnvalues;
   <para>
    Restituisce un array multidimensionale indicizzato numericamente, a partire da zero,
-   con ogni dimensione contenente <parameter>size</parameter> elementi.
+   con ogni dimensione contenente <parameter>lenght</parameter> elementi.
   </para>
  </refsect1>
 
  <refsect1 role="errors">
   &reftitle.errors;
   <para>
-   Se <parameter>size</parameter> è minore di 1
-   <constant>E_WARNING</constant> verrà lanciata e sarà restituito &null;.
+   Se <parameter>length</parameter> è meno di <literal>1</literal>,
+   un <classname>ValueError</classname> sarà lanciato.
   </para>
  </refsect1>
 
+ <refsect1 role="changelog">
+  &reftitle.changelog;
+  <informaltable>
+   <tgroup cols="2">
+    <thead>
+     <row>
+      <entry>&Version;</entry>
+      <entry>&Description;</entry>
+     </row>
+    </thead>
+    <tbody>
+     <row>
+      <entry>8.0.0</entry>
+      <entry>
+       Se <parameter>length</parameter> è minore di <literal>1</literal>,
+       un <classname>ValueError</classname> sarà generato;
+       precedentemente, veniva lanciato un errore di tipo <constant>E_WARNING</constant>
+       e la funzione restituiva &null;.
+      </entry>
+     </row>
+    </tbody>
+   </tgroup>
+  </informaltable>
+ </refsect1>
+
  <refsect1 role="examples">
   &reftitle.examples;
   <para>
@@ -146,7 +171,6 @@ Array
  </refsect1>
 
 </refentry>
-
 <!-- Keep this comment at the end of the file
 Local variables:
 mode: sgml
diff --git a/reference/array/functions/array-combine.xml b/reference/array/functions/array-combine.xml
index 8c5776a5c..427d58b08 100644
--- a/reference/array/functions/array-combine.xml
+++ b/reference/array/functions/array-combine.xml
@@ -130,6 +130,7 @@ Array
     <member><function>array_merge</function></member>
     <member><function>array_walk</function></member>
     <member><function>array_values</function></member>
+    <member><function>array_map</function></member>
    </simplelist>
   </para>
  </refsect1>
diff --git a/reference/array/functions/array-map.xml b/reference/array/functions/array-map.xml
index f4f6f9b1c..08311c8af 100644
--- a/reference/array/functions/array-map.xml
+++ b/reference/array/functions/array-map.xml
@@ -11,9 +11,9 @@
   &reftitle.description;
   <methodsynopsis>
    <type>array</type><methodname>array_map</methodname>
-   <methodparam><type>callable</type><parameter>callback</parameter></methodparam>
-   <methodparam><type>array</type><parameter>array1</parameter></methodparam>
-   <methodparam choice="opt"><type>array</type><parameter>...</parameter></methodparam>
+   <methodparam><type class="union"><type>callable</type><type>null</type></type><parameter>callback</parameter></methodparam>
+   <methodparam><type>array</type><parameter>array</parameter></methodparam>
+   <methodparam rep="repeat"><type>array</type><parameter>arrays</parameter></methodparam>
   </methodsynopsis>
   <para>
    <function>array_map</function> restituisce un &array; che contiene
@@ -54,7 +54,7 @@
      </listitem>
     </varlistentry>
     <varlistentry>
-     <term><parameter>array1</parameter></term>
+     <term><parameter>array</parameter></term>
      <listitem>
       <para>
        Un array su cui eseguire la funzione <parameter>callback</parameter>.
@@ -62,7 +62,7 @@
      </listitem>
     </varlistentry>
     <varlistentry>
-     <term><parameter>...</parameter></term>
+     <term><parameter>arrays</parameter></term>
      <listitem>
       <para>
        Array di argomenti supplementari da eseguire nella
@@ -89,6 +89,23 @@
   </para>
  </refsect1>
 
+ <refsect1 role="changelog">
+  &reftitle.changelog;
+  <informaltable>
+   <tgroup cols="2">
+    <thead>
+     <row>
+      <entry>&Version;</entry>
+      <entry>&Description;</entry>
+     </row>
+    </thead>
+    <tbody>
+     &array.changelog.by-ref;
+    </tbody>
+   </tgroup>
+  </informaltable>
+ </refsect1>
+
  <refsect1 role="examples">
   &reftitle.examples;
   <para>
@@ -131,7 +148,7 @@ Array
     <programlisting role="php">
 <![CDATA[
 <?php
-$func = function($value) {
+$func = function(int $value): int {
     return $value * 2;
 };
 
@@ -164,12 +181,12 @@ Array
     <programlisting role="php">
 <![CDATA[
 <?php
-function show_Spanish($n, $m)
+function show_Spanish(int $n, string $m): string
 {
     return "Il numero {$n} si dice {$m} in Spagnolo";
 }
 
-function map_Spanish($n, $m)
+function map_Spanish(int $n, string $m): array
 {
     return [$n => $m];
 }
@@ -440,7 +457,6 @@ array(3) {
   </para>
  </refsect1>
 </refentry>
-
 <!-- Keep this comment at the end of the file
 Local variables:
 mode: sgml

From 5a1f7e48b63163fd80b3ff2d9ddb3ca1ad02ef57 Mon Sep 17 00:00:00 2001
From: Manuel della Gala <74384683+ManueldG@users.noreply.github.com>
Date: Sat, 8 Feb 2025 01:12:39 +0100
Subject: [PATCH 13/47] updated :key.xml updated :extract.xml updated
 :array-multisort.xml

---
 reference/array/functions/array-multisort.xml | 128 ++++++++++--------
 reference/array/functions/extract.xml         |  81 ++++++-----
 reference/array/functions/key.xml             |  49 +++++--
 3 files changed, 150 insertions(+), 108 deletions(-)

diff --git a/reference/array/functions/array-multisort.xml b/reference/array/functions/array-multisort.xml
index bfabd297a..ea2afef86 100644
--- a/reference/array/functions/array-multisort.xml
+++ b/reference/array/functions/array-multisort.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- EN-Revision: 3ce14fde5cd5f15171a7ed2b64fdc7bd652c3842 Maintainer: cucinato Status: ready -->
+<!-- EN-Revision: 6a6f43d1c490a57b452656db285de6d136055ed2 Maintainer: Manuel dG Status: ready -->
 <refentry xml:id="function.array-multisort" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>array_multisort</refname>
@@ -15,13 +15,13 @@
    <methodparam choice="opt"><type>mixed</type><parameter>...</parameter></methodparam>
   </methodsynopsis> 
   <para>
-   <function>Array_multisort</function> Può essere usata per ordinare parecchi
-   array allo stesso tempo, oppure un array multidimensionale, rispetto a una o
+   <function>Array_multisort</function> Può essere usato per ordinare parecchi
+   array alla volta, oppure un array multidimensionale, rispetto a una o
    più dimensioni.
   </para>
   <para>
-   Mantiene le chiavi associative (tipo <type>string</type>), mentre le chiavi
-   numeriche vengono reindicizzate.
+   Le chiavi associative (tipo <type>string</type>) saranno mantenute, mentre le chiavi
+   numeriche venrranno reindicizzate.
   </para>
  </refsect1>
  
@@ -41,13 +41,13 @@
       <term><parameter>array1_sort_order</parameter></term>
       <listitem>
        <para>
-        L'ordinamento da applicare al precedente argomento <type>array</type>. Può essere
-        <constant>SORT_ASC</constant> per un ordinamento crescente o <constant>SORT_DESC</constant>
-        per un ordinamento decrescente.
+        L'ordinamento da applicare al precedente <type>array</type> argomento. Either
+        <constant>SORT_ASC</constant> per ordinare in modo ascendente o <constant>SORT_DESC</constant>
+        in modo discendente.
        </para>
        <para>
         Questo argomento può essere scambiato con <parameter>array1_sort_flags</parameter>
-        o completamente omesso, nel qual caso si usa per default <constant>SORT_ASC</constant>.
+        o può essere omesso completamente, in questo caso <constant>SORT_ASC</constant> è il valore di default.
        </para>
       </listitem>
      </varlistentry>
@@ -58,38 +58,38 @@
         Opzioni di ordinamento per il precedente argomento <type>array</type>:
        </para>
        <para>
-        Flag di tipo:
+        Flag tipo d'ordinamento:
         <itemizedlist>
          <listitem>
-          <simpara><constant>SORT_REGULAR</constant> - confronta gli elementi in modo normale
-           (non cambiare il tipo)</simpara>
-         </listitem>
-         <listitem>
-          <simpara><constant>SORT_NUMERIC</constant> - confronta gli elementi numericamente</simpara>
-         </listitem>
-         <listitem>
-          <simpara><constant>SORT_STRING</constant> - confronta gli elementi come stringhe</simpara>
-         </listitem>
-         <listitem>
-          <simpara>
-           <constant>SORT_LOCALE_STRING</constant> - confronta gli elementi come
-           stringhe, basandosi sull'attuale impostazione di localizzazione. Usa la localizzazione,
-           che può essere cambiata con <function>setlocale</function>
-          </simpara>
-         </listitem>
-         <listitem>
-          <simpara>
-           <constant>SORT_NATURAL</constant> - confronta gli elementi come stringhe
-           usando l'"ordinamento naturale" come <function>natsort</function>
-          </simpara>
-         </listitem>
-         <listitem>
-          <simpara>
-           <constant>SORT_FLAG_CASE</constant> - può essere combinato
-           (OR binario) con
-           <constant>SORT_STRING</constant> o
-           <constant>SORT_NATURAL</constant> per ordinare le stringhe senza tener conte delle maiuscole/minuscole
-          </simpara>
+          <simpara><constant>SORT_REGULAR</constant> - ordina gli elementi in modo normale
+         (non cambia tipo)</simpara>
+        </listitem>
+        <listitem>
+         <simpara><constant>SORT_NUMERIC</constant> - ordina gli elementi in modo numerico</simpara>
+        </listitem>
+        <listitem>
+         <simpara><constant>SORT_STRING</constant> -  ordina gli elementi in modo stringa</simpara>
+        </listitem>
+        <listitem>
+         <simpara>
+          <constant>SORT_LOCALE_STRING</constant> -  ordina gli elementi in modo 
+          stringa, basandosi sulla corrente impostazione locale. Usa l'impostazione locale,
+          che può essere modificata con <function>setlocale</function>
+         </simpara>
+        </listitem>
+        <listitem>
+         <simpara>
+          <constant>SORT_NATURAL</constant> - ordina gli elementi come stringhe
+          usando "ordinamento naturale" come per <function>natsort</function>
+         </simpara>
+        </listitem>
+        <listitem>
+         <simpara>
+          <constant>SORT_FLAG_CASE</constant> - può essere cominato con
+          (bitwise OR) 
+          <constant>SORT_STRING</constant> o
+          <constant>SORT_NATURAL</constant> per ordinare in modo case-insensitive
+         </simpara>
          </listitem>
         </itemizedlist>
        </para>
@@ -117,7 +117,7 @@
    &return.success;
   </para>
  </refsect1>
- 
+ <!--
  <refsect1 role="changelog">
   &reftitle.changelog;
   <para>
@@ -148,7 +148,7 @@
     </tgroup>
    </informaltable>
   </para>
- </refsect1>
+ </refsect1>-->
  
  <refsect1 role="examples">
   &reftitle.examples;
@@ -158,8 +158,8 @@
     <programlisting role="php">
 <![CDATA[
 <?php
-$ar1 = array("10", 100, 100, "a");
-$ar2 = array(1, 3, "2", 1);
+$ar1 = array(10, 100, 100, 0);
+$ar2 = array(1, 3, 2, 4);
 array_multisort($ar1, $ar2);
 
 var_dump($ar1);
@@ -168,10 +168,16 @@ var_dump($ar2);
 ]]>
     </programlisting>
     <para>
+
+     In this example, after sorting, the first array will contain 0,
+     10, 100, 100. The second array will contain 4, 1, 2, 3. The
+     entries in the second array corresponding to the identical
+     entries in the first array (100 and 100) were sorted as well.
+
      In questo esempio, dopo l'ordinamento, il primo array conterrà 0,
      10, 100, 100. Il secondo array conterrà 4, 1, 2, 3. Gli
-     elementi del secondo array corrispondenti a quelli, identici, del
-     primo array (100 e 100), vengono pure ordinati.
+     elementi del secondo array con le chiavi corrispondenti a quelle, del
+     primo array (100 e 100), vengono ordinati allo stesso modo.
     </para>
     <screen>
 <![CDATA[
@@ -244,7 +250,7 @@ array(2) {
      dei record di database.
     </para>
     <para>
-     Esempio di dati:
+     Example data:
     </para>
     <screen>
 <![CDATA[
@@ -260,7 +266,7 @@ volume | edition
       </screen>
       <para>
        I dati sono in un array, chiamato <varname>data</varname>. Di solito
-       questo si ottiene ciclando, ad esempio, con <function>mysql_fetch_assoc</function>.
+       questo si ottiene ciclando, per esempio, usando <function>mysql_fetch_assoc</function>.
       </para>
       <programlisting role="php">
 <![CDATA[
@@ -275,13 +281,13 @@ $data[] = array('volume' => 67, 'edition' => 7);
 ]]>
       </programlisting>
       <para>
-       In questo esempio ordineremo <varname>volume</varname> in senso discendente,
-       <varname>edition</varname> in senso ascendente.
+       In questo esempio ordineremo <varname>volume</varname> in modo discendente,
+       mentre <varname>edition</varname> in modo ascendente.
       </para>
       <para>
-       Abbiamo un array di record, ma <function>array_multisort</function>
+       Abbiamo un array di righe, mentre <function>array_multisort</function>
        richiede un array di colonne, quindi usiamo il codice qui sotto per ottenerlo,
-       quindi eseguiremo l'ordinamento.
+       e quindi eseguire l'ordinamento.
       </para>
       <programlisting role="php">
 <![CDATA[
@@ -291,9 +297,13 @@ foreach ($data as $key => $row) {
     $volume[$key]  = $row['volume'];
     $edition[$key] = $row['edition'];
 }
+// puoi usare array_column() invece del codice posto qui sopra
+$volume = array_column($data, 'volume');
+$edition = array_column($data, 'edition');
+
+// Ordina i dati volume in modo decrescente, edizione in modo crescente
+// Aggiungi $data come ultimo parametro, per ordinarlo in base alla chiave comune
 
-// Ordina 'volume' in senso discendente, 'edition' in senso ascendente
-// Aggiungere $data come ultimo parametr per ordinare sulla chiave comune
 array_multisort($volume, SORT_DESC, $edition, SORT_ASC, $data);
 ?>
 ]]>
@@ -317,16 +327,16 @@ volume | edition
   </para>
   <para>
    <example>
-    <title>Ordinamento senza distinzione tra maiuscole e minuscole</title>
+    <title>Ordinamento Case insensitive </title>
     <para>
      Sia <constant>SORT_STRING</constant> che
-     <constant>SORT_REGULAR</constant> tengono conto delle maiuscole, le stringhe
-     che iniziano con una maiuscola vengono prima di quelle che iniziano con
-     una minuscola.
+     <constant>SORT_REGULAR</constant> cono case sensitive, le stringhe
+     iniziano con una lettera maiuscola vengono prima di quelle che iniziano con
+      una minuscola.
     </para>
     <para>
-     Per ottenere un ordinamento che ignori le maiuscole, forzarlo in modo
-     che sia determnato da una copia dell'array originale formata da sole minuscole.
+     Per ottenere un ordinamento case insensitive, bisogna forzare l'ordinamento
+     in modo che sia determnato da una copia dell'array originale formata da sole minuscole.
     </para>
     <programlisting role="php">
 <![CDATA[
diff --git a/reference/array/functions/extract.xml b/reference/array/functions/extract.xml
index 35e405485..b76d2efe8 100644
--- a/reference/array/functions/extract.xml
+++ b/reference/array/functions/extract.xml
@@ -1,10 +1,10 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 4a7ddddc27271967b616ad3400cfbe2a9b48212b Maintainer: pastore Status: ready -->
+<!-- EN-Revision: d58ee8eaaa7f716c51f66f5f1058ab3c42376d98 Maintainer: Manuel dG Status: ready -->
 <!-- CREDITS: cucinato -->
 <refentry xml:id="function.extract" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
-  <refname>extract</refname>
-  <refpurpose>Importa le variabili nella tabella dei simboli corrente da un array</refpurpose>
+  <refname>extract</refname>  
+  <refpurpose>Restituisce delle variabili a partire da un array </refpurpose>
  </refnamediv>
  <refsect1 role="description">
   &reftitle.description;
@@ -15,7 +15,8 @@
    <methodparam choice="opt"><type>string</type><parameter>prefix</parameter><initializer>""</initializer></methodparam>
   </methodsynopsis>
   <para>
-   Importa le variabili nella tabella dei simboli corrente da un array.
+   Importa variabili da un array nella 
+   <link linkend="features.gc.refcounting-basics">symbol table</link>.
   </para>
   <para>
    Controlla ogni chiave per vedere se ha un nome di variabile valido.
@@ -43,7 +44,7 @@
        parametri <parameter>flags</parameter> e <parameter>prefix</parameter>.
       </para>
       <para>
-       È necessario utilizzare un array associativo; un array indicizzato numericamente
+       È necessario utilizzare un array associativo; un array indicizzato di tipo numerico
        non produrrà risultati a meno che non si utilizzi <constant>EXTR_PREFIX_ALL</constant> o
        <constant>EXTR_PREFIX_INVALID</constant>.
       </para>
@@ -61,7 +62,7 @@
          <term><constant>EXTR_OVERWRITE</constant></term>
          <listitem>
           <simpara>
-           In caso di collisione, sovrascrivi la variabile esistente.
+           In caso di collisione, la variabile esistente viene sovrascritta.
           </simpara>
          </listitem>
         </varlistentry>
@@ -69,7 +70,7 @@
          <term><constant>EXTR_SKIP</constant></term>
          <listitem>
           <simpara>
-           In caso di collisione, non sovrascrivere la variabile
+           In caso di collisione, non sovrascrive la variabile
            esistente.
           </simpara>
          </listitem>
@@ -77,7 +78,7 @@
         <varlistentry>
          <term><constant>EXTR_PREFIX_SAME</constant></term>
          <listitem>
-          <simpara>In caso di collisione, anteporre al nome della variabile il prefisso
+          <simpara>In caso di collisione, antepone al nome della variabile il prefisso
            <parameter>prefix</parameter>.
           </simpara>
          </listitem>
@@ -86,7 +87,7 @@
          <term><constant>EXTR_PREFIX_ALL</constant></term>
          <listitem>
           <simpara>
-           Prefissa tutti i nomi delle variabili con
+           Antepone a tutti i nomi delle variabili
            <parameter>prefix</parameter>.
           </simpara>
          </listitem>
@@ -96,7 +97,7 @@
          <listitem>
           <simpara>
            Aggiunge il prefisso <parameter>prefix</parameter> solo ai nomi di variabili
-           non valide/numeriche.
+           non validi/numerici.          
           </simpara>
          </listitem>
         </varlistentry>
@@ -116,18 +117,18 @@
          <term><constant>EXTR_PREFIX_IF_EXISTS</constant></term>
          <listitem>
           <simpara>
-           Crea nomi di variabili con prefisso solo se la versione senza prefisso
-           della stessa variabile esiste nella tabella dei simboli corrente.
+           Crea nomi di variabili con prefisso solo se la versione originale
+           della variabile esiste nella tabella dei simboli corrente.
           </simpara>
          </listitem>
         </varlistentry>
         <varlistentry>
          <term><constant>EXTR_REFS</constant></term>
          <listitem>
-          <simpara>
-           Estrae le variabili come riferimenti. Ciò significa effettivamente che i
-           valori delle variabili importate fanno ancora riferimento ai valori del
-           parametro <parameter>array</parameter>. Si può usare questo flag
+          <simpara>           
+           Estrae le variabili per riferimento. Ciò significa effettivamente che i
+           valori delle variabili importate fanno ancora riferimento ai valori 
+           dell'<parameter>array</parameter>. Si può usare questo flag
            da solo o combinarlo con qualsiasi altro flag utilizzando l'OR dei
            <parameter>flags</parameter>.
           </simpara>
@@ -136,8 +137,8 @@
        </variablelist>
       </para>
       <para>
-       Se <parameter>flags</parameter> non è specificato, si
-       presume che sia <constant>EXTR_OVERWRITE</constant>.
+       Se <parameter>flags</parameter> non è specificato, 
+       il valore di default è <constant>EXTR_OVERWRITE</constant>.
       </para>
      </listitem>
     </varlistentry>
@@ -145,12 +146,12 @@
      <term><parameter>prefix</parameter></term>
      <listitem>
       <para>
-       Notare che <parameter>prefix</parameter> è richiesto solo se
-       <parameter>flags</parameter> è <constant>EXTR_PREFIX_SAME</constant>,
+       Notare che <parameter>prefix</parameter> è richiesto solo se sono attivi i
+       <parameter>flags</parameter>  <constant>EXTR_PREFIX_SAME</constant>,
        <constant>EXTR_PREFIX_ALL</constant>, <constant>EXTR_PREFIX_INVALID</constant>
        o <constant>EXTR_PREFIX_IF_EXISTS</constant>. Se
        il risultato con prefisso non è un nome di variabile valido, non viene
-       importato nella tabella dei simboli. I prefissi vengono separati automaticamente dalla
+       importato nella tabella dei simboli. I prefissi vengono automaticamente separati dalla
        chiave dell'array da un carattere underscore.
       </para>
      </listitem>
@@ -182,11 +183,14 @@
 /* Si supponga che $var_array sia un array restituito da
    wddx_deserialize */
 
-$size = "grande";
-$array_variabili = array("color" => "blu",
-                         "size"  => "media",
-                         "shape" => "sfera");
-extract($array_variabili, EXTR_PREFIX_SAME, "wddx");
+$size = "large";
+$var_array = array(
+    "color" => "blue",
+    "size"  => "medium",
+    "shape" => "sphere"
+);
+
+extract($var_array, EXTR_PREFIX_SAME, "wddx");
 
 echo "$color, $size, $shape, $wddx_size\n";
 
@@ -196,17 +200,26 @@ echo "$color, $size, $shape, $wddx_size\n";
     &example.outputs;
     <screen>
 <![CDATA[
-blu, grande, sfera, media
+blue, large, sphere, medium
 ]]>
     </screen>
     <para>
+      The <varname>$size</varname> wasn't overwritten because we specified
+     <constant>EXTR_PREFIX_SAME</constant>, which resulted in
+     <varname>$wddx_size</varname> being created.  If <constant>EXTR_SKIP</constant> was
+     specified, then <varname>$wddx_size</varname> wouldn't even have been created.
+     <constant>EXTR_OVERWRITE</constant> would have caused <varname>$size</varname> to have
+     value "medium", and <constant>EXTR_PREFIX_ALL</constant> would result in new variables
+     being named <varname>$wddx_color</varname>,
+     <varname>$wddx_size</varname>, and
+
      <varname>$size</varname> non è stato sovrascritto perché abbiamo specificato
      <constant>EXTR_PREFIX_SAME</constant>, che ha portato alla
      creazione di <varname>$wddx_size</varname>. Se fosse stato specificato
-     <constant>EXTR_SKIP</constant>, allora <varname>$wddx_size</varname> non sarebbe nemmeno stato creato.
+     <constant>EXTR_SKIP</constant>, allora <varname>$wddx_size</varname> non sarebbe stato creato.
      <constant>EXTR_OVERWRITE</constant> avrebbe fatto sì che <varname>$size</varname> avesse
-     il valore "medio" e <constant>EXTR_PREFIX_ALL</constant> avrebbe comportato nuove variabili
-     con nomi <varname>$wddx_color</varname>,
+     il valore "medio" <constant>EXTR_PREFIX_ALL</constant> e avrebbe comportato
+     che le nuove variabili verrebbero chiamante <varname>$wddx_color</varname>,
      <varname>$wddx_size</varname> e
      <varname>$wddx_shape</varname>.
     </para>
@@ -220,10 +233,10 @@ blu, grande, sfera, media
     Non utilizzare <function>extract</function> su dati non attendibili, come
     l'input dell'utente
     (per esempio <varname>$_GET</varname>, <varname>$_FILES</varname>, ecc.).
-    In tal caso, assicurarsi di utilizzare uno dei valori di <parameter>flags</parameter>
-    che non sovrascrivono come
-    <constant>EXTR_SKIP</constant> e tenere presente che si dovrebbe estrarre
-    nello stesso ordine definito in
+    Se o fai, assicurati di usare uno dei <parameter>flags</parameter>
+    che non sovrascrivono le variabili come
+    <constant>EXTR_SKIP</constant> e fare in modo di estrarre
+    nello stesso ordine definito di come è stato definito in 
     <link linkend="ini.variables-order">variables_order</link> all'interno del
     <link linkend="ini">&php.ini;</link>.
    </para>
diff --git a/reference/array/functions/key.xml b/reference/array/functions/key.xml
index 4fdc21bd4..540a449bb 100644
--- a/reference/array/functions/key.xml
+++ b/reference/array/functions/key.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 96c9d88bad9a7d7d44bfb7f26c226df7ee9ddf26 Maintainer: cucinato Status: ready -->
+<!-- EN-Revision: 0a192fcd9cc43c0007de795063b4494974058992 Maintainer: Manuel dG Status: ready -->
 <!-- splitted from ./it/functions/array.xml, last change in rev 1.24 -->
 <refentry xml:id="function.key" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
@@ -9,12 +9,12 @@
  <refsect1 role="description">
   &reftitle.description;
   <methodsynopsis>
-   <type>mixed</type><methodname>key</methodname>
-   <methodparam><type>array</type><parameter role="reference">array</parameter></methodparam>
+   <type class="union"><type>int</type><type>string</type><type>null</type></type><methodname>key</methodname>
+   <methodparam><type class="union"><type>array</type><type>object</type></type><parameter>array</parameter></methodparam>
   </methodsynopsis>
   <para>
-   <function>key</function> restituisce la chiave corrispondente
-   all'attuale posizione del puntatore interno all'array.
+   <function>key</function> restituisce la chiave dell'elemento
+   corrente dell'array;
   </para>
  </refsect1>
  <refsect1 role="parameters">
@@ -34,14 +34,32 @@
  </refsect1>
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
-  <para>
-   La funzione <function>key</function> restituisce la
-   chiave dell'elemento dell'array che è attualmente indicato dal
+  <para>   
+   La funzione <function>key</function> restituisce semplicemente la
+   chiave dell'elemento che è attualmente indicato dal
    puntatore interno. Non modifica il puntatore. Se il
-   puntatore punta oltre la fine della lista degli elementi, oppure se l'array è
+   puntatore interno punta oltre la fine della lista degli elementi, oppure se l'array è
    vuoto, <function>key</function> restituisce &null;.
   </para>
  </refsect1>
+
+ <refsect1 role="changelog">
+  &reftitle.changelog;
+  <informaltable>
+   <tgroup cols="2">
+    <thead>
+     <row>
+      <entry>&Version;</entry>
+      <entry>&Description;</entry>
+     </row>
+    </thead>
+    <tbody>
+     &standard.changelog.calling-on-objects; 
+    </tbody>
+   </tgroup>
+  </informaltable>
+ </refsect1>
+
  <refsect1 role="examples">
   &reftitle.examples;
   <para>
@@ -57,11 +75,11 @@ $array = array(
     'frutto4' => 'mela',
     'frutto5' => 'mela');
 
-// questo ciclo mostra tutte le chiavi
-// dell'array associativo che sono uguali a 'mela'
-while ($nome_frutto = current($array)( {
-    if ($nome_frutto == 'mela') {
-        echo key($array).'<br />';
+// questo ciclo mostra tute le chiavi associative 
+//dell'array che sono aguali a "mela"
+while ($fruit_name = current($array)) {
+    if ($fruit_name == 'mela') {
+        echo key($array), "\n";
     }
     next($array);
 }
@@ -85,11 +103,12 @@ frutto5<br />
    <simplelist>
     <member><function>current</function></member>
     <member><function>next</function></member>
+    <member><function>array_key_first</function></member>
+    <member><link linkend="control-structures.foreach">foreach</link></member>
    </simplelist>
   </para>
  </refsect1>
 </refentry>
-
 <!-- Keep this comment at the end of the file
 Local variables:
 mode: sgml

From 5fb932e2f7613419a2b64bfda302ec0d998a9f70 Mon Sep 17 00:00:00 2001
From: Manuel della Gala <74384683+ManueldG@users.noreply.github.com>
Date: Wed, 12 Feb 2025 21:48:38 +0100
Subject: [PATCH 14/47] fix typo array-combine.xml

---
 reference/array/functions/array-combine.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/reference/array/functions/array-combine.xml b/reference/array/functions/array-combine.xml
index 427d58b08..92fb1c7c4 100644
--- a/reference/array/functions/array-combine.xml
+++ b/reference/array/functions/array-combine.xml
@@ -112,7 +112,7 @@ print_r($c);
     <screen>
 <![CDATA[
 Array
-(
+( 
     [green]  => avocado
     [red]    => apple
     [yellow] => banana

From d42ba728fc453f5c29e571c2daa41aab8c0b23c0 Mon Sep 17 00:00:00 2001
From: Manuel della Gala <74384683+ManueldG@users.noreply.github.com>
Date: Wed, 12 Feb 2025 21:49:13 +0100
Subject: [PATCH 15/47] fix typo array-count-values.xml


From 0e3bca9099d313fd5dd803dc9964ed951f755e22 Mon Sep 17 00:00:00 2001
From: Manuel della Gala <74384683+ManueldG@users.noreply.github.com>
Date: Wed, 12 Feb 2025 21:50:02 +0100
Subject: [PATCH 16/47] fix typo array-diff-assoc.xml

---
 reference/array/functions/array-diff-assoc.xml | 9 ---------
 1 file changed, 9 deletions(-)

diff --git a/reference/array/functions/array-diff-assoc.xml b/reference/array/functions/array-diff-assoc.xml
index 9e1848b0c..0dcb1218b 100644
--- a/reference/array/functions/array-diff-assoc.xml
+++ b/reference/array/functions/array-diff-assoc.xml
@@ -35,15 +35,6 @@
      </listitem>
     </varlistentry>
 
-    <varlistentry>
-     <term><parameter>arrays</parameter></term>
-     <listitem>
-      <para>
-       Arrays to compare against
-      </para>
-     </listitem>
-    </varlistentry>
-
    </variablelist>
   </para>
  </refsect1>

From 1203da5e3c7a42b82c9c135ed88e4e8cdb84b8e8 Mon Sep 17 00:00:00 2001
From: Manuel della Gala <74384683+ManueldG@users.noreply.github.com>
Date: Wed, 12 Feb 2025 21:57:39 +0100
Subject: [PATCH 17/47] fix typo in array-key-exist.xml


From 2ba5b95656ecd0fa6c14ae12bd3d137fd6eaef7f Mon Sep 17 00:00:00 2001
From: Manuel della Gala <74384683+ManueldG@users.noreply.github.com>
Date: Wed, 12 Feb 2025 21:58:00 +0100
Subject: [PATCH 18/47] fix typo array-map.xml


From a119c730fc3e88633a6aae3ceefcdc1a53d5d44e Mon Sep 17 00:00:00 2001
From: Manuel della Gala <74384683+ManueldG@users.noreply.github.com>
Date: Wed, 12 Feb 2025 22:00:59 +0100
Subject: [PATCH 19/47] fix typo array-merge-recursive.xml

---
 reference/array/functions/array-merge-recursive.xml | 2 --
 1 file changed, 2 deletions(-)

diff --git a/reference/array/functions/array-merge-recursive.xml b/reference/array/functions/array-merge-recursive.xml
index ac7c607aa..0de7ac287 100644
--- a/reference/array/functions/array-merge-recursive.xml
+++ b/reference/array/functions/array-merge-recursive.xml
@@ -48,8 +48,6 @@
   <para>
    Un array di valori risultante dalla fusione degli argomenti.
    Se usata senza nessun argomento, ritorna un &array; vuoto.
-   An array of values resulted from merging the arguments together.
-   If called without any arguments, returns an empty &array;.
   </para>
  </refsect1>
 

From dc8cdc93cd668c23fe2cd2e0e944d45ea6aea660 Mon Sep 17 00:00:00 2001
From: Manuel della Gala <74384683+ManueldG@users.noreply.github.com>
Date: Wed, 12 Feb 2025 22:09:41 +0100
Subject: [PATCH 20/47] fix typo in array-combine.xml


From 73fe8599aaff64ff60196a89e651a50daceaa044 Mon Sep 17 00:00:00 2001
From: Manuel della Gala <74384683+ManueldG@users.noreply.github.com>
Date: Wed, 12 Feb 2025 22:10:03 +0100
Subject: [PATCH 21/47] fix typo in array-count-values.xml


From 9042924ab746c78bf6306b50f81b8402ba4e9fee Mon Sep 17 00:00:00 2001
From: Manuel della Gala <74384683+ManueldG@users.noreply.github.com>
Date: Wed, 12 Feb 2025 22:10:30 +0100
Subject: [PATCH 22/47] fix typo in array-diff-assoc.xml


From 0d5ecef858d6753c84b8f632075c21938664aa2e Mon Sep 17 00:00:00 2001
From: Manuel della Gala <74384683+ManueldG@users.noreply.github.com>
Date: Wed, 12 Feb 2025 22:10:50 +0100
Subject: [PATCH 23/47] fix typo in array-key-exist.xml


From 305f86a29aaf871edbb6661860e5f65162a160d5 Mon Sep 17 00:00:00 2001
From: Manuel della Gala <74384683+ManueldG@users.noreply.github.com>
Date: Wed, 12 Feb 2025 22:11:03 +0100
Subject: [PATCH 24/47] fix typo in array-map.xml


From b08c1378e058a357a61b286ea19ea14e4c678423 Mon Sep 17 00:00:00 2001
From: Manuel della Gala <74384683+ManueldG@users.noreply.github.com>
Date: Wed, 12 Feb 2025 22:11:25 +0100
Subject: [PATCH 25/47] fix typo in array-merge-recursive.xml


From 34a8daa8cd4755f7e64af33f59dbd3c9ee77a7ac Mon Sep 17 00:00:00 2001
From: Manuel della Gala <74384683+ManueldG@users.noreply.github.com>
Date: Thu, 13 Feb 2025 13:44:38 +0100
Subject: [PATCH 26/47] Revert "fix typo array-map.xml"

This reverts commit 22a86e75543cc6a0ccfbf359514cb7554dabfd93.
---
 reference/array/functions/array-map.xml | 17 +++++++++++++++++
 1 file changed, 17 insertions(+)

diff --git a/reference/array/functions/array-map.xml b/reference/array/functions/array-map.xml
index 08311c8af..a427de18d 100644
--- a/reference/array/functions/array-map.xml
+++ b/reference/array/functions/array-map.xml
@@ -58,6 +58,7 @@
      <listitem>
       <para>
        Un array su cui eseguire la funzione <parameter>callback</parameter>.
+       Un array su cui eseguire la funzione <parameter>callback</parameter>.
       </para>
      </listitem>
     </varlistentry>
@@ -110,6 +111,7 @@
   &reftitle.examples;
   <para>
    <example>
+    <title>Esempio di <function>array_map</function></title>
     <title>Esempio di <function>array_map</function></title>
     <programlisting role="php">
 <![CDATA[
@@ -127,6 +129,7 @@ print_r($b);
     </programlisting>
     <para>
      Questo fa sì che <varname>$b</varname> abbia:
+     Questo fa sì che <varname>$b</varname> abbia:
     </para>
     <screen>
 <![CDATA[
@@ -144,6 +147,7 @@ Array
   </para>
   <para>
    <example>
+    <title><function>array_map</function> usando una funzione lambda (a partire da PHP 5.3.0)</title>
     <title><function>array_map</function> usando una funzione lambda (a partire da PHP 5.3.0)</title>
     <programlisting role="php">
 <![CDATA[
@@ -177,6 +181,7 @@ Array
   </para>
   <para>
    <example>
+    <title><function>array_map</function> - usando più array</title>
     <title><function>array_map</function> - usando più array</title>
     <programlisting role="php">
 <![CDATA[
@@ -254,14 +259,23 @@ Array
    corrispondenti.
    Se gli array sono di lunghezza diversa, quelli più corti verranno estesi con elementi
    vuoti per uguagliare la lunghezza del più lungo.
+   Di solito quando si usano due o più array, questi dovrebbero essere di uguale lunghezza
+   in quanto la funzione di callback viene applicata in parallelo agli elementi
+   corrispondenti.
+   Se gli array sono di lunghezza diversa, quelli più corti verranno estesi con elementi
+   vuoti per uguagliare la lunghezza del più lungo.
   </para>
   <para>
    Un uso interessante di questa funzione è quello di costruire un array di array,
    cosa che può essere facilmente ottenuta usando &null;
    come nome della funzione callback
+   Un uso interessante di questa funzione è quello di costruire un array di array,
+   cosa che può essere facilmente ottenuta usando &null;
+   come nome della funzione callback
   </para>
   <para>
    <example>
+    <title>Esecuzione di un'operazione zip di array</title>
     <title>Esecuzione di un'operazione zip di array</title>
     <programlisting role="php">
 <![CDATA[
@@ -326,6 +340,8 @@ Array
     <title>
      <parameter>callback</parameter> &null; con solo
      <parameter>array1</parameter>
+     <parameter>callback</parameter> &null; con solo
+     <parameter>array1</parameter>
     </title>
     <programlisting role="php">
 <![CDATA[
@@ -352,6 +368,7 @@ array(3) {
   </para>
   <para>
    <example>
+    <title><function>array_map</function> - con chiavi stringa</title>
     <title><function>array_map</function> - con chiavi stringa</title>
     <programlisting role="php">
 <![CDATA[

From a6581194129ed4ffd713d7f607cda9f01716a674 Mon Sep 17 00:00:00 2001
From: Manuel della Gala <74384683+ManueldG@users.noreply.github.com>
Date: Thu, 13 Feb 2025 13:50:46 +0100
Subject: [PATCH 27/47] fix typo array-map.xml

---
 reference/array/functions/array-map.xml | 17 -----------------
 1 file changed, 17 deletions(-)

diff --git a/reference/array/functions/array-map.xml b/reference/array/functions/array-map.xml
index a427de18d..08311c8af 100644
--- a/reference/array/functions/array-map.xml
+++ b/reference/array/functions/array-map.xml
@@ -58,7 +58,6 @@
      <listitem>
       <para>
        Un array su cui eseguire la funzione <parameter>callback</parameter>.
-       Un array su cui eseguire la funzione <parameter>callback</parameter>.
       </para>
      </listitem>
     </varlistentry>
@@ -111,7 +110,6 @@
   &reftitle.examples;
   <para>
    <example>
-    <title>Esempio di <function>array_map</function></title>
     <title>Esempio di <function>array_map</function></title>
     <programlisting role="php">
 <![CDATA[
@@ -129,7 +127,6 @@ print_r($b);
     </programlisting>
     <para>
      Questo fa sì che <varname>$b</varname> abbia:
-     Questo fa sì che <varname>$b</varname> abbia:
     </para>
     <screen>
 <![CDATA[
@@ -147,7 +144,6 @@ Array
   </para>
   <para>
    <example>
-    <title><function>array_map</function> usando una funzione lambda (a partire da PHP 5.3.0)</title>
     <title><function>array_map</function> usando una funzione lambda (a partire da PHP 5.3.0)</title>
     <programlisting role="php">
 <![CDATA[
@@ -181,7 +177,6 @@ Array
   </para>
   <para>
    <example>
-    <title><function>array_map</function> - usando più array</title>
     <title><function>array_map</function> - usando più array</title>
     <programlisting role="php">
 <![CDATA[
@@ -259,23 +254,14 @@ Array
    corrispondenti.
    Se gli array sono di lunghezza diversa, quelli più corti verranno estesi con elementi
    vuoti per uguagliare la lunghezza del più lungo.
-   Di solito quando si usano due o più array, questi dovrebbero essere di uguale lunghezza
-   in quanto la funzione di callback viene applicata in parallelo agli elementi
-   corrispondenti.
-   Se gli array sono di lunghezza diversa, quelli più corti verranno estesi con elementi
-   vuoti per uguagliare la lunghezza del più lungo.
   </para>
   <para>
    Un uso interessante di questa funzione è quello di costruire un array di array,
    cosa che può essere facilmente ottenuta usando &null;
    come nome della funzione callback
-   Un uso interessante di questa funzione è quello di costruire un array di array,
-   cosa che può essere facilmente ottenuta usando &null;
-   come nome della funzione callback
   </para>
   <para>
    <example>
-    <title>Esecuzione di un'operazione zip di array</title>
     <title>Esecuzione di un'operazione zip di array</title>
     <programlisting role="php">
 <![CDATA[
@@ -340,8 +326,6 @@ Array
     <title>
      <parameter>callback</parameter> &null; con solo
      <parameter>array1</parameter>
-     <parameter>callback</parameter> &null; con solo
-     <parameter>array1</parameter>
     </title>
     <programlisting role="php">
 <![CDATA[
@@ -368,7 +352,6 @@ array(3) {
   </para>
   <para>
    <example>
-    <title><function>array_map</function> - con chiavi stringa</title>
     <title><function>array_map</function> - con chiavi stringa</title>
     <programlisting role="php">
 <![CDATA[

From ff34ab40ee2979a43b2680cafbfc87d2a7ec65c9 Mon Sep 17 00:00:00 2001
From: Manuel della Gala <74384683+ManueldG@users.noreply.github.com>
Date: Thu, 13 Feb 2025 13:53:57 +0100
Subject: [PATCH 28/47] Merge branch 'original-doc' into clean-original-doc

---
 reference/array/functions/array-count-values.xml     |  7 +++++--
 reference/array/functions/array-key-exists.xml       | 12 ++++++++++--
 .../array/functions/array_replace_recursive.xml      |  1 -
 3 files changed, 15 insertions(+), 5 deletions(-)

diff --git a/reference/array/functions/array-count-values.xml b/reference/array/functions/array-count-values.xml
index 1e470da0c..044ab6e52 100644
--- a/reference/array/functions/array-count-values.xml
+++ b/reference/array/functions/array-count-values.xml
@@ -15,8 +15,8 @@
   </methodsynopsis>
   <para>
    <function>array_count_values</function> restituisce un array usando
-   i valori dell'<parameter>array</parameter> (che devono  essere &integer; o &string;) 
-   come chiavi e la frequenza degli elementi nell'<parameter>array</parameter> come valori.   
+   i valori dell'<parameter>array</parameter> (che devono  essere &integer; o &string;)
+   come chiavi e la frequenza degli elementi nell'<parameter>array</parameter> come valori.  
   </para>
  </refsect1>
 
@@ -63,6 +63,7 @@
 <![CDATA[
 <?php
 $array = array(1, "ciao", 1, "mondo", "ciao");
+$array = array(1, "ciao", 1, "mondo", "ciao");
 print_r(array_count_values($array));
 ?>
 ]]>
@@ -75,6 +76,8 @@ Array
     [1] => 2
     [ciao] => 2
     [mondo] => 1
+    [ciao] => 2
+    [mondo] => 1
 )
 ]]>
     </screen>
diff --git a/reference/array/functions/array-key-exists.xml b/reference/array/functions/array-key-exists.xml
index 5b5ba4199..0466e921c 100644
--- a/reference/array/functions/array-key-exists.xml
+++ b/reference/array/functions/array-key-exists.xml
@@ -3,8 +3,8 @@
 <!-- CREDITS: cucinato -->
 <refentry xml:id="function.array-key-exists" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
-  <refname>array_key_exists</refname>
-  <refpurpose>Checks if the given key or index exists in the array</refpurpose>
+  <refname>array_key_exists</refname> 
+  <refpurpose>Controlla se l'indice o la chiave specificato esiste nell'array</refpurpose>
  </refnamediv>
  
  <refsect1 role="description">
@@ -93,6 +93,9 @@
 <![CDATA[
 <?php
 $search_array = array('primo' => 1, 'secondo' => 4);
+if (array_key_exists('primo', $search_array)) {
+    echo "L'elemento 'primo' è nell'array";
+$search_array = array('primo' => 1, 'secondo' => 4);
 if (array_key_exists('primo', $search_array)) {
     echo "L'elemento 'primo' è nell'array";
 }
@@ -112,10 +115,15 @@ if (array_key_exists('primo', $search_array)) {
 <![CDATA[
 <?php
 $search_array = array('primo' => null, 'secondo' => 4);
+$search_array = array('primo' => null, 'secondo' => 4);
 
+// restituisce false
+isset($search_array['primo']);
 // restituisce false
 isset($search_array['primo']);
 
+// restituisce true
+array_key_exists('primo', $search_array);
 // restituisce true
 array_key_exists('primo', $search_array);
 ?>
diff --git a/reference/array/functions/array_replace_recursive.xml b/reference/array/functions/array_replace_recursive.xml
index 549b63acd..8ba2bba6f 100644
--- a/reference/array/functions/array_replace_recursive.xml
+++ b/reference/array/functions/array_replace_recursive.xml
@@ -188,4 +188,3 @@ vim600: syn=xml fen fdm=syntax fdl=2 si
 vim: et tw=78 syn=sgml
 vi: ts=1 sw=1
 -->
-

From be4ea5f918c204c5565f61eda2821aa856e71924 Mon Sep 17 00:00:00 2001
From: Manuel della Gala <74384683+ManueldG@users.noreply.github.com>
Date: Thu, 13 Feb 2025 14:27:09 +0100
Subject: [PATCH 29/47] Merge branch 'original-doc' into clean-original-doc

---
 reference/array/functions/array-diff-assoc.xml      |  5 +++++
 reference/array/functions/array-map.xml             | 10 ++++++++++
 reference/array/functions/array-merge-recursive.xml |  8 ++++++++
 3 files changed, 23 insertions(+)

diff --git a/reference/array/functions/array-diff-assoc.xml b/reference/array/functions/array-diff-assoc.xml
index 0dcb1218b..8b82db67b 100644
--- a/reference/array/functions/array-diff-assoc.xml
+++ b/reference/array/functions/array-diff-assoc.xml
@@ -92,6 +92,8 @@
 <?php
 $array1 = array("a" => "verde", "b" => "marrone", "c" => "blu", "rosso");
 $array2 = array("a" => "verde", "giallo", "rosso");
+$array1 = array("a" => "verde", "b" => "marrone", "c" => "blu", "rosso");
+$array2 = array("a" => "verde", "giallo", "rosso");
 $result = array_diff_assoc($array1, $array2);
 print_r($result);
 ?>
@@ -105,6 +107,9 @@ Array
     [b] => marrone
     [c] => blu
     [0] => rosso
+    [b] => marrone
+    [c] => blu
+    [0] => rosso
 )
 ]]>
     </screen>
diff --git a/reference/array/functions/array-map.xml b/reference/array/functions/array-map.xml
index 08311c8af..22bbe0629 100644
--- a/reference/array/functions/array-map.xml
+++ b/reference/array/functions/array-map.xml
@@ -86,6 +86,9 @@
    L'array restituito conserverà le chiavi del parametro array se e solo
    se viene passato esattamente un array. Se viene passato più di un array, l'array
    restituito avrà chiavi intere sequenziali.
+   L'array restituito conserverà le chiavi del parametro array se e solo
+   se viene passato esattamente un array. Se viene passato più di un array, l'array
+   restituito avrà chiavi intere sequenziali.
   </para>
  </refsect1>
 
@@ -206,6 +209,7 @@ print_r($d);
     <screen>
 <![CDATA[
 // stampa di $c
+// stampa di $c
 Array
 (
     [0] => Il numero 1 è chiamato uno in spagnolo
@@ -213,8 +217,14 @@ Array
     [2] => Il numero 3 è chiamato tres in spagnolo
     [3] => Il numero 4 è chiamato cuatro in spagnolo
     [4] => Il numero 5 è chiamato cinco in spagnolo
+    [0] => Il numero 1 è chiamato uno in spagnolo
+    [1] => Il numero 2 è chiamato dos in spagnolo
+    [2] => Il numero 3 è chiamato tres in spagnolo
+    [3] => Il numero 4 è chiamato cuatro in spagnolo
+    [4] => Il numero 5 è chiamato cinco in spagnolo
 )
 
+// stampa di $d
 // stampa di $d
 Array
 (
diff --git a/reference/array/functions/array-merge-recursive.xml b/reference/array/functions/array-merge-recursive.xml
index 0de7ac287..4030e1541 100644
--- a/reference/array/functions/array-merge-recursive.xml
+++ b/reference/array/functions/array-merge-recursive.xml
@@ -87,6 +87,9 @@
 $ar1 = array("colore" => array ("preferito" => "rosso"), 5);
 $ar2 = array(10, "colore" => array ("preferito" => "verde", "blu"));
 $risultato = array_merge_recursive($ar1, $ar2);
+$ar1 = array("colore" => array ("preferito" => "rosso"), 5);
+$ar2 = array(10, "colore" => array ("preferito" => "verde", "blu"));
+$risultato = array_merge_recursive($ar1, $ar2);
 print_r($result);
 ?>
 ]]>
@@ -96,15 +99,20 @@ print_r($result);
 <![CDATA[
 Array
 (
+    [colore] => Array
     [colore] => Array
         (
+            [preferito] => Array
             [preferito] => Array
                 (
                     [0] => rosso
                     [1] => verde
+                    [0] => rosso
+                    [1] => verde
                 )
 
             [0] => blu
+            [0] => blu
         )
 
     [0] => 5

From 91166f4a1048e68323c44741a86b288f107f88ab Mon Sep 17 00:00:00 2001
From: Manuel della Gala <74384683+ManueldG@users.noreply.github.com>
Date: Thu, 20 Feb 2025 14:18:20 +0100
Subject: [PATCH 30/47] correction array-chunck.xml

---
 reference/array/functions/array-chunk.xml | 13 +++++++------
 1 file changed, 7 insertions(+), 6 deletions(-)

diff --git a/reference/array/functions/array-chunk.xml b/reference/array/functions/array-chunk.xml
index eae20499e..c9669e47f 100644
--- a/reference/array/functions/array-chunk.xml
+++ b/reference/array/functions/array-chunk.xml
@@ -1,5 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 214519fdbdd6bfe2942775d3554fa8f440f85404  Maintainer: Manuel dG Status: ready -->
+<!-- EN-Revision: 214519fdbdd6bfe2942775d3554fa8f440f85404  Maintainer: ManueldG Status: ready -->
+<!-- CREDITS: cucinato-->
 <refentry xml:id="function.array-chunk" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>array_chunk</refname>
@@ -16,7 +17,7 @@
   </methodsynopsis>
   <para>
    Divide l'array in più array di dimensione <parameter>length</parameter>.
-   L'ultimo array potrebbe ovviamente avere una dimensione inferiore.
+   L'ultimo array potrebbe avere ovviamente una dimensione inferiore.
   </para>
  </refsect1>
 
@@ -68,8 +69,8 @@
  <refsect1 role="errors">
   &reftitle.errors;
   <para>
-   Se <parameter>length</parameter> è meno di <literal>1</literal>,
-   un <classname>ValueError</classname> sarà lanciato.
+   Se <parameter>length</parameter> è minore di <literal>1</literal>,
+   sarà segnalato un <classname>ValueError</classname>. 
   </para>
  </refsect1>
 
@@ -88,8 +89,8 @@
       <entry>8.0.0</entry>
       <entry>
        Se <parameter>length</parameter> è minore di <literal>1</literal>,
-       un <classname>ValueError</classname> sarà generato;
-       precedentemente, veniva lanciato un errore di tipo <constant>E_WARNING</constant>
+       sarà segnalato un <classname>ValueError</classname>;
+       precedentemente, veniva mostrato un errore di tipo <constant>E_WARNING</constant>
        e la funzione restituiva &null;.
       </entry>
      </row>

From 2fa5ba465b06b748fd7f6ccc3c39dbef1114413d Mon Sep 17 00:00:00 2001
From: Manuel della Gala <74384683+ManueldG@users.noreply.github.com>
Date: Thu, 20 Feb 2025 14:29:35 +0100
Subject: [PATCH 31/47] some mod in array-change-key-case.xml

---
 reference/array/functions/array-change-key-case.xml | 7 ++++---
 1 file changed, 4 insertions(+), 3 deletions(-)

diff --git a/reference/array/functions/array-change-key-case.xml b/reference/array/functions/array-change-key-case.xml
index e1733ac46..f3e93e218 100644
--- a/reference/array/functions/array-change-key-case.xml
+++ b/reference/array/functions/array-change-key-case.xml
@@ -1,5 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 58d11dfe19531e1355980b2892964c07dd8e8068 Maintainer: Manuel dG Status: ready -->
+<!-- EN-Revision: 58d11dfe19531e1355980b2892964c07dd8e8068 Maintainer: ManueldG Status: ready -->
+<!-- CREDITS: cucinato -->
 <refentry xml:id="function.array-change-key-case" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>array_change_key_case</refname>
@@ -28,7 +29,7 @@
      <term><parameter>array</parameter></term>
      <listitem>
       <para>
-       L'array su cui lavorare
+       L'array su cui lavorare <!-- array passato - parametro passato - l'array da modificare-->
       </para>
      </listitem>
     </varlistentry>
@@ -50,7 +51,7 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   Restituisce un array con le chiavi convertite in maiuscolo o minuscolo, oppure &false; se
+   Restituisce un'array con le chiavi convertite in maiuscolo o minuscolo, oppure &false; se
    <parameter>input</parameter> non è un array.
   </para>
  </refsect1>

From 1d57fa682ce8a5fdd23ea3e1edec4ae7d983c9e2 Mon Sep 17 00:00:00 2001
From: Manuel della Gala <74384683+ManueldG@users.noreply.github.com>
Date: Thu, 20 Feb 2025 18:59:24 +0100
Subject: [PATCH 32/47] mod i array-combine.xml

---
 reference/array/functions/array-combine.xml | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/reference/array/functions/array-combine.xml b/reference/array/functions/array-combine.xml
index 92fb1c7c4..90be07652 100644
--- a/reference/array/functions/array-combine.xml
+++ b/reference/array/functions/array-combine.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- EN-Revision: 71e3c74047f04b26aa1be51215d7129e15dc2993 Maintainer: Manuel dG Status: ready -->
+<!-- EN-Revision: 71e3c74047f04b26aa1be51215d7129e15dc2993 Maintainer: ManueldG Status: ready -->
 <!-- CREDITS: gurugeek -->
 <refentry xml:id="function.array-combine" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
@@ -15,7 +15,7 @@
    <methodparam><type>array</type><parameter>values</parameter></methodparam>
   </methodsynopsis>
   <para>
-   Crea un <type>array</type> utilizzando i valori dall'array
+   Crea un <type>array</type> utilizzando 
    <parameter>keys</parameter> per le chiavi e i valori dall'array
    <parameter>values</parameter> per i valori corrispondenti.
   </para>
@@ -30,7 +30,7 @@
      <term><parameter>keys</parameter></term>
      <listitem>
       <para>
-       Un array di chiavi da utilizzare. Valori non validi per le chiavi saranno
+       Un array di chiavi da utilizzare. I valori non validi come chiavi saranno
        convertiti in <type>string</type>.
       </para>
      </listitem>
@@ -40,7 +40,7 @@
      <term><parameter>values</parameter></term>
      <listitem>
       <para>
-       Un <type>Array</type> di valori da utilizzare
+       Un <type>Array</type> di valori da utilizzare come parametro
       </para>
      </listitem>
     </varlistentry>

From da938e6493843b84d6cc4002af49b7aef17f20cd Mon Sep 17 00:00:00 2001
From: Manuel della Gala <74384683+ManueldG@users.noreply.github.com>
Date: Thu, 20 Feb 2025 19:01:58 +0100
Subject: [PATCH 33/47] mod array-count-values.xml

---
 reference/array/functions/array-count-values.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/reference/array/functions/array-count-values.xml b/reference/array/functions/array-count-values.xml
index 044ab6e52..f7e3cb23a 100644
--- a/reference/array/functions/array-count-values.xml
+++ b/reference/array/functions/array-count-values.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 6b56e6f444e49396ee5122258ee85b99a8543f6a Maintainer: Manuel dG Status: ready -->
+<!-- EN-Revision: 6b56e6f444e49396ee5122258ee85b99a8543f6a Maintainer: ManueldG Status: ready -->
 <!-- CREDITS: cucinato -->
 <refentry xml:id="function.array-count-values" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>

From e375db2aae3d19e36b641020d591712d8b594c48 Mon Sep 17 00:00:00 2001
From: Manuel della Gala <74384683+ManueldG@users.noreply.github.com>
Date: Thu, 20 Feb 2025 19:09:11 +0100
Subject: [PATCH 34/47] mod array-diff-assoc.xml

---
 reference/array/functions/array-diff-assoc.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/reference/array/functions/array-diff-assoc.xml b/reference/array/functions/array-diff-assoc.xml
index 8b82db67b..5d8a093e3 100644
--- a/reference/array/functions/array-diff-assoc.xml
+++ b/reference/array/functions/array-diff-assoc.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 6b64170daac5587bee4bb63c0020cb2fbf7f1253 Maintainer: Manuel dG Status: ready -->
+<!-- EN-Revision: 6b64170daac5587bee4bb63c0020cb2fbf7f1253 Maintainer: ManueldG Status: ready -->
 <!-- CREDITS: cucinato -->
 <refentry xml:id="function.array-diff-assoc" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>

From 386e7484ad801dff0d665801c7c9e1eb079933c9 Mon Sep 17 00:00:00 2001
From: Manuel della Gala <74384683+ManueldG@users.noreply.github.com>
Date: Thu, 20 Feb 2025 19:09:35 +0100
Subject: [PATCH 35/47] mod key.xml

---
 reference/array/functions/key.xml | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/reference/array/functions/key.xml b/reference/array/functions/key.xml
index 540a449bb..c4051da33 100644
--- a/reference/array/functions/key.xml
+++ b/reference/array/functions/key.xml
@@ -1,5 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 0a192fcd9cc43c0007de795063b4494974058992 Maintainer: Manuel dG Status: ready -->
+<!-- EN-Revision: 0a192fcd9cc43c0007de795063b4494974058992 Maintainer: ManueldG Status: ready -->
+<!-- CREDITS: cucinato -->
 <!-- splitted from ./it/functions/array.xml, last change in rev 1.24 -->
 <refentry xml:id="function.key" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>

From 7502de0cea1e1169c162690b44de2854615c450e Mon Sep 17 00:00:00 2001
From: Manuel della Gala <74384683+ManueldG@users.noreply.github.com>
Date: Thu, 20 Feb 2025 19:17:59 +0100
Subject: [PATCH 36/47] mod extract.xml

---
 reference/array/functions/extract.xml | 15 +++------------
 1 file changed, 3 insertions(+), 12 deletions(-)

diff --git a/reference/array/functions/extract.xml b/reference/array/functions/extract.xml
index b76d2efe8..63e7d5375 100644
--- a/reference/array/functions/extract.xml
+++ b/reference/array/functions/extract.xml
@@ -1,10 +1,10 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: d58ee8eaaa7f716c51f66f5f1058ab3c42376d98 Maintainer: Manuel dG Status: ready -->
-<!-- CREDITS: cucinato -->
+<!-- EN-Revision: d58ee8eaaa7f716c51f66f5f1058ab3c42376d98 Maintainer: ManueldG Status: ready -->
+<!-- CREDITS: pastore, cucinato -->
 <refentry xml:id="function.extract" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>extract</refname>  
-  <refpurpose>Restituisce delle variabili a partire da un array </refpurpose>
+  <refpurpose>Importa le variabili nella symbol table corrente a partire da un array </refpurpose>
  </refnamediv>
  <refsect1 role="description">
   &reftitle.description;
@@ -204,15 +204,6 @@ blue, large, sphere, medium
 ]]>
     </screen>
     <para>
-      The <varname>$size</varname> wasn't overwritten because we specified
-     <constant>EXTR_PREFIX_SAME</constant>, which resulted in
-     <varname>$wddx_size</varname> being created.  If <constant>EXTR_SKIP</constant> was
-     specified, then <varname>$wddx_size</varname> wouldn't even have been created.
-     <constant>EXTR_OVERWRITE</constant> would have caused <varname>$size</varname> to have
-     value "medium", and <constant>EXTR_PREFIX_ALL</constant> would result in new variables
-     being named <varname>$wddx_color</varname>,
-     <varname>$wddx_size</varname>, and
-
      <varname>$size</varname> non è stato sovrascritto perché abbiamo specificato
      <constant>EXTR_PREFIX_SAME</constant>, che ha portato alla
      creazione di <varname>$wddx_size</varname>. Se fosse stato specificato

From 4e7b83eccb02da9ba590e084ed24b6525c4cdede Mon Sep 17 00:00:00 2001
From: Manuel della Gala <74384683+ManueldG@users.noreply.github.com>
Date: Thu, 20 Feb 2025 20:06:34 +0100
Subject: [PATCH 37/47] mod array-multisort.xml

---
 reference/array/functions/array-multisort.xml | 9 ++++++---
 1 file changed, 6 insertions(+), 3 deletions(-)

diff --git a/reference/array/functions/array-multisort.xml b/reference/array/functions/array-multisort.xml
index ea2afef86..025dcca12 100644
--- a/reference/array/functions/array-multisort.xml
+++ b/reference/array/functions/array-multisort.xml
@@ -1,5 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- EN-Revision: 6a6f43d1c490a57b452656db285de6d136055ed2 Maintainer: Manuel dG Status: ready -->
+<!-- EN-Revision: 6a6f43d1c490a57b452656db285de6d136055ed2 Maintainer: ManueldG Status: ready -->
+<!--CREDITS: cucinato -->
 <refentry xml:id="function.array-multisort" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>array_multisort</refname>
@@ -12,7 +13,7 @@
    <methodparam><type>array</type><parameter role="reference">array1</parameter></methodparam>
    <methodparam choice="opt"><type>mixed</type><parameter>array1_sort_order</parameter><initializer>SORT_ASC</initializer></methodparam>
    <methodparam choice="opt"><type>mixed</type><parameter>array1_sort_flags</parameter><initializer>SORT_REGULAR</initializer></methodparam>
-   <methodparam choice="opt"><type>mixed</type><parameter>...</parameter></methodparam>
+   <methodparam choice="opt"><type>mixed</type><parameter>rest</parameter></methodparam>
   </methodsynopsis> 
   <para>
    <function>Array_multisort</function> Può essere usato per ordinare parecchi
@@ -103,7 +104,9 @@
       <term><parameter>...</parameter></term>
       <listitem>
        <para>
-        Altri array, opzionalmente seguiti da opzioni di ordinamento e flag di tipo.
+        Altri array, opzionalmente seguiti da opzioni di ordinamento e flag di tipo. Solo gli elementi
+        corrispondenti agli elementi equivalenti negli array precedenti vengono confrontati.
+        In altre parole, l'ordinamento è lessicografico.
        </para>
       </listitem>
      </varlistentry>

From 07fef597cab393f9241af27037232f8c9292c80c Mon Sep 17 00:00:00 2001
From: Manuel della Gala <74384683+ManueldG@users.noreply.github.com>
Date: Thu, 20 Feb 2025 20:19:21 +0100
Subject: [PATCH 38/47] mod array-filter.xml

---
 reference/array/functions/array-filter.xml | 21 ++++++++++-----------
 1 file changed, 10 insertions(+), 11 deletions(-)

diff --git a/reference/array/functions/array-filter.xml b/reference/array/functions/array-filter.xml
index d7a2d82b5..8d0f6b404 100644
--- a/reference/array/functions/array-filter.xml
+++ b/reference/array/functions/array-filter.xml
@@ -1,5 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 596c11440dc232b8ed1836d7e3afe2ed5b225a7b Maintainer: Manuel dG Status: ready -->
+<!-- EN-Revision: 596c11440dc232b8ed1836d7e3afe2ed5b225a7b Maintainer: ManueldG Status: ready -->
+<!--CREDITS: cucinato -->
 <!-- splitted from ./it/functions/array.xml, last change in rev 1.1 -->
 <!-- last change to 'array-filter' in en/ tree in rev 1.62 -->
 <!-- OLD-Revision: 1.173/EN.1.62 -->
@@ -72,14 +73,12 @@
          </simpara>
         </listitem>
         <listitem>
-         <simpara>
-          <constant>ARRAY_FILTER_USE_BOTH</constant> - passa sia il valore che la chiave 
-          come argomenti alla <parameter>callback</parameter> invece del valore.
-         </simpara>
+         <simpara><constant>ARRAY_FILTER_USE_BOTH</constant> - passa sia il valore che la chiave 
+          come argomenti alla <parameter>callback</parameter> invece del valore.</simpara>
         </listitem>
        </itemizedlist>
-        Il valore di Default è <literal>0</literal> che passerà il valore come unico argomento
-        alla <parameter>callback</parameter>.
+       Il valore di Default è <literal>0</literal> che passerà il valore come unico argomento
+       alla <parameter>callback</parameter>.
       </para>
      </listitem>
     </varlistentry>
@@ -135,13 +134,13 @@
 <?php
 function odd($var)
 {
-    // returns whether the input integer is odd
+    // controlla se l'intero immesso è dispari
     return $var & 1;
 }
 
 function even($var)
 {
-    // returns whether the input integer is even
+    // controlla se l'intero è pari
     return !($var & 1);
 }
 
@@ -158,14 +157,14 @@ print_r(array_filter($array2, "even"));
     &example.outputs;
     <screen role="php">
 <![CDATA[
-Odd :
+Dispari :
 Array
 (
     [a] => 1
     [c] => 3
     [e] => 5
 )
-Even:
+Pari:
 Array
 (
     [0] => 6

From d7f74f09d3cf21c7ccfa7912df7abd4471d39a0f Mon Sep 17 00:00:00 2001
From: Manuel della Gala <74384683+ManueldG@users.noreply.github.com>
Date: Thu, 20 Feb 2025 20:22:11 +0100
Subject: [PATCH 39/47] mof array-filter.xml

---
 reference/array/functions/array-filter.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/reference/array/functions/array-filter.xml b/reference/array/functions/array-filter.xml
index d7a2d82b5..16cc137ad 100644
--- a/reference/array/functions/array-filter.xml
+++ b/reference/array/functions/array-filter.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 596c11440dc232b8ed1836d7e3afe2ed5b225a7b Maintainer: Manuel dG Status: ready -->
+<!-- EN-Revision: 596c11440dc232b8ed1836d7e3afe2ed5b225a7b Maintainer: ManueldG Status: ready -->
 <!-- splitted from ./it/functions/array.xml, last change in rev 1.1 -->
 <!-- last change to 'array-filter' in en/ tree in rev 1.62 -->
 <!-- OLD-Revision: 1.173/EN.1.62 -->

From 403b59701be6654d5e00b452f8e1fbbf30f03d40 Mon Sep 17 00:00:00 2001
From: Manuel della Gala <74384683+ManueldG@users.noreply.github.com>
Date: Fri, 28 Feb 2025 14:27:06 +0100
Subject: [PATCH 40/47] added note and deleted error section in
 array-change-key-case.xml

---
 .../array/functions/array-change-key-case.xml      | 14 +++-----------
 1 file changed, 3 insertions(+), 11 deletions(-)

diff --git a/reference/array/functions/array-change-key-case.xml b/reference/array/functions/array-change-key-case.xml
index f3e93e218..39213ac4c 100644
--- a/reference/array/functions/array-change-key-case.xml
+++ b/reference/array/functions/array-change-key-case.xml
@@ -1,5 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- EN-Revision: 58d11dfe19531e1355980b2892964c07dd8e8068 Maintainer: ManueldG Status: ready -->
+<!-- Reviewed: no -->
 <!-- CREDITS: cucinato -->
 <refentry xml:id="function.array-change-key-case" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
@@ -29,7 +30,7 @@
      <term><parameter>array</parameter></term>
      <listitem>
       <para>
-       L'array su cui lavorare <!-- array passato - parametro passato - l'array da modificare-->
+       L'array su cui lavorare <!--elaborare - array passato - parametro passato - l'array da modificare-->
       </para>
      </listitem>
     </varlistentry>
@@ -51,16 +52,7 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   Restituisce un'array con le chiavi convertite in maiuscolo o minuscolo, oppure &false; se
-   <parameter>input</parameter> non è un array.
-  </para>
- </refsect1>
-
- <refsect1 role="errors">
-  &reftitle.errors;
-  <para>
-   Lancia un <constant>E_WANRING</constant> se <parameter>input</parameter>
-   non è un array.
+   Restituisce un'array con le chiavi convertite in maiuscolo o minuscolo.
   </para>
  </refsect1>
 

From 9ff173227c209fc6a6a6d944a892e7a21c0dd738 Mon Sep 17 00:00:00 2001
From: Manuel della Gala <74384683+ManueldG@users.noreply.github.com>
Date: Sat, 1 Mar 2025 22:10:04 +0100
Subject: [PATCH 41/47] <!-- Reviewed: no --> note added to stranslated files

---
 reference/array/functions/array-chunk.xml           | 1 +
 reference/array/functions/array-combine.xml         | 1 +
 reference/array/functions/array-count-values.xml    | 1 +
 reference/array/functions/array-diff-assoc.xml      | 1 +
 reference/array/functions/array-filter.xml          | 1 +
 reference/array/functions/array-key-exists.xml      | 1 +
 reference/array/functions/array-map.xml             | 1 +
 reference/array/functions/array-merge-recursive.xml | 1 +
 reference/array/functions/array-multisort.xml       | 1 +
 reference/array/functions/extract.xml               | 1 +
 reference/array/functions/key.xml                   | 1 +
 11 files changed, 11 insertions(+)

diff --git a/reference/array/functions/array-chunk.xml b/reference/array/functions/array-chunk.xml
index c9669e47f..b999030dc 100644
--- a/reference/array/functions/array-chunk.xml
+++ b/reference/array/functions/array-chunk.xml
@@ -1,5 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- EN-Revision: 214519fdbdd6bfe2942775d3554fa8f440f85404  Maintainer: ManueldG Status: ready -->
+<!-- Reviewed: no -->
 <!-- CREDITS: cucinato-->
 <refentry xml:id="function.array-chunk" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
diff --git a/reference/array/functions/array-combine.xml b/reference/array/functions/array-combine.xml
index 90be07652..871d6361f 100644
--- a/reference/array/functions/array-combine.xml
+++ b/reference/array/functions/array-combine.xml
@@ -1,5 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!-- EN-Revision: 71e3c74047f04b26aa1be51215d7129e15dc2993 Maintainer: ManueldG Status: ready -->
+<!-- Reviewed: no -->
 <!-- CREDITS: gurugeek -->
 <refentry xml:id="function.array-combine" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
diff --git a/reference/array/functions/array-count-values.xml b/reference/array/functions/array-count-values.xml
index f7e3cb23a..1b656853d 100644
--- a/reference/array/functions/array-count-values.xml
+++ b/reference/array/functions/array-count-values.xml
@@ -1,5 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- EN-Revision: 6b56e6f444e49396ee5122258ee85b99a8543f6a Maintainer: ManueldG Status: ready -->
+<!-- Reviewed: no -->
 <!-- CREDITS: cucinato -->
 <refentry xml:id="function.array-count-values" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
diff --git a/reference/array/functions/array-diff-assoc.xml b/reference/array/functions/array-diff-assoc.xml
index 5d8a093e3..c923b7e5e 100644
--- a/reference/array/functions/array-diff-assoc.xml
+++ b/reference/array/functions/array-diff-assoc.xml
@@ -1,5 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- EN-Revision: 6b64170daac5587bee4bb63c0020cb2fbf7f1253 Maintainer: ManueldG Status: ready -->
+<!-- Reviewed: no -->
 <!-- CREDITS: cucinato -->
 <refentry xml:id="function.array-diff-assoc" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
diff --git a/reference/array/functions/array-filter.xml b/reference/array/functions/array-filter.xml
index 8d0f6b404..a1cefaf2e 100644
--- a/reference/array/functions/array-filter.xml
+++ b/reference/array/functions/array-filter.xml
@@ -1,5 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- EN-Revision: 596c11440dc232b8ed1836d7e3afe2ed5b225a7b Maintainer: ManueldG Status: ready -->
+<!-- Reviewed: no -->
 <!--CREDITS: cucinato -->
 <!-- splitted from ./it/functions/array.xml, last change in rev 1.1 -->
 <!-- last change to 'array-filter' in en/ tree in rev 1.62 -->
diff --git a/reference/array/functions/array-key-exists.xml b/reference/array/functions/array-key-exists.xml
index 0466e921c..bea7bea4f 100644
--- a/reference/array/functions/array-key-exists.xml
+++ b/reference/array/functions/array-key-exists.xml
@@ -1,5 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- EN-Revision: 89fe795cc8bcf1b5ff9eb894bff51f006db66a65 Maintainer: Manuel dG Status: ready -->
+<!-- Reviewed: no -->
 <!-- CREDITS: cucinato -->
 <refentry xml:id="function.array-key-exists" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
diff --git a/reference/array/functions/array-map.xml b/reference/array/functions/array-map.xml
index 22bbe0629..a156f5d88 100644
--- a/reference/array/functions/array-map.xml
+++ b/reference/array/functions/array-map.xml
@@ -1,5 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- EN-Revision: 33968dfebb9b847733d02ee221b3b8054a101b41c Maintainer: Manuel dG Status: ready -->
+<!-- Reviewed: no -->
 <!-- CREDITS: cucinato -->
 <refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.array-map">
  <refnamediv>
diff --git a/reference/array/functions/array-merge-recursive.xml b/reference/array/functions/array-merge-recursive.xml
index 4030e1541..a6d0a073b 100644
--- a/reference/array/functions/array-merge-recursive.xml
+++ b/reference/array/functions/array-merge-recursive.xml
@@ -1,5 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- EN-Revision: 9e0f03ac354d797d1d16c0fcc1663e5e170f2727 Maintainer: ManueldG Status: ready -->
+<!-- Reviewed: no -->
 <refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.array-merge-recursive">
  <refnamediv>
   <refname>array_merge_recursive</refname>
diff --git a/reference/array/functions/array-multisort.xml b/reference/array/functions/array-multisort.xml
index 025dcca12..bb7e7cfe1 100644
--- a/reference/array/functions/array-multisort.xml
+++ b/reference/array/functions/array-multisort.xml
@@ -1,5 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!-- EN-Revision: 6a6f43d1c490a57b452656db285de6d136055ed2 Maintainer: ManueldG Status: ready -->
+<!-- Reviewed: no -->
 <!--CREDITS: cucinato -->
 <refentry xml:id="function.array-multisort" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
diff --git a/reference/array/functions/extract.xml b/reference/array/functions/extract.xml
index 63e7d5375..630d46b62 100644
--- a/reference/array/functions/extract.xml
+++ b/reference/array/functions/extract.xml
@@ -1,5 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- EN-Revision: d58ee8eaaa7f716c51f66f5f1058ab3c42376d98 Maintainer: ManueldG Status: ready -->
+<!-- Reviewed: no -->
 <!-- CREDITS: pastore, cucinato -->
 <refentry xml:id="function.extract" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
diff --git a/reference/array/functions/key.xml b/reference/array/functions/key.xml
index c4051da33..3a9ed441a 100644
--- a/reference/array/functions/key.xml
+++ b/reference/array/functions/key.xml
@@ -1,5 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- EN-Revision: 0a192fcd9cc43c0007de795063b4494974058992 Maintainer: ManueldG Status: ready -->
+<!-- Reviewed: no -->
 <!-- CREDITS: cucinato -->
 <!-- splitted from ./it/functions/array.xml, last change in rev 1.24 -->
 <refentry xml:id="function.key" xmlns="http://docbook.org/ns/docbook">

From 1f42c68eee6f83ed4536fd470ef4deffaf30f5c8 Mon Sep 17 00:00:00 2001
From: Manuel della Gala <74384683+ManueldG@users.noreply.github.com>
Date: Sun, 2 Mar 2025 17:17:46 +0100
Subject: [PATCH 42/47] array-chunk  some improvements

---
 reference/array/functions/array-chunk.xml | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/reference/array/functions/array-chunk.xml b/reference/array/functions/array-chunk.xml
index b999030dc..d36c5e8c4 100644
--- a/reference/array/functions/array-chunk.xml
+++ b/reference/array/functions/array-chunk.xml
@@ -31,7 +31,7 @@
      <term><parameter>array</parameter></term>
      <listitem>
       <para>
-       L'array su cui lavorare
+       L'array da modificare
       </para>
      </listitem>
     </varlistentry>
@@ -62,7 +62,7 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   Restituisce un array multidimensionale indicizzato numericamente, a partire da zero,
+   Restituisce un array multidimensionale<!--matrice--> indicizzato numericamente, a partire da zero,
    con ogni dimensione contenente <parameter>lenght</parameter> elementi.
   </para>
  </refsect1>

From d24ef0386530f6a7d975993cdce87d2f59558957 Mon Sep 17 00:00:00 2001
From: Manuel della Gala <74384683+ManueldG@users.noreply.github.com>
Date: Sun, 2 Mar 2025 18:08:16 +0100
Subject: [PATCH 43/47] improvement array-combine.xml

---
 reference/array/functions/array-combine.xml | 10 ++++------
 1 file changed, 4 insertions(+), 6 deletions(-)

diff --git a/reference/array/functions/array-combine.xml b/reference/array/functions/array-combine.xml
index 871d6361f..97a32a08b 100644
--- a/reference/array/functions/array-combine.xml
+++ b/reference/array/functions/array-combine.xml
@@ -53,17 +53,15 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   Restituisce l'<type>array</type> combinato, o &false; se il numero degli elementi
-   per ogni array non è uguale.
+   Restituisce l'<type>array</type> generato, o &false; se gli array non hanno la stessa lunghezza.
   </para>
  </refsect1>
 
  <refsect1 role="errors">
   &reftitle.errors;
   <para>
-   A partire da PHP 8.0.0, viene generato un <classname>ValueError</classname> se il numero di elementi in
-   <parameter>keys</parameter> e <parameter>values</parameter> non
-   corrisponde.
+   A partire da PHP 8.0.0, viene generato un <classname>ValueError</classname> se il numero di elementi di
+   <parameter>keys</parameter> e <parameter>values</parameter> hanno una lunghezza diversa.
    Prima di PHP 8.0.0, veniva invece emesso un <constant>E_WARNING</constant>.
   </para>
  </refsect1>
@@ -85,7 +83,7 @@
        <function>array_combine</function> genererà un
        <classname>ValueError</classname> se il numbero degli elementi
        degli array non è uguale;
-       invece prima la funzione riturnava un &false;.
+       invece prima la funzione ritornava un &false;.
       </entry>
      </row>
     </tbody>

From caca1f7274d9adb76342058dc8f524614967f1a3 Mon Sep 17 00:00:00 2001
From: Manuel della Gala <74384683+ManueldG@users.noreply.github.com>
Date: Tue, 4 Mar 2025 14:03:48 +0100
Subject: [PATCH 44/47] improve traduction array_replace_recursive

---
 reference/array/functions/array_replace_recursive.xml | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/reference/array/functions/array_replace_recursive.xml b/reference/array/functions/array_replace_recursive.xml
index 8ba2bba6f..187245424 100644
--- a/reference/array/functions/array_replace_recursive.xml
+++ b/reference/array/functions/array_replace_recursive.xml
@@ -4,7 +4,7 @@
 <refentry xml:id="function.array-replace-recursive" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>array_replace_recursive</refname>
-  <refpurpose>Sostituisce gli elementi dall'array passato come parametro dal primo array in modo ricorsivo.</refpurpose>
+  <refpurpose>Sostituisce gli elementi del primo array passato con gli'array successivi in modo ricorsivo.</refpurpose>
 
  </refnamediv>
  <refsect1 role="description">
@@ -17,7 +17,7 @@
   <para>
    <function>array_replace_recursive</function>
     Sostituisce i valori dell'<parameter>array</parameter> con gli stessi
-    valori da tutti i seguenti array. Se una chiave del primo array esiste 
+    valori da tutti gli array seguenti. Se una chiave del primo array esiste 
     nel secondo array, il suo valore verrà sostituito dal valore del 
     secondo array. Se la chiave esiste nel secondo array e non il primo, 
     la chiave verrà creato nel primo array. Se una chiave esiste 

From 5c43dfd1e9845bac157236a80c27d2b0c8602777 Mon Sep 17 00:00:00 2001
From: Manuel della Gala <74384683+ManueldG@users.noreply.github.com>
Date: Tue, 4 Mar 2025 14:49:31 +0100
Subject: [PATCH 45/47] improve traduction array_replace_recursive

---
 reference/array/functions/array_replace_recursive.xml | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/reference/array/functions/array_replace_recursive.xml b/reference/array/functions/array_replace_recursive.xml
index 187245424..245bc18b3 100644
--- a/reference/array/functions/array_replace_recursive.xml
+++ b/reference/array/functions/array_replace_recursive.xml
@@ -4,7 +4,7 @@
 <refentry xml:id="function.array-replace-recursive" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>array_replace_recursive</refname>
-  <refpurpose>Sostituisce gli elementi del primo array passato con gli'array successivi in modo ricorsivo.</refpurpose>
+  <refpurpose>Sostituisce gli elementi del primo array passato con gli array successivi in modo ricorsivo.</refpurpose>
 
  </refnamediv>
  <refsect1 role="description">
@@ -51,7 +51,7 @@
      </listitem>
     </varlistentry>
     <varlistentry>
-     <term><parameter>sostituzioni</parameter></term>
+     <term><parameter>replacement</parameter></term>
      <listitem>
       <para>
        Array da cui verranno estratti gli elementi.

From 70450a9bd109d14eaec82062c744f6145d8f179c Mon Sep 17 00:00:00 2001
From: Manuel della Gala <74384683+ManueldG@users.noreply.github.com>
Date: Thu, 6 Mar 2025 17:15:32 +0100
Subject: [PATCH 46/47] deleted repetition in array-map

---
 reference/array/functions/array-map.xml | 3 ---
 1 file changed, 3 deletions(-)

diff --git a/reference/array/functions/array-map.xml b/reference/array/functions/array-map.xml
index a156f5d88..d6d364904 100644
--- a/reference/array/functions/array-map.xml
+++ b/reference/array/functions/array-map.xml
@@ -87,9 +87,6 @@
    L'array restituito conserverà le chiavi del parametro array se e solo
    se viene passato esattamente un array. Se viene passato più di un array, l'array
    restituito avrà chiavi intere sequenziali.
-   L'array restituito conserverà le chiavi del parametro array se e solo
-   se viene passato esattamente un array. Se viene passato più di un array, l'array
-   restituito avrà chiavi intere sequenziali.
   </para>
  </refsect1>
 

From 15335a6af362b616e04cbdeeea02b07d3807f3e5 Mon Sep 17 00:00:00 2001
From: Manuel della Gala <74384683+ManueldG@users.noreply.github.com>
Date: Fri, 7 Mar 2025 19:20:41 +0100
Subject: [PATCH 47/47] array-change-key-case.xml some fix

---
 reference/array/functions/array-change-key-case.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/reference/array/functions/array-change-key-case.xml b/reference/array/functions/array-change-key-case.xml
index 39213ac4c..45b76a0d0 100644
--- a/reference/array/functions/array-change-key-case.xml
+++ b/reference/array/functions/array-change-key-case.xml
@@ -30,7 +30,7 @@
      <term><parameter>array</parameter></term>
      <listitem>
       <para>
-       L'array su cui lavorare <!--elaborare - array passato - parametro passato - l'array da modificare-->
+       L'array da elaborare <!--elaborare - array passato - parametro passato - l'array da modificare-->
       </para>
      </listitem>
     </varlistentry>