[SCM] gawk branch, master, updated. gawk-4.1.0-5603-g44cd7a0f

[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, master has been updated
       via  44cd7a0ff56bc07c4aaa5329d77f7707dc6cd1d3 (commit)
      from  d2c38ebe5bf71dd98965f46b99056e50bf40b49e (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=44cd7a0ff56bc07c4aaa5329d77f7707dc6cd1d3

commit 44cd7a0ff56bc07c4aaa5329d77f7707dc6cd1d3
Author: Antonio Giovanni Colombo <azc100@gmail.com>
Date:   Tue Aug 13 21:28:15 2024 +0200

    various modifications for directives

diff --git a/doc/it/ChangeLog b/doc/it/ChangeLog
index 265bf247..b3396b19 100755
--- a/doc/it/ChangeLog
+++ b/doc/it/ChangeLog
@@ -1,3 +1,7 @@
+2024-08-13         Antonio Giovanni Colombo   <azc100@gmail.com>
+
+       * gawk.texi: Updated.
+
 2024-08-09         Antonio Giovanni Colombo   <azc100@gmail.com>
 
        * gawk.1: Updated.
diff --git a/doc/it/gawk.texi b/doc/it/gawk.texi
index 123bc985..ae30af92 100644
--- a/doc/it/gawk.texi
+++ b/doc/it/gawk.texi
@@ -4292,6 +4292,10 @@ Quest'opzione pu@`o essere data pi@`u volte; il 
programma @command{awk}
 @`e formato dalla concatenazione del contenuto di ogni
 @var{file-sorgente} specificato.
 
+@cindex @code{@@} (chiocciola) @subentry @code{@@namespace} (direttiva)
+@cindex chiocciola (@code{@@}) @subentry @code{@@namespace} (direttiva)
+@cindex @code{@@namespace} (direttiva) @sortas{namespace direttiva}
+@cindex direttiva @subentry @code{@@namespace}
 I file specificati dall'opzione @option{-f} sono considerati
 appartenere allo spazio-dei-nomi @samp{"awk" (@@namespace "awk")}
 a inizio programma. @xref{Cambiare lo spazio-dei-nomi}, per ulteriori
@@ -4477,6 +4481,10 @@ $ @kbd{gawk -e 'BEGIN @{ a = 5 ;' -e 'print a @}'}
 Comunque ci@`o non @`e pi@`u possibile.  Se c'@`e qualche @dfn{script}
 che utilizza tale possibilit@`a, @`e necessario modificarlo.
 
+@cindex @code{@@} (chiocciola) @subentry @code{@@namespace} (direttiva)
+@cindex chiocciola (@code{@@}) @subentry @code{@@namespace} (direttiva)
+@cindex @code{@@namespace} (direttiva) @sortas{namespace direttiva}
+@cindex direttiva @subentry @code{@@namespace}
 Il motivo di ci@`o @`e che ogni @var{testo-di-programma} @`e considerato
 appartenere allo spazio di nomi @samp{"awk" (@@namespace "awk")}
 a inizio programma. @xref{Cambiare lo spazio-dei-nomi}, per ulteriori
@@ -4563,6 +4571,10 @@ accettate da @command{gawk} ed esce.
 @cindex @option{--include} (opzione)
 @cindex opzione @subentry @option{--include}
 @cindex programmi @command{awk} @subentry collocazione dei
+@cindex @code{@@} (chiocciola) @subentry @code{@@include} (direttiva)
+@cindex chiocciola (@code{@@}) @subentry @code{@@include} (direttiva)
+@cindex @code{@@include} (direttiva) @sortas{include direttiva}
+@cindex direttiva @subentry @code{@@include}
 Legge una libreria di sorgenti @command{awk} da @var{file-sorgente}.
 Quest'opzione @`e del tutto equivalente a usare la direttiva @code{@@include}
 all'interno del proprio programma.  @`E molto simile all'opzione
@@ -4575,6 +4587,10 @@ costituenti l'input del programma principale.  
Cos@`{@dotless{i}}, dopo l'elabor
 un argomento @option{-i}, @command{gawk} si aspetta di trovare il codice
 sorgente principale attraverso l'opzione @option{-f} o sulla riga di comando.
 
+@cindex @code{@@} (chiocciola) @subentry @code{@@namespace} (direttiva)
+@cindex chiocciola (@code{@@}) @subentry @code{@@namespace} (direttiva)
+@cindex @code{@@namespace} (direttiva) @sortas{namespace direttiva}
+@cindex direttiva @subentry @code{@@namespace}
 I file specificati dall'opzione @option{-i} sono considerati
 appartenere allo spazio-dei-nomi @samp{"awk" (@@namespace "awk")}
 a inizio programma. @xref{Cambiare lo spazio-dei-nomi}, per ulteriori
@@ -4622,6 +4638,10 @@ Se lo si fa, viene generato un errore fatale.
 @cindex estensioni @subentry caricare
 @cindex @env{AWKPATH} (variabile d'ambiente)
 @cindex variabili d'ambiente @subentry @env{AWKPATH}
+@cindex @code{@@} (chiocciola) @subentry @code{@@load} (direttiva)
+@cindex chiocciola (@code{@@}) @subentry @code{@@load} (direttiva)
+@cindex @code{@@load} (direttiva) @sortas{load direttiva}
+@cindex direttiva @subentry @code{@@load}
 Carica un'estensione dinamica denominata @var{ext}.  Le estensioni sono
 memorizzate come librerie condivise di sistema.
 Quest'opzione ricerca la libreria usando la variabile d'ambiente
@@ -5316,6 +5336,10 @@ e @command{gawk} non ha pi@`u bisogno di usare 
@env{AWKPATH}.
 @cindex directory @subentry ricerca di estensioni caricabili
 @cindex percorso di ricerca @subentry per estensioni
 @cindex differenze tra @command{awk} e @command{gawk} @subentry 
@code{AWKLIBPATH} (variabile d'ambiente)
+@cindex @code{@@} (chiocciola) @subentry @code{@@load} (direttiva)
+@cindex chiocciola (@code{@@}) @subentry @code{@@load} (direttiva)
+@cindex @code{@@load} (direttiva) @sortas{load direttiva}
+@cindex direttiva @subentry @code{@@load}
 
 La variabile d'ambiente @env{AWKLIBPATH} @`e simile alla variabile 
@env{AWKPATH},
 ma @`e usata per ricercare estensioni caricabili (memorizzate come
@@ -5550,6 +5574,7 @@ Tratta di come includere da un file sorgente un altro 
file sorgente.
 
 @cindex @code{@@} (chiocciola) @subentry @code{@@include} (direttiva)
 @cindex chiocciola (@code{@@}) @subentry @code{@@include} (direttiva)
+@cindex @code{@@include} (direttiva) @sortas{include direttiva}
 @cindex direttiva @subentry @code{@@include}
 @cindex file @subentry includere, direttiva @code{@@include}
 @cindex includere file @subentry direttiva @code{@@include}
@@ -5675,6 +5700,7 @@ necessit@`a di scrivere righe di comando complesse e 
tediose.
 In particolare, @code{@@include} @`e molto utile per scrivere @dfn{script} CGI
 eseguibili da pagine web.
 
+@cindex direttiva @subentry @code{@@include}
 La direttiva @code{@@include} e l'opzione @option{-i}/@option{--include}
 sulla riga di comando sono completamente equivalenti. Un programma sorgente
 incluso non viene caricato di nuovo se @`e stato gi@`a caricato
@@ -5690,6 +5716,11 @@ in
 @ref{AWKPATH (Variabile)}, valgono anche per i file
 caricati tramite @code{@@include}.
 
+@cindex @code{@@} (chiocciola) @subentry @code{@@nsinclude} (direttiva)
+@cindex chiocciola (@code{@@}) @subentry @code{@@nsinclude} (direttiva)
+@cindex file subentry nsincludere @subentry direttiva @code{@@nsinclude}
+@cindex nsincludere file @subentry direttiva @code{@@nsinclude}
+@cindex @code{@@nsinclude} (direttiva) @sortas{nsinclude direttiva}
 Infine, i file inclusi con @code{@@include} sono considerati
 appartenere allo spazio-dei-nomi @samp{"awk" (@@namespace "awk")}
 a inizio programma. @xref{Cambiare lo spazio-dei-nomi}, per ulteriori
@@ -10030,12 +10061,12 @@ appaiono due righe @code{@@include} identiche, 
l'intero file specificato sia
 incluso ogni volta.
 @xref{Chiusura file e @dfn{pipe}}.
 
-Una carenza di questo programma @`e che non gestisce istruzioni
+Una carenza di questo programma @`e che non gestisce direttive
 @code{@@include} nidificate
-(cio@`e, istruzioni @code{@@include} contenute nei file inclusi)
+(cio@`e, direttive @code{@@include} contenute nei file inclusi)
 nel modo in cui ci si aspetta che funzioni un vero preelaboratore di macro.
 @xref{Programma igawk} per un programma
-che gestisce le istruzioni @code{@@include} nidificate.
+che gestisce le direttive @code{@@include} nidificate.
 
 @node Getline @dfn{pipe}
 @subsection Usare @code{getline} da una @dfn{pipe}
@@ -17853,6 +17884,10 @@ L'identificativo @`e un vettore.
 @item "builtin"
 L'identificativo @`e una funzione predefinita.
 
+@cindex @code{@@} (chiocciola) @subentry @code{@@load} (direttiva)
+@cindex chiocciola (@code{@@}) @subentry @code{@@load} (direttiva)
+@cindex @code{@@load} (direttiva) @sortas{load direttiva}
+@cindex direttiva @subentry @code{@@load}
 @item "extension"
 L'identificativo @`e una funzione in un'estensione caricata tramite
 @code{@@load} o con l'opzione @option{-l}.
@@ -29845,6 +29880,10 @@ in
 Le estensioni consentono di aggiungere funzioni a @command{gawk}, e queste
 possono anche essere dei codici scritti nei linguaggi C o C++.
 
+@cindex @code{@@} (chiocciola) @subentry @code{@@load} (direttiva)
+@cindex chiocciola (@code{@@}) @subentry @code{@@load} (direttiva)
+@cindex @code{@@load} (direttiva) @sortas{load direttiva}
+@cindex direttiva @subentry @code{@@load}
 Per quanto riguarda
 @file{wc.awk}, @`e sufficiente sapere che l'estensione viene caricata
 con la direttiva @code{@@load}, e la funzione ulteriore che dovr@`a essere
@@ -31383,7 +31422,7 @@ Il programma seguente, @file{igawk.sh}, fornisce questo 
servizio.
 Simula la ricerca da parte di @command{gawk} della variabile d'ambiente
 @env{AWKPATH} e permette anche delle inclusioni @dfn{nidificate} (cio@`e,
 un file che @`e stato incluso tramite
-@code{@@include} pu@`o contenere ulteriori istruzioni @code{@@include}).
+@code{@@include} pu@`o contenere ulteriori direttive @code{@@include}).
 @command{igawk} tenta di includere ogni file una volta sola, in modo che delle
 inclusioni nidificate non contengano accidentalmente una funzione di libreria
 pi@`u di una volta.
@@ -31427,7 +31466,7 @@ incluso nel programma al punto giusto.
 
 @item
 Esegue un programma (naturalmente @command{awk}) sui contenuti della variabile
-di shell per espandere le istruzioni
+di shell per espandere le direttive
 @code{@@include}.  Il programma espanso @`e messo in una seconda variabile di
 shell.
 
@@ -31472,7 +31511,7 @@ Queste opzioni sono conservate e lasciate da gestire a 
@command{gawk}.
 
 @item @option{-f}, @option{--file}, @option{--file=}, @option{-Wfile=}
 Il @value{FN} @`e aggiunto alla variabile di shell @code{programma}, insieme
-a un'istruzione @code{@@include}.
+a una direttiva @code{@@include}.
 Il programma di utilit@`a @command{expr} @`e usato per eliminare la parte
 iniziale dell'argomento (p.es., @samp{--file=}).
 (La sintassi tipica di @command{sh} richiederebbe di usare il comando
@@ -31601,8 +31640,8 @@ Il programma @command{awk} che elabora le direttive 
@code{@@include}
 @`e immagazzinato nella variabile di shell @code{progr_che_espande}.  Ci@`o 
serve
 a mantenere leggibile lo @dfn{script}.  Questo programma @command{awk} legge
 tutto il programma dell'utente, una riga per volta, usando @code{getline}
-(@pxref{Getline}).  I @value{FNS} in input e le istruzioni @code{@@include}
-sono gestiti usando una pila.  Man mano che viene trovata una @code{@@include},
+(@pxref{Getline}).  I @value{FNS} in input e le direttive @code{@@include}
+sono gestite usando una pila.  Man mano che viene trovata una @code{@@include},
 il valore corrente di @value{FN} @`e
 ``spinto'' sulla pila e il file menzionato nella direttiva @code{@@include}
 diventa il @value{FN} corrente.  Man mano che un file @`e finito,
@@ -31803,7 +31842,7 @@ le cose.
 @item
 Usare un ciclo di @code{getline} nella regola @code{BEGIN} rende possibile
 fare tutto in un solo posto.  Non @`e necessario programmare un ulteriore ciclo
-per elaborare le istruzioni @code{@@include} nidificate.
+per elaborare le direttive @code{@@include} nidificate.
 
 @item
 Invece di salvare il programma espanso in un file temporaneo, assegnarlo a
@@ -37122,8 +37161,8 @@ Quando @command{gawk} termina di elaborare il file 
incluso,
 lo spazio-dei-nomi salvato @`e ripristinato e l'elaborazione prosegue
 da dove era stata sospesa nel file originale.
 
-@cindex @code{@@} (chiocciola) @subentry @code{@@namespace} (direttiva) 
@subentry non riguarda @code{BEGIN}, @code{BEGINFILE}, @code{END}, ed 
@code{ENDFILE}
-@cindex chiocciola (@code{@@}) @subentry @code{@@namespace} (direttiva) 
@subentry non riguarda @code{BEGIN}, @code{BEGINFILE}, @code{END}, ed 
@code{ENDFILE}
+@cindex @code{@@} (chiocciola) @subentry @code{@@namespace} (direttiva) 
@subentry non altera ordine di esecuzione di @code{BEGIN}, @code{BEGINFILE}, 
@code{END}, ed @code{ENDFILE}
+@cindex chiocciola (@code{@@}) @subentry @code{@@namespace} (direttiva) 
@subentry non altera ordine di esecuzione di @code{BEGIN}, @code{BEGINFILE}, 
@code{END}, ed @code{ENDFILE}
 @cindex @code{BEGIN} (regola) @subentry ordine di esecuzione non alterato da 
@code{@@namespace}
 @cindex @code{BEGINFILE} (regola) @subentry ordine di esecuzione non alterato 
da @code{@@namespace}
 @cindex @code{END} (regola) @subentry ordine di esecuzione non alterato da 
@code{@@namespace}
@@ -37518,6 +37557,10 @@ interagisce con altre importanti funzionalit@`a di 
@command{gawk}.
 @cindex spazio-dei-nomi @subentry interazione con la ``stampa-elegante''
 @cindex profilazione @subentry interazione con spazio-dei-nomi
 @cindex stampa-elegante @subentry interazione con spazio-dei-nomi
+@cindex @code{@@} (chiocciola) @subentry @code{@@namespace} (direttiva)
+@cindex chiocciola (@code{@@}) @subentry @code{@@namespace} (direttiva)
+@cindex @code{@@namespace} (direttiva) @sortas{namespace direttiva}
+@cindex direttiva @subentry @code{@@namespace}
 La profilazione e la ``stampa-elegante'' (@pxref{Profilare}) sono state
 migliorate per trattare gli spazi-dei-nomi e le regole per assegnare nomi in
 uno spazio-dei-nomi @ref{Regole per i nomi}.
@@ -43524,8 +43567,12 @@ $ @kbd{gcc -fPIC -shared -DHAVE_CONFIG_H -c -O -g 
-I@var{idir} filefuncs.c}
 $ @kbd{gcc -o filefuncs.so -shared filefuncs.o}
 @end example
 
-Una volta creata la libreria, questa viene caricata usando la parola
-chiave @code{@@load}:
+@cindex @code{@@} (chiocciola) @subentry @code{@@load} (direttiva)
+@cindex chiocciola (@code{@@}) @subentry @code{@@load} (direttiva)
+@cindex @code{@@load} (direttiva) @sortas{load direttiva}
+@cindex direttiva @subentry @code{@@load}
+Una volta creata la libreria, questa viene caricata usando la direttiva
+@code{@@load}:
 
 @example
 # file testff.awk
@@ -46486,6 +46533,22 @@ innescava segnalazioni di errore, specie in alcune 
distribuzioni GNU/Linux.
 
 @end itemize
 
+La Versione 5.4 ha aggiunto le seguenti funzionalit@`a:
+
+@itemize
+
+@cindex @code{@@} (chiocciola) @subentry @code{@@nsinclude} (direttiva)
+@cindex chiocciola (@code{@@}) @subentry @code{@@nsinclude} (direttiva)
+@cindex file subentry includere @subentry direttiva @code{@@nsinclude}
+@cindex includere file @subentry direttiva @code{@@nsinclude}
+@cindex @code{@@nsinclude} (direttiva) @sortas{nsinclude direttiva}
+@cindex direttiva @subentry @code{@@nsinclude}
+@item
+La direttiva @code{@@nsinclude} per includere file senza forzare il
+cambio dello spazio-dei-nomi a @samp{awk}
+(@pxref{Inclusione per spazio-dei-nomi}).
+@end itemize
+
 @c XXX ADD MORE STUFF HERE
 @end ifclear
 
@@ -48643,7 +48706,7 @@ con un @value{DF} in input che possa riprodurre il 
problema.
 @item
 @cindex @command{gawkbug} (comando di utilit@`a)
 @cindex comando di utilit@`a @subentry @command{gawkbug}
-Si usi lo script @command{gawkbug} per preparare la segnalazione
+Si usi lo @dfn{script} @command{gawkbug} per preparare la segnalazione
 del bug.  Questo programma prepara un modello di segnalazione
 di bug e vi permette di modificarlo nel vostro programma di edit.
 Va quindi modificato appropriatamente per includere:
@@ -48685,7 +48748,7 @@ lingua che tutti i manutentori comprendono.}
 @cindex indirizzo email per segnalare bug @subentry @email{bug-gawk@@gnu.org}
 @cindex bug @subentry segnalare @subentry indirizzo email, 
@email{bug-gawk@@gnu.org}
 @cindex segnalare bug @subentry indirizzo email @subentry 
@email{bug-gawk@@gnu.org}
-Lo script @command{gawkbug} spedisce un messaggio di posta elettronica a
+Lo @dfn{script} @command{gawkbug} spedisce un messaggio di posta elettronica a
 @EMAIL{bug-gawk@@gnu.org,bug (trattino) gawk (chiocciola) gnu (punto) org}.
 
 I manutentori di @command{gawk} sono i destinatari, e riceveranno la
@@ -48695,7 +48758,7 @@ segnalazione di errore.
 mailing list rimane in archivio presso il Progetto GNU.
 
 A chi usa OpenVMS o la versione MinGW di @command{gawk},
-lo script @command{gawkbug} non @`e disponibile.  Siete pregati
+lo @dfn{script} @command{gawkbug} non @`e disponibile.  Siete pregati
 di spedire le informazioni elencate pi@`u sopra direttamente,
 in un messaggio email, alla lista che si occupa dei bug.
 Siete pregati di spedire eventuali programmi di test o file di
@@ -49281,7 +49344,7 @@ modificata da Nelson Beebe di BWK @command{awk}, 
descritta prima.)
 @cindex codice sorgente @subentry @command{awkcc}
 @item @command{awkcc}
 Questo @`e un adattamento di una versione Unix di @command{awk}
-che traduce script @command{awk} in programmi C.
+che traduce @dfn{script} @command{awk} in programmi C.
 @`E stato scritto da J.@: Christopher Ramming nei Bell Labs,
 attorno al 1988.
 @`E disponibile in @uref{https://github.com/nokia/awkcc}.
@@ -49318,7 +49381,7 @@ a partire dal 2014 circa.
 @cindex sorgente @subentry codice @subentry @command{cppawk}
 Secondo la pagina web che lo descrive, ``@command{cppawk} @`e un piccolo
 script di shell da chiamare come si chiamerebbe @command{awk}.
-Lo script invoca il preprocessore C (GNU @command{cpp}) sul codice
+Lo @dfn{script} invoca il preprocessore C (GNU @command{cpp}) sul codice
 programma in Awk e invoca Awk sul file risultante.''
 Questo programma pu@`o essere utile se la funzionalit@`a @code{@@include}
 di @command{gawk} non risponde alle vostre esigenze.
@@ -51253,6 +51316,10 @@ Emacs.  GNU Emacs @`e la versione di Emacs 
maggiormente usata oggigiorno.
 @item FSF
 Si veda ``Free Software Foundation''.
 
+@cindex @code{@@} (chiocciola) @subentry @code{@@include} (direttiva)
+@cindex chiocciola (@code{@@}) @subentry @code{@@include} (direttiva)
+@cindex @code{@@include} (direttiva) @sortas{include direttiva}
+@cindex direttiva @subentry @code{@@include}
 @item Funzione
 Una parte di un programma @command{awk} che si pu@`o chiamare da qualsiasi
 punto del programma, per eseguire un compito.  @command{awk} ha parecchie

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

Summary of changes:
 doc/it/ChangeLog |   4 +++
 doc/it/gawk.texi | 103 +++++++++++++++++++++++++++++++++++++++++++++----------
 2 files changed, 89 insertions(+), 18 deletions(-)


hooks/post-receive
-- 
gawk