[SCM] gawk branch, feature/docit, updated. gawk-4.1.0-5399-g8cd258bc

[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  8cd258bc4b3e5a22c0ccb5c5a6abd073719bc702 (commit)
      from  02c5147dbe1eaea911a2e67bae9251246d28b861 (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=8cd258bc4b3e5a22c0ccb5c5a6abd073719bc702

commit 8cd258bc4b3e5a22c0ccb5c5a6abd073719bc702
Author: Antonio Giovanni Colombo <azc100@gmail.com>
Date:   Sun Oct 22 12:26:36 2023 +0200

    ">" vs. ">>" in gawk.texi and update gawkbug.1

diff --git a/doc/it/ChangeLog b/doc/it/ChangeLog
index 6e32f838..aa0fc325 100755
--- a/doc/it/ChangeLog
+++ b/doc/it/ChangeLog
@@ -1,3 +1,8 @@
+2023-10-22         Antonio Giovanni Colombo   <azc100@gmail.com>
+
+       * gawkbug.1: Updated.
+       * gawk.texi: Updated.
+
 2023-10-20         Antonio Giovanni Colombo   <azc100@gmail.com>
 
        * gawk.1: Updated.
diff --git a/doc/it/gawk.texi b/doc/it/gawk.texi
index 40078fb3..2f01d711 100644
--- a/doc/it/gawk.texi
+++ b/doc/it/gawk.texi
@@ -11776,31 +11776,43 @@ richiede al sistema di aprire un file, una @dfn{pipe} 
o un coprocesso solo se
 il particolare @var{file} o @var{comando} che si @`e specificato non @`e gi@`a
 stato utilizzato in scrittura dal programma o se @`e stato chiuso
 dopo l'ultima scrittura.
+In altre parole, sia i file che le @dfn{pipe} e i coprocessi rimangono
+aperti finché non vengono esplicitamente chiusi.  Ogni istruzione
+@code{print} e @code{printf} dopo la prima, continua a scrivere
+allo stesso file, @dfn{pipe} o coprocesso.
 
 @cindex debug @subentry stampare
-@`E un errore comune usare la ridirezione @samp{>} per la prima istruzione
-@code{print} verso un file, e in seguito usare @samp{>>} per le successive
-scritture in output:
+In una shell, quando si stia preparando un file una riga per volta,
+si usa @samp{>} per creare il file, e poi si usa @samp{>>} per
+ogni successiva aggiunta al file stesso, come nell'esempio
+seguente:
 
 @example
-# inizializza il file
-print "Non v'allarmate" > "guida.txt"
-@dots{}
-# aggiungi in fondo al file
-print "Evitate generatori di improbabilit@`a" >> "guide.txt"
-@end example
-
-@noindent
-Questo @`e il modo in cui le ridirezioni devono essere usate lavorando
-con la shell.  Ma in @command{awk} ci@`o non @`e necessario.  In casi di questo
-genere, un programma dovrebbe
-usare @samp{>} per tutte le istruzioni @code{print}, perch@'e il file di
-output @`e aperto una sola volta.
-(Usando sia @samp{>} che @samp{>>} nello stesso programma, l'output @`e 
prodotto
-nell'ordine atteso.
-Tuttavia il mischiare gli operatori per lo stesso file @`e sintomo di uno
-stile di programmazione inelegante, e pu@`o causare confusione in chi legge
-il programma.)
+echo Nome: Arnold Robbins > dati
+echo Indirizzo: 1234 A Pretty Street, NE >> dati
+echo Città e Stato: MyTown, MyState 12345-6789 >> dati
+@end example
+
+In @command{awk}, gli operatori @samp{>} e @samp{>>} hanno un
+significato un po' diverso.  L'operatore usato la @emph{prima volta}
+che si scrive un file indica @emph{come} @command{awk} aprirà (o creerà )
+quel file.
+Usando @samp{>}, il file, se esiste, viene riscritto dall'inizio
+(o viene creato se non esiste). Tutte le successive operazioni di
+scrittura aggiungono dati al file, anche se le successive istruzioni
+@code{print} o @code{printf} continuano a usare @samp{>}.
+Usando invece @samp{>>} la prima volta, il file non viene
+riscritto dall'inizio (ma viene creato se non esiste).  Tutte le
+successive operazioni @code{print} o @code{printf} aggiungono dati
+al file.
+
+Per consistenza, sarebbe bene usare sempre un unico operatore per
+tutto l'output diretto a uno stesso file.
+(Si possono mischiare @samp{>} e @samp{>>}, e la cosa non ha effetti
+negativi, ma mischiare gli operatori è considerato cattivo stile in
+@command{awk}.  Se invocato con l'opzione @option{--lint}, @command{gawk}
+emette un messaggio di avvertimento quando entrambi gli
+operatori vengono usati per uno stesso file aperto.)
 
 @cindex differenze tra @command{awk} e @command{gawk} @subentry limitazioni di 
implementazione
 @cindex problemi di implementazione @subentry @command{gawk} @subentry 
limitazioni
@@ -19845,26 +19857,6 @@ for (i in a) @{
 @xref{Visitare vettori} per una funzione definita dall'utente che
 ``visita'' un vettore di vettori di dimensioni arbitrarie.
 
-Si ricordi che un riferimento a un elemento di un vettore non
-inizializzato genera un elemento con valore uguale a @code{""}, la stringa
-nulla. Questo ha
-un'importante implicazione quando s'intende usare un sottovettore come
-argomento di una funzione, come illustrato nel seguente esempio:
-
-@example
-$ @kbd{gawk 'BEGIN @{ split("a b c d", b[1]); print b[1][1] @}'}
-@error{} gawk: riga com.:1: fatale: split: secondo argomento
-@error{}                                      non-vettoriale
-@end example
-
-Il modo per aggirare quest'ostacolo @`e quello di definire prima @code{b[1]}
-come vettore creando un indice arbitrario:
-
-@example
-$ @kbd{gawk 'BEGIN @{ b[1][1] = ""; split("a b c d", b[1]); print b[1][1] @}'}
-@print{} a
-@end example
-
 @node Sommario dei vettori
 @section Sommario
 
@@ -52954,38 +52946,4 @@ text.  It's ok as one word when it's a metasyntactic 
variable, though.
 ------------------------
 ORA uses filename, thus the macro.
 
-Suggestions:
-------------
-
-Better sidebars can almost sort of be done with:
-
-       @ifdocbook
-       @macro @sidebar{title, content}
-       @inlinefmt{docbook, <sidebar><title>}
-       \title\
-       @inlinefmt{docbook, </title>}
-       \content\
-       @inlinefmt{docbook, </sidebar>}
-       @end macro
-       @end ifdocbook
-
-
-       @ifnotdocbook
-       @macro @sidebar{title, content}
-       @cartouche
-       @center @b{\title\}
-
-       \content\
-       @end cartouche
-       @end macro
-       @end ifnotdocbook
-
-But to use it you have to say
-
-       @sidebar{Title Here,
-       @include file-with-content
-       }
-
-which sorta sucks.
-
 TODO:
diff --git a/doc/it/gawkbug.1 b/doc/it/gawkbug.1
old mode 100755
new mode 100644
index 484777a8..a0f023f7
--- a/doc/it/gawkbug.1
+++ b/doc/it/gawkbug.1
@@ -7,12 +7,12 @@
 .\"     Last Change: Mon Apr 18 16:21:25 IDT 2022
 .\"
 .\" Traduzione di Antonio Giovanni Colombo <azc100@gmail.com>
-.\" per la versione gawk-5.2
-.TH GAWKBUG 1 "2022 Apr 18" "GNU Awk 5.2"
+.\" per la versione gawk-5.2 / gawk-5.3
+.TH GAWKBUG 1 "2023 Oct 18" "GNU Awk 5.3"
 .SH NOME
 gawkbug \- segnala un bug di gawk
 .SH SINTASSI
-\fBgawkbug\fP [\fI--version\fP] [\fI--help\fP] [\fIindirizzo-email\fP]
+\fBgawkbug\fP [\fI\-\^\-version\fP] [\fI\-\^\-help\fP] [\fIemail-address\fP]
 .SH DESCRIZIONE
 .B gawkbug
 è una script di shell che aiuta un utente a comporre e spedire delle

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

Summary of changes:
 doc/it/ChangeLog |   5 +++
 doc/it/gawk.texi | 108 +++++++++++++++++--------------------------------------
 doc/it/gawkbug.1 |   6 ++--
 3 files changed, 41 insertions(+), 78 deletions(-)
 mode change 100755 => 100644 doc/it/gawkbug.1


hooks/post-receive
-- 
gawk