[SCM] gawk branch, feature/docit, updated. gawk-4.1.0-4859-ge2e336ab

[Antonio Giovanni Colombo]

This is an automated email from the git hooks/post-receive script. It was
generated because a ref change was pushed to the repository containing
the project "gawk".

The branch, feature/docit has been updated
       via  e2e336ab9e80b4bbe19fd0bebacf2bb95f743ffb (commit)
      from  ff1dc4bc8a287eaeb4814bc9685277e37a03d97a (commit)

Those revisions listed above that are new to this repository have
not appeared on any other notification email; so we list those
revisions in full, below.

- Log -----------------------------------------------------------------
http://git.sv.gnu.org/cgit/gawk.git/commit/?id=e2e336ab9e80b4bbe19fd0bebacf2bb95f743ffb

commit e2e336ab9e80b4bbe19fd0bebacf2bb95f743ffb
Author: Antonio Giovanni Colombo <azc100@gmail.com>
Date:   Fri Aug 12 11:24:20 2022 +0200

    added pm-gawk.1

diff --git a/doc/it/ChangeLog b/doc/it/ChangeLog
index a246bdd2..ec69d4a0 100644
--- a/doc/it/ChangeLog
+++ b/doc/it/ChangeLog
@@ -1,3 +1,8 @@
+2022-08-12         Antonio Giovanni Colombo   <azc100@gmail.com>
+
+       * pm-gawk.1: Added.
+       * gawk.1: Updated.
+
 2022-08-11         Antonio Giovanni Colombo   <azc100@gmail.com>
 
        * gawktexi.in: Updated.
diff --git a/doc/it/gawk.1 b/doc/it/gawk.1
index 880c12b6..2260da18 100644
--- a/doc/it/gawk.1
+++ b/doc/it/gawk.1
@@ -36,7 +36,7 @@
 .              if \w'\(rq' .ds rq "\(rq
 .      \}
 .\}
-.TH GAWK 1 "Giugno 09 2022" "Free Software Foundation" "Utility Commands"
+.TH GAWK 1 "09 Giugno 2022" "Free Software Foundation" "Comandi di utilità "
 .SH NOME
 gawk \- linguaggio per il riconoscimento e il trattamento di espressioni
 regolari
diff --git a/doc/it/pm-gawk.1 b/doc/it/pm-gawk.1
new file mode 100644
index 00000000..0185efa6
--- /dev/null
+++ b/doc/it/pm-gawk.1
@@ -0,0 +1,197 @@
+.ds EP \fIGAWK: Programmare efficacemente in AWK\fP
+.\"Traduzione per la versione gawk-5.2.0 di A.G. Colombo - Agosto 2022
+.ds PM \fIManuale utente funzionalità Memoria Persistente in gawk\fP
+.TH PM-GAWK 1 "11 agosto 2022" "Free Software Foundation" "Comandi di utilità "
+.SH NOME
+gawk con memoria persistente \- dati e funzioni persistenti
+.SH SINTASSI
+.ft CW
+.nf
+truncate -s \f(CIdimensione\fP deposito.pma
+export GAWK_PERSIST_FILE=deposito.pma
+gawk .\^.\^.
+.sp
+truncate -s \f(CIdimensione\fP deposito.pma
+GAWK_PERSIST_FILE=deposito.pma gawk .\^.\^.
+.sp
+truncate -s \f(CIdimensione\fP deposito.pma
+alias pm='GAWK_PERSIST_FILE=deposito.pma'
+pm gawk .\^.\^.                       # forma concisa
+.sp
+unset GAWK_PERSIST_FILE   # disabilitare persistenza
+.sp
+export GAWK_PERSIST_FILE=altro_deposito.pma  # modificare deposito
+.sp
+rm deposito.pma               # cancellare deposito
+.fi
+.ft R
+.SH DESCRIZIONE
+.PP
+.I Gawk
+a partire dalla versione 5.2 supporta la funzionalità 
+"memoria persistente", che permette di immagazzinare
+in un file variabili e funzioni definite in uno script
+.I Gawk
+per essere utilizzate in successive esecuzioni di
+.I Gawk .
+La funzionalità , chiamata
+.IR pm-gawk ,
+è descritta in \*(EP e in \*(PM.
+.PP
+.I pm-gawk
+è attivato passando a
+.I gawk
+il nome di un
+.IR "file-deposito" ,
+inizialmente vuoto (tutto a zeri binari)
+attraverso la variabile di ambiente
+\f(CWGAWK_PERSIST_FILE\fP.
+.I pm-gawk
+conserva in tale file-deposito le variabili e le funzioni definite in uno 
script
+.I Gawk
+per utilizzo in successive esecuzioni di
+.I gawk.
+.PP
+.I pm-gawk
+offre almeno due vantaggi, rispetto all'esistente estensione
+\f(CWrwarray\fP: offre accesso permanente (``O(1) time'') a singoli
+elementi di vettori associativi persistenti, e può immagazzinare
+funzioni definite in uno script
+.I gawk
+oltre alle variabili di cui sopra.
+.SH ESEMPI
+.PP
+Dimostrazione della persistenza di variabili:
+.RS
+.nf
+.ft CW
+$ \f(CBtruncate -s 1G deposito.pma\fP            # creazione file-deposito
+$ \f(CBexport GAWK_PERSIST_FILE=deposito.pma\fP  # definizione variabile 
d'ambiente
+$ \f(CBgawk 'BEGIN{print ++i}'\fP
+1
+$ \f(CBgawk 'BEGIN{print ++i}'\fP
+2
+$ \f(CBgawk 'BEGIN{print ++i}'\fP
+3
+.ft R
+.fi
+.RE
+.PP
+Per passare la variabile d'ambiente a livello di singolo comando:
+.RS
+.nf
+.ft CW
+$ \f(CBunset GAWK_PERSIST_FILE\fP
+$ \f(CBGAWK_PERSIST_FILE=deposito.pma gawk 'BEGIN{print ++i}'\fP
+4
+$ \f(CBGAWK_PERSIST_FILE=deposito.pma gawk 'BEGIN{print ++i}'\fP
+5
+$ \f(CBGAWK_PERSIST_FILE=deposito.pma gawk 'BEGIN{print ++i}'\fP
+6
+.ft R
+.fi
+.RE
+.PP
+Per ridurre l'ingombro legato al passare la variabile d'ambiente
+a livello di ogni singolo comando si può definire un alias:
+.RS
+.nf
+.ft CW
+$ \f(CBalias pm='GAWK_PERSIST_FILE=deposito.pma'\fP
+$ \f(CBpm gawk 'BEGIN{print ++i}'\fP
+7
+$ \f(CBpm gawk 'BEGIN{print ++i}'\fP
+8
+.ft R
+.fi
+.RE
+.PP
+Per evitare di attivare la persistenza:
+.RS
+.nf
+.ft CW
+$ \f(CBunset GAWK_PERSIST_FILE\fP
+$ \f(CBgawk 'BEGIN{print ++i}'\fP
+1
+$ \f(CBgawk 'BEGIN{print ++i}'\fP
+1
+.ft R
+.fi
+.RE
+.PP
+Per ``dimenticare'' definitivamente i contenuti del file-deposito:
+.RS
+.nf
+.ft CW
+$ \f(CBrm deposito.pma\fP
+.ft R
+.fi
+.RE
+.PP
+.SH VARIABILI D'AMBIENTE
+.PP
+\f(CWGAWK_PERSIST_FILE\fP contiene il nome di un file-deposito dove
+sono immagazzinate le variabili e le funzioni definite in uno script.
+Se tale variabile d'ambiente non è visibile a
+.IR gawk ,
+la funzionalità "memoria persistente"
+non è attivata e
+.I gawk
+si comporta in maniera tradizionale.
+.SH INFORMAZIONE SULLA VERSIONE
+.PP
+La funzionalità "memoria persistente"
+.I gawk
+è stata resa disponibile nella versione
+.I gawk
+5.2.
+.SH AUTORI
+Arnold Robbins, il manutentore di
+.IR gawk ,
+ha implementato
+.I pm-gawk
+usando un allocatore di memoria persistente
+(Persistent Memory Allocator - pma) fornito da
+Terence Kelly.  Una versione precedente, prototipica,
+di
+.I gawk
+con memoria persistente è stata sviluppata da
+Haris Volos, Zi Fan Tan e Jianan Li
+a partire da una diramazione della distribuzione sorgente di
+.I gawk .
+.SH SEGNALAZIONE DI ERRORI
+Seguire le procedure descritte in \*(EP e in \*(PM.
+Se si ritiene che gli errori siano legati alla
+"memoria persistente" (e non ad altri errori
+.I gawk
+non correlati alla "memoria persistente") siete pregati di
+spedire un messaggio e-mail a
+Terence Kelly a uno o più dei seguenti indirizzi:
+\f(CWtpkelly@acm.org\fP,
+\f(CWtpkelly@eecs.umich.edu\fP,
+o
+\f(CWtpkelly@cs.princeton.edu\fP.
+.SH PERMESSI DI COPIA
+Copyright \(co 2022
+Terence Kelly.
+.PP
+È permesso stampare e distribuire copie letterali di questa pagina
+di manuale, a patto che il copyright e questa nota di autorizzazione
+siano conservate e presenti in ogni copia.
+.ig
+È permesso elaborare questo file con il programma troff e stampare il
+risultato, a patto che il documento stampato contenga una sezione
+identica a questa sui permessi di ristampa, tranne che per la rimozione di
+questo paragrafo (in quanto non rilevante per la pagina stampata).
+..
+.PP
+È permesso copiare e distribuire versioni modificate di questa
+pagina del manuale, sotto le condizioni poste per la copia letterale,
+a patto che l'intero lavoro derivato sia distribuito secondo permessi
+di stampa identici a questi.
+.PP
+È permesso copiare e distribuire traduzioni di questa pagina di
+manuale in un'altra lingua, sotto le condizioni poste sopra per le
+versioni modificate, salvo che quest'informazione sui
+permessi di copia e ristampa deve essere espressa in una traduzione
+approvata dalla Free Software Foundation.

-----------------------------------------------------------------------

Summary of changes:
 doc/it/ChangeLog |   5 ++
 doc/it/gawk.1    |   2 +-
 doc/it/pm-gawk.1 | 197 +++++++++++++++++++++++++++++++++++++++++++++++++++++++
 3 files changed, 203 insertions(+), 1 deletion(-)
 create mode 100644 doc/it/pm-gawk.1


hooks/post-receive
-- 
gawk