updated gawktexi.in, added README.txt

3 files changed, 52 insertions, 8 deletions

diff --git a/doc/it/ChangeLog b/doc/it/ChangeLog
index 4c0c314a..89b633f3 100644
--- a/doc/it/ChangeLog
+++ b/doc/it/ChangeLog
@@ -1,3 +1,8 @@
+2022-02-25         Antonio Giovanni Colombo   <azc100@gmail.com>
+
+	* README.txt: Added.
+	* gawktexi.in: Updated.
+
 2022-02-23         Antonio Giovanni Colombo   <azc100@gmail.com>
 
 	* gawktexi.in: Updated.
diff --git a/doc/it/README.txt b/doc/it/README.txt
new file mode 100644
index 00000000..53930cfe
--- /dev/null
+++ b/doc/it/README.txt
@@ -0,0 +1,33 @@
+I file contenuti in questa directory permettono di generare
+(in ambiente Linux/Unix/WSL) la versione italiana
+del libro di Arnold GAWK: Programmare efficacemente in AWK,
+SE (e solo se) il software necessario è disponibile nel
+computer in cui si scarica la distribuzione di gawk.
+
+Se la sola cosa che interessa è avere un copia del libro
+in formato PDF, questa può semplicemente essere scaricata
+dal sito:
+
+https://sites.google.com/view/gawkdoc-it/home-page
+
+Per generare il libro localmente, sono disponibili due shell
+script:
+
+compila_originale.sh
+
+compila_smallprint.sh
+
+La sola differenza è la dimensione della pagina stampata,
+che è più piccola usando il secondo script.
+
+Un terzo script:
+
+genera_formati.sh
+
+genera il manuale in vari formati, fra cui i formati
+testo, html e info.
+
+Per eventuali problemi con la traduzione italiana del
+libro Gawk, fare riferimento agli indirizzi email
+dei traduttori, inseriti all'inizio della versione PDF del
+libro stesso.
diff --git a/doc/it/gawktexi.in b/doc/it/gawktexi.in
index 1a78b55c..96ae9d0e 100755
--- a/doc/it/gawktexi.in
+++ b/doc/it/gawktexi.in
@@ -316,7 +316,7 @@ Some comments on the layout for TeX.
 Tel.: +1-617-542-5942 Fax: +1-617-542-2652 Email: <email>gnu@@gnu.org</email>
 URL: <ulink url="https://www.gnu.org">https://www.gnu.org/</ulink></literallayout>
 
-<literallayout class="normal">Copyright &copy; 1989, 1991, 1992, 1993, 1996&ndash;2005, 2007, 2009&ndash;2021
+<literallayout class="normal">Copyright &copy; 1989, 1991, 1992, 1993, 1996&ndash;2005, 2007, 2009&ndash;2022
 Free Software Foundation, Inc.
 All Rights Reserved.
 </literallayout>
@@ -346,7 +346,7 @@ All Rights Reserved.
 
 @ifnotdocbook
 @iftex
-Copyright @copyright{} 1989, 1991, 1992, 1993, 1996--2005, 2007, 2009--2021 @*
+Copyright @copyright{} 1989, 1991, 1992, 1993, 1996--2005, 2007, 2009--2022 @*
 Free Software Foundation, Inc.
 @end iftex
 @end ifnotdocbook
@@ -431,7 +431,7 @@ URL: @uref{https://www.gnu.org/}
 @c This one is correct for gawk 3.1.0 from the FSF
 ISBN 1-882114-28-0
 @sp 0
-Copyright @copyright{} 1989, 1991, 1992, 1993, 1996--2005, 2007, 2009--2018 @*
+Copyright @copyright{} 1989, 1991, 1992, 1993, 1996--2005, 2007, 2009--2022 @*
 Free Software Foundation, Inc.
 @sp 1
 Traduzione e revisione:@*
@@ -38364,15 +38364,22 @@ assegnandogli dei puntatori. Per esempio:
 @example
 char *p = gawk_malloc(42);      p @ii{``possiede'' la memoria}
 char *q = p;
-p = NULL;                       @ii{ora} q @ii{la ``possiede''}
+p = NULL;                       @ii{adesso} q @ii{la ``possiede''}
 @end example
 
-Gli oggetti MPFR e GMP sono certamente allocati sullo @dfn{stack}
+Gli oggetti MPFR e GMP sono in effetti allocati sullo @dfn{stack}
 oppure dinamicamente, ma le librerie MPFR e GMP trattano questi
 oggetti come valori, allo stesso modo in cui si passa normalmente
 un valore intero (@code{int}) o uno a virgola mobile a doppia
 precisione (@code{double}) per valore.  Non c'@`e modo di
 ``trasferire il possesso'' di oggetti MPFR e GMP.
+
+Il risultato finale di un calcolo effettuato tramite MPFR o GMP
+dovrebbe essere restituito a @command{gawk} per valore, come
+si farebbe se si trattasse di una stringa o di un numero
+a virgola mobile a doppia precisione (@code{double}).
+@command{gawk} libererà la memoria occupata dal numero stesso.
+
 Per questo motivo, il codice in un'estensione dovrebbe essere
 simile a questo:
 
@@ -38387,11 +38394,10 @@ mpz_add(risposta, part1, part2);
 /* di tipo (awk_value_t *). */
 make_number_mpz(risposta, & risultato); @ii{assegnare valore finale GMP}
 
-mpz_clear(part1);                    @ii{rilasciare valori intermedi}
+mpz_clear(part1);                       @ii{rilasciare valori intermedi}
 mpz_clear(part2);
-mpz_clear(risposta);
 
-return result;
+return risultato;           @ii{valore in @code{risposta} gestito da @code{gawk}}
 @end example
 
 @node Funzioni di registrazione