[SCM] gawk branch, feature/docit, updated. gawk-4.1.0-4988-g76a7f988

[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  76a7f988892fb07f4a81408cd9ae0ecd6a304c4b (commit)
      from  8dfc51bc4b2e7a663c2b68bb40f86ef61daecf93 (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=76a7f988892fb07f4a81408cd9ae0ecd6a304c4b

commit 76a7f988892fb07f4a81408cd9ae0ecd6a304c4b
Author: Antonio Giovanni Colombo <azc100@gmail.com>
Date:   Tue Nov 8 09:49:09 2022 +0100

    VMS ===> OpenVMS

diff --git a/doc/it/ChangeLog b/doc/it/ChangeLog
index 52122dcc..fdeb6724 100755
--- a/doc/it/ChangeLog
+++ b/doc/it/ChangeLog
@@ -1,3 +1,7 @@
+2022-11-08         Antonio Giovanni Colombo   <azc100@gmail.com>
+
+       * gawktexi.in: Updated.
+
 2022-10-24         Antonio Giovanni Colombo   <azc100@gmail.com>
 
        * gawktexi.in: Updated.
diff --git a/doc/it/gawktexi.in b/doc/it/gawktexi.in
index 51f0c409..0ce361b3 100755
--- a/doc/it/gawktexi.in
+++ b/doc/it/gawktexi.in
@@ -1215,15 +1215,15 @@ Copyright dell'edizione italiana @copyright{} 2016 -- 
Free Software Foundation,
                                         per Cygwin.
 * MSYS::                                Usare @command{gawk} nell'ambiente
                                         MSYS.
-* Installazione su VMS::                Installare @command{gawk} su VMS.
-* Compilazione su VMS::                 Come compilare @command{gawk} su
-                                        VMS.
-* Estensioni dinamiche su VMS::         Compilare estensioni dinamiche
-                                        di @command{gawk} su VMS.
-* Dettagli installazione su VMS::       Come installare @command{gawk} su
-                                        VMS.
-* Esecuzione su VMS::                   Come eseguire @command{gawk} su VMS.
-* GNV su VMS::                          Il progetto GNV di VMS.
+* Installazione su OpenVMS::           Installare @command{gawk} su OpenVMS.
+* Compilazione su OpenVMS::             Come compilare @command{gawk} su
+                                        OpenVMS.
+* Estensioni dinamiche su OpenVMS::     Compilare estensioni dinamiche
+                                        di @command{gawk} su OpenVMS.
+* Dettagli installazione su OpenVMS::   Come installare @command{gawk} su
+                                        OpenVMS.
+* Esecuzione su OpenVMS::               Come eseguire @command{gawk} su 
OpenVMS.
+* GNV su OpenVMS::                      Il progetto GNV su OpenVMS.
 * Bug::                                 Notificare problemi e bug.
 * Definizione di bug::                  Definire cos'@`e e cosa non @`e un bug.
 * Indirizzo bug::                       Dove notificare problemi.
@@ -17453,7 +17453,7 @@ OS/390 (noto anche come z/OS).
 GNU/Linux, Cygwin, macOS, e sistemi Unix tradizionali.
 
 @item "vms"
-OpenVMS o VAX/VMS.
+OpenVMS.
 @end table
 
 @item PROCINFO["pgrpid"]
@@ -21809,7 +21809,7 @@ L'ora espressa in numero di secondi a partire 
dall'Epoca.
 
 @ignore
 @item %v
-La data in formato VMS (p.es., @samp{20-JUN-1991}).
+La data in formato OpenVMS (p.es., @samp{20-JUN-1991}).
 @end ignore
 @end table
 
@@ -44494,7 +44494,7 @@ Tandem (non-POSIX)
 Compilatore pre-standard VAX C per VAX/VMS
 
 @item
-GCC per VAX e Alpha non @`e stato verificato da parecchio tempo.
+GCC per Alpha non @`e stato verificato da parecchio tempo.
 
 @end itemize
 
@@ -46409,8 +46409,8 @@ File necessari per compilare @command{gawk} sotto 
MS-Windows
 (@pxref{Installazione su PC} per i dettagli).
 
 @item vms/*
-File necessari per compilare @command{gawk} sotto VAX/VMS e OpenVMS
-(@pxref{Installazione su VMS} per i dettagli).
+File necessari per compilare @command{gawk} sotto OpenVMS
+(@pxref{Installazione su OpenVMS} per i dettagli).
 
 @item test/*
 Una serie di test per
@@ -46824,7 +46824,7 @@ vari sistemi non-Unix.
 @menu
 * Installazione su PC::         Installare e compilare @command{gawk}
                                 su Microsoft Windows.
-* Installazione su VMS::        Installare @command{gawk} su VMS.
+* Installazione su OpenVMS::    Installare @command{gawk} su OpenVMS.
 @end menu
 
 @node Installazione su PC
@@ -47101,16 +47101,16 @@ automaticamente la conversione di @code{"\r\n"}, 
mentre cos@`{@dotless{i}} non @
 In ambiente MSYS2, la compilazione usando i comandi classici
 @samp{./configure && make} funziona senza necessitare di alcuna modifica.
 
-@node Installazione su VMS
-@appendixsubsec Compilare e installare @command{gawk} su VAX/VMS e OpenVMS
+@node Installazione su OpenVMS
+@appendixsubsec Compilare e installare @command{gawk} su OpenVMS
 
 @c based on material from Pat Rankin <rankin@eql.caltech.edu>
 @c now rankin@pactechdata.com
 @c now r.pat.rankin@gmail.com
 
-@cindex @command{gawk} @subentry versione VMS di
-@cindex installare @command{gawk} @subentry su VMS
-@cindex VMS @subentry installare @command{gawk} su
+@cindex @command{gawk} @subentry versione OpenVMS di
+@cindex installare @command{gawk} @subentry su OpenVMS
+@cindex OpenVMS @subentry installare @command{gawk} su
 @ifnotinfo
 Questa
 @end ifnotinfo
@@ -47120,23 +47120,23 @@ Questo
 @value{SUBSECTION}
 descrive come compilare e installare @command{gawk}
 sotto OpenVMS.
-Il termine classico ``VMS'' @`e usato qui per designare OpenVMS.
 
 @menu
-* Compilazione su VMS::           Come compilare @command{gawk} su VMS.
-* Estensioni dinamiche su VMS::   Compilare estensioni dinamiche
-                                  di @command{gawk} su VMS.
-* Dettagli installazione su VMS:: Come installare @command{gawk} su VMS.
-* Esecuzione su VMS::             Come eseguire @command{gawk} su VMS.
-* GNV su VMS::                       Il progetto VMS GNV.
+* Compilazione su OpenVMS::       Come compilare @command{gawk} su OpenVMS.
+* Estensioni dinamiche su OpenVMS:: Compilare estensioni dinamiche
+                                  di @command{gawk} su OpenVMS.
+* Dettagli installazione su OpenVMS:: Come installare @command{gawk} su
+                                  OpenVMS.
+* Esecuzione su OpenVMS::         Come eseguire @command{gawk} su OpenVMS.
+* GNV su OpenVMS::                Il progetto GNV su OpenVMS.
 @end menu
 
-@node Compilazione su VMS
-@appendixsubsubsec Compilare @command{gawk} su VMS
-@cindex compilare @command{gawk} @subentry per VMS
-@cindex VMS @subentry compilare @command{gawk} per
+@node Compilazione su OpenVMS
+@appendixsubsubsec Compilare @command{gawk} su OpenVMS
+@cindex compilare @command{gawk} @subentry per OpenVMS
+@cindex OpenVMS @subentry compilare @command{gawk} per
 
-Per compilare @command{gawk} sotto VMS, esiste una procedura di comandi
+Per compilare @command{gawk} sotto OpenVMS, esiste una procedura di comandi
 @code{DCL} che esegue tutti i comandi @code{CC} e @code{LINK} necessari. C'@`e
 anche un @file{Makefile} da usare con i programmi di utilit@`a @code{MMS} e
 @code{MMK}.
@@ -47174,7 +47174,7 @@ il nome del parametro che specifica l'obiettivo pu@`o 
dover essere scritto
 digitando esattamente le lettere maiuscole e minuscole.
 
 @command{gawk} @`e stato testato usando VMS Software, Inc.@:
-Community editions.
+Community editions:
 
 @itemize @bullet
 @item
@@ -47186,15 +47186,15 @@ IA64 @`e anche nota come ``Itanium''.}
 @end itemize
 
 Poich@'e HPE ha eliminato il programma di licenza Hobbyist, non @`e possibile
-effettuare ulteriori test su versioni pi@`u datate di VAX/VMS e OpenVMS.
+effettuare ulteriori test su versioni pi@`u datate di OpenVMS.
 
-@xref{GNV su VMS} per informazioni su come compilare
+@xref{GNV su OpenVMS} per informazioni su come compilare
 @command{gawk} come un kit PCSI compatible con il prodotto GNV.
 
-@node Estensioni dinamiche su VMS
-@appendixsubsubsec Compilare estensioni dinamiche di @command{gawk} in VMS
+@node Estensioni dinamiche su OpenVMS
+@appendixsubsubsec Compilare estensioni dinamiche di @command{gawk} su OpenVMS
 
-Le estensioni che sono state rese disponibile su VMS possono essere
+Le estensioni che sono state rese disponibile su OpenVMS possono essere
 costruite dando uno dei comandi seguenti:
 
 @example
@@ -47219,45 +47219,34 @@ col formato IEEE.  La dimensione dei puntatori @`e 32 
bit, e il trattamento dei
 simbolici dovrebbe richiedere il rispetto esatto di maiuscole/minuscole, con le
 abbreviazioni CRC per simboli pi@`u lunghi di 32 bit.
 
-Per Alpha e Itanium:
-
 @example
 /nome=(as_is,short)
 /float=ieee/ieee_mode=denorm_results
 @end example
 
-Per VAX@footnote{Le estensioni dinamiche in questo momento non funzionano
-su VAX, quanto segue vale solo come documentazione.}:
-
-@example
-/nome=(as_is,short)
-@end example
-
 Le macro da usare al momento della compilazione devono essere definite prima di
-includere il primo file di intestazione proveniente da VMS, come segue:
+includere il primo file di intestazione proveniente da OpenVMS, come segue:
 
 @example
-#if (__CRTL_VER >= 70200000) && !defined (__VAX)
+#if (__CRTL_VER >= 70200000)
 #define _LARGEFILE 1
 #endif
 
-#ifndef __VAX
 #ifdef __CRTL_VER
 #if __CRTL_VER >= 80200000
 #define _USE_STD_STAT 1
 #endif
 #endif
-#endif
 @end example
 
-Se si scrivono delle estensioni utente da eseguire su VMS, vanno fornite anche
-queste definizioni.  Il file @file{config.h} creato quando si compila
-@command{gawk} su VMS lo fa gi@`a; se invece si usa qualche altro file simile,
-occorre ricordarsi di includerlo prima di qualsiasi file di intestazione
-proveniente da VMS.
+Se si scrivono delle estensioni utente da eseguire su OpenVMS, vanno fornite
+anche queste definizioni.  Il file @file{config.h} creato quando si compila
+@command{gawk} su OpenVMS lo fa gi@`a; se invece si usa qualche altro file
+simile, occorre ricordarsi di includerlo prima di qualsiasi file di
+intestazione proveniente da OpenVMS.
 
-@node Dettagli installazione su VMS
-@appendixsubsubsec Installare @command{gawk} su VMS
+@node Dettagli installazione su OpenVMS
+@appendixsubsubsec Installare @command{gawk} su OpenVMS
 
 Per usare @command{gawk}, tutto ci@`o che serve @`e un comando ``esterno'', 
che @`e
 un simbolo @code{DCL} il cui valore inizia col segno del dollaro.
@@ -47291,14 +47280,14 @@ Per farlo solo nella sessione corrente si pu@`o usare:
 $ @kbd{set command gnv$gnu:[vms_bin]gawk_verb.cld}
 @end example
 
-Oppure il sistemista VMS pu@`o usare @file{GNV$GNU:[vms_bin]gawk_verb.cld} per
+Oppure il sistemista OpenVMS pu@`o usare @file{GNV$GNU:[vms_bin]gawk_verb.cld} 
per
 aggiungere i comandi @command{gawk} e @command{awk} alla tabella
 @samp{DCLTABLES} valida per tutto il sistema.
 
 La sintassi DCL @`e documentata nel file @file{gawk.hlp}.
 
 In alternativa, l'elemento @file{gawk.hlp} pu@`o essere caricato in una
-libreria di aiuto VMS:
+libreria di aiuto OpenVMS:
 
 @example
 $ @kbd{LIBRARY/HELP sys$help:helplib [.vms]gawk.hlp}
@@ -47306,7 +47295,7 @@ $ @kbd{LIBRARY/HELP sys$help:helplib [.vms]gawk.hlp}
 
 @noindent
 (Una libreria specifica dell'installazione potrebbe venir usata invece
-della libreria standard VMS library @samp{HELPLIB}.)  Dopo aver installato
+della libreria standard OpenVMS @samp{HELPLIB}.)  Dopo aver installato
 il testo di aiuto, il comando:
 
 @example
@@ -47327,11 +47316,11 @@ ancora stato trovato, @command{gawk} appone il 
suffisso @samp{.awk} al
 @value{FN} e ritenta la ricerca del file.  Se @samp{AWK_LIBRARY} non @`e
 definita, si usa per essa il valore di default @samp{SYS$LIBRARY:}.
 
-@node Esecuzione su VMS
-@appendixsubsubsec Eseguire @command{gawk} su VMS
+@node Esecuzione su OpenVMS
+@appendixsubsubsec Eseguire @command{gawk} su OpenVMS
 
 L'elaborazione della riga di comando e le convenzioni per proteggere i
-caratteri sono significativamente differenti in VMS, e quindi gli esempi
+caratteri sono significativamente differenti in OpenVMS, e quindi gli esempi
 presenti in questo @value{DOCUMENT} o provenienti da altre fonti necessitano
 piccole modifiche.  Le modifiche, tuttavia, @emph{sono} veramente piccole, e
 tutti i programmi @command{awk} dovrebbero funzionare correttamente.
@@ -47348,33 +47337,34 @@ $ @kbd{gawk -"W" version}
 Si noti che il testo con caratteri maiuscoli e misti maiuscoli/minuscoli
 dev'essere incluso tra doppi apici.
 
-La versione VMS di @command{gawk} comprende un'interfaccia in stile @code{DCL},
-oltre a quella originale, di tipo shell (si veda il file di aiuto per ulteriori
-dettagli).  Un effetto indesiderato della duplice analisi della riga
-di comando @`e che se c'@`e solo un unico parametro (come nel programma con le
-righe contenenti doppi apici), il comando diviene ambiguo.  Per evitare questo
-inconveniente, il flag, normalmente non necessario, @option{--} @`e necessario
-per forzare un esame dei parametri in stile Unix, piuttosto che nella 
modalit@`a
-@code{DCL}.  Se qualsiasi altra opzione preceduta dal segno @option{-} (o pi@`u
-parametri, per esempio, pi@`u @value{DF} in input) @`e presente, non c'@`e 
ambiguit@`a,
+La versione OpenVMS di @command{gawk} comprende un'interfaccia in stile
+@code{DCL}, oltre a quella originale, di tipo shell (si veda il file di aiuto
+per ulteriori dettagli).  Un effetto indesiderato della duplice analisi della
+riga di comando @`e che se c'@`e solo un unico parametro (come nel programma
+con le righe contenenti doppi apici), il comando diviene ambiguo.  Per evitare
+questo inconveniente, il flag, normalmente non necessario, @option{--} @`e
+necessario per forzare un esame dei parametri in stile Unix, piuttosto che
+nella modalit@`a @code{DCL}.
+Se qualsiasi altra opzione preceduta dal segno @option{-} (o pi@`u parametri,
+per esempio, pi@`u @value{DF} in input) @`e presente, non c'@`e ambiguit@`a,
 e l'opzione @option{--} pu@`o essere omessa.
 
-@cindex codice di ritorno @subentry di @command{gawk} @subentry in VMS
-@cindex @code{exit} (istruzione) @subentry codice di ritorno di 
@command{gawk}, in VMS
+@cindex codice di ritorno @subentry di @command{gawk} @subentry in OpenVMS
+@cindex @code{exit} (istruzione) @subentry codice di ritorno di 
@command{gawk}, in OpenVMS
 Il valore di @code{exit} @`e un valore in stile Unix e viene trasformato in
-un codice di ritorno VMS all'uscita del programma.
+un codice di ritorno OpenVMS all'uscita del programma.
 
-I bit di severit@`a di VMS saranno impostati a partire dal valore 
dell'istruzione
-@code{exit}.  Un errore grave @`e indicato da 1, e VMS imposta la condizione
-@code{ERROR}.  Un errore fatale @`e indicato da 2, e VMS imposta la condizione
+I bit di severit@`a di OpenVMS saranno impostati a partire dal valore 
dell'istruzione
+@code{exit}.  Un errore grave @`e indicato da 1, e OpenVMS imposta la 
condizione
+@code{ERROR}.  Un errore fatale @`e indicato da 2, e OpenVMS imposta la 
condizione
 @code{FATAL}.  Ogni altro valore imposta la condizione @code{SUCCESS}.  Il
-valore d'uscita @`e codificato per aderire agli standard di codifica VMS e 
avr@`a
+valore d'uscita @`e codificato per aderire agli standard di codifica OpenVMS e 
avr@`a
 un @code{C_FACILITY_NO} di @code{0x350000} con il codice costante @code{0xA000}
 aggiunto al numero spostato a sinistra di 3 bit per far posto al codice di
 severit@`a.
 
 Per estrarre il codice reale di ritorno dell'istruzione @code{exit}
-di @command{gawk} dalla condizione impostata da VMS, si usi:
+di @command{gawk} dalla condizione impostata da OpenVMS, si usi:
 
 @example
 unix_status = (vms_status .and. %x7f8) / 8
@@ -47384,20 +47374,8 @@ unix_status = (vms_status .and. %x7f8) / 8
 Un programma C che usa @code{exec()} per chiamare @command{gawk}
 ricever@`a il valore originale della exit in stile Unix.
 
-Precedenti versioni di @command{gawk} per VMS consideravano un
-codice di ritorno a Unix di 0 come 1, un errore come 2,
-un errore fatale come 4, e tutti
-gli altri valori erano restituiti immodificati.  Questa era una violazione
-rispetto alle specifiche di codifica delle condizioni di uscita di VMS.
-
-@cindex numeri @subentry in virgola mobile @subentry VAX/VMS
-@cindex VAX/VMS @subentry numeri in virgola mobile,
-L'aritmetica in virgola mobile VAX/VMS usa un arrotondamento statistico.
-@xref{Funzione round}.
-
-VMS restituisce data e ora in formato GMT, a meno che non siano stati impostati
-i nomi logici @code{SYS$TIMEZONE_RULE} o @code{TZ}.  Precedenti versioni di
-VMS, come VAX/VMS 7.3, non impostano questi nomi logici.
+OpenVMS restituisce data e ora in formato GMT, a meno che non siano stati 
impostati
+i nomi logici @code{SYS$TIMEZONE_RULE} o @code{TZ}.
 
 @cindex percorso di ricerca
 @cindex percorso di ricerca @subentry per file sorgente
@@ -47411,24 +47389,24 @@ di directory, separate da virgola.  Nel definirla, il 
valore dovrebbe essere
 incluso tra doppi apici, in modo che consenta una sola traduzione, e non una
 lista di ricerca multitraduzione @code{RMS}.
 
-@cindex ridirezione in VMS
+@cindex ridirezione in OpenVMS
 Questa restrizione vale anche se si esegue @command{gawk} sotto GNV,
 in quanto la ridirezione @`e sempre verso un comando DCL.
 
-Se si ridirigono dati verso un comando o un programma di utilit@`a VMS,
-l'implementazione corrente richiede la creazione di un comando VMS esterno che
+Se si ridirigono dati verso un comando o un programma di utilit@`a OpenVMS,
+l'implementazione corrente richiede la creazione di un comando OpenVMS esterno 
che
 esegua un file di comandi, prima di invocare @command{gawk}.
 (Questa restrizione potrebbe essere rimossa in una futura versione di
-@command{gawk} per VMS.)
+@command{gawk} su OpenVMS.)
 
 Senza un tale file di comandi, i dati in input saranno presenti anche
 in output, prima dei dati di output veri e propri.
 
-Ci@`o consente la simulazione di comandi POSIX non disponibili in VMS
+Ci@`o consente la simulazione di comandi POSIX non disponibili in OpenVMS
 o l'uso di programmi di utilit@`a GNV.
 
 L'esempio seguente mostra come ridirigere dati da @command{gawk} verso il
-comando VMS @command{sort}.
+comando OpenVMS @command{sort}.
 
 @example
 $ sort = "@@device:[dir]vms_gawk_sort.com"
@@ -47456,10 +47434,10 @@ $ define/user sys$input sys$command:
 $ sort sys$input: sys$output:
 @end example
 
-@node GNV su VMS
-@appendixsubsubsec Il progetto VMS GNV
+@node GNV su OpenVMS
+@appendixsubsubsec Il progetto GNV su OpenVMS
 
-Il pacchetto VMS GNV fornisce un ambiente di sviluppo simile
+Il pacchetto OpenVMS GNV fornisce un ambiente di sviluppo simile
 a POSIX tramite una collezione di strumenti @dfn{open source}.
 Il @command{gawk} presente nel pacchetto base GNV @`e una vecchia versione.
 Attualmente, il progetto GNV @`e in fase di riorganizzazione, con l'obiettivo
@@ -47470,7 +47448,7 @@ La procedura normale per compilare @command{gawk} 
produce un programma
 adatto a essere usato con GNV.
 
 Il file @file{vms/gawk_build_steps.txt} nella distribuzione documenta
-la procedura per compilare un pacchetto PCSI compatible con GNV.
+la procedura per compilare un pacchetto PCSI OpenVMS compatible con GNV.
 
 @node Bug
 @appendixsec Segnalazione di problemi e bug
@@ -47974,7 +47952,7 @@ Le persone che si occupano delle varie versioni di 
@command{gawk} sono:
 
 @item MS-Windows con MinGW @tab Eli Zaretskii, @EMAIL{eliz@@gnu.org,eliz 
(chiocciola) gnu (punto) org}
 
-@item VMS @tab John Malmberg, @EMAIL{wb8tyw@@qsl.net,wb8tyw (chiocciola) qsl 
(punto) net}
+@item OpenVMS @tab John Malmberg, @EMAIL{wb8tyw@@qsl.net,wb8tyw (chiocciola) 
qsl (punto) net}
 
 @item z/OS (OS/390) @tab Daniel Richard G.@: @EMAIL{skunk@@iSKUNK.ORG,skunk 
(chiocciola) iSKUNK (punto) ORG}
 @end multitable
@@ -48333,7 +48311,7 @@ per poter scaricare il file.
 @command{gawk} pu@`o essere installato anche su sistemi non-POSIX.  I sistemi
 correntemente supportati sono MS-Windows, usando
 MSYS, MSYS2, MinGW e Cygwin,
-e sia VAX/VMS che OpenVMS.  Le istruzioni per ognuno di questi sistemi sono
+e OpenVMS.  Le istruzioni per ognuno di questi sistemi sono
 incluse in
 @ifnotinfo
 questa

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

Summary of changes:
 doc/it/ChangeLog   |   4 ++
 doc/it/gawktexi.in | 192 ++++++++++++++++++++++++-----------------------------
 2 files changed, 89 insertions(+), 107 deletions(-)


hooks/post-receive
-- 
gawk