[SCM] gawk branch, feature/docit, updated. gawk-4.1.0-5142-g9a90db38

[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  9a90db38b60a16259b5052231c189e78a00db364 (commit)
      from  5384f3ac1faee87420abe2935b9bf46548eb4f5c (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=9a90db38b60a16259b5052231c189e78a00db364

commit 9a90db38b60a16259b5052231c189e78a00db364
Author: Antonio Giovanni Colombo <azc100@gmail.com>
Date:   Mon Feb 13 11:54:41 2023 +0100

    noflush stuff update

diff --git a/doc/it/ChangeLog b/doc/it/ChangeLog
index e0aed651..551f9d34 100755
--- a/doc/it/ChangeLog
+++ b/doc/it/ChangeLog
@@ -1,3 +1,7 @@
+2023-02-13         Antonio Giovanni Colombo   <azc100@gmail.com>
+
+       * gawktexi.in: Updated.
+
 2023-02-10         Antonio Giovanni Colombo   <azc100@gmail.com>
 
        * gawktexi.in: Updated.
diff --git a/doc/it/gawktexi.in b/doc/it/gawktexi.in
index bfb9c4e3..f9b8ab21 100755
--- a/doc/it/gawktexi.in
+++ b/doc/it/gawktexi.in
@@ -56,9 +56,9 @@
 @c applies to and all the info about who's publishing this edition
 
 @c These apply across the board.
-@set UPDATE-MONTH Dicembre 2022
-@set VERSION 5.2
-@set PATCHLEVEL 2
+@set UPDATE-MONTH Febbraio 2023
+@set VERSION 5.3
+@set PATCHLEVEL 0
 
 @c added Italian hyphenation stuff
 @hyphenation{ven-go-no o-met-te-re o-met-ten-do}
@@ -772,6 +772,7 @@ Copyright dell'edizione italiana @copyright{} 2016 -- Free 
Software Foundation,
                                         @code{close()}.
 * Continuazione dopo errori::           Abilitare continuazione dopo errori
                                         in output.
+* Noflush::                             Velocizzare output da @dfn{pipe}.
 * Sommario di Output::                  Sommario di Output.
 * Esercizi su Output::                  Esercizi.
 * Valori::                              Costanti, variabili ed espressioni
@@ -10521,6 +10522,7 @@ e parla della funzione predefinita @code{close()}.
                                file gi@`a aperti a inizio esecuzione
 * Chiusura file e @dfn{pipe}::  Chiudere file in input e di output e
                                 @dfn{pipe}.
+* Noflush::                     Velocizzare output da @dfn{pipe}.
 * Continuazione dopo errori::   Abilitare continuazione dopo errori
                                 in output.
 * Sommario di Output::          Sommario di Output.
@@ -12138,8 +12140,63 @@ portabile.
 In modalit@`a POSIX (@pxref{Opzioni}), @command{gawk} restituisce solo zero
 quando chiude una @dfn{pipe}.
 
+@node Noflush
+@section Velocizzare output da @dfn{pipe}
+@c FIXME: Add indexing
+
+Questa
+@end ifnotinfo
+@ifinfo
+Questo
+@end ifinfo
+@value{SECTION} descrive una funzionalit@`a propria di @command{gawk}.
+
+Normalmente, quando si spediscono data tramite una @dfn{pipe} a
+un comando, usando le istruzioni @code{print} o @code{printf},
+@command{gawk} scarica l'output verso la @dfn{pipe}.
+Ovvero, l'output non @`e bufferizzato, ma scritto direttamente.
+Ci@`o garantisce che l'output della @dfn{pipe}, insieme a quello
+generato da @command{gawk} viene scritto enll'ordine che ci si
+aspetta:
+
+@example
+print "qualcosa"                       # va allo standard output
+print "qualcos'altro" | "un-comando"   # anche allo standard output
+print "ulteriori cose"                 # come pure questo
+@end example
+
+Fare ci@`o ha un prezzo; scaricare dati nella @dfn{pipe} usa
+pi@`u tempo CPU, e in alcuni ambienti tale consumo pu@`o
+essere eccessivo.
+
+Si pu@`o chiedere a @command{gawk} di non scaricare direttamente dati
+ma di bufferizzarli, in uno dei seguenti due modi:
+
+@itemize @bullet
+@item
+Impostare @code{PROCINFO["BUFFERPIPE"]} a un valore qualsiasi.
+Dopo aver fatto questo, @command{gawk} bufferizzer@`a i dati per tutte
+le @dfn{pipe}.
+
+@item
+Impostare @code{PROCINFO["@var{un-comando}", "BUFFERPIPE"]} a un
+valore qualsiasi. In tal caso, solo i dati relativi al comando
+@var{un-comando} saranno bufferizzati.
+@end itemize
+
+Uno degli elementi visti sopra @emph{deve} essere impostato nel
+vettore @code{PROCINFO} @emph{prima} di eseguire la prima istruzione
+@code{print} o @code{printf} diretta alla @dfn{pipe}.
+Se lo si fa dopo che dell'output @`e gi@`a stato inviato alla @dfn{pipe},
+@`e troppo tardi.
+
+Utilizzare questa funzionalit@`a pu@`o modificare il comportamento
+dell'output [cambiando l'ordine di quel che viene stampato],
+quindi occorre stare attenti a quello che si fa.
+
 @node Continuazione dopo errori
 @section Abilitare continuazione dopo errori in output
+@c FIXME: Add indexing
 
 @ifnotinfo
 Questa
@@ -17675,6 +17732,14 @@ I seguenti elementi consentono di modificare il 
comportamento di
 @command{gawk}:
 
 @table @code
+@item PROCINFO["BUFFERPIPE"]
+Se questo elemento esiste, tutto l'output alla @dfn{pipe} viene
+bufferizzato.
+
+@item PROCINFO["@var{un-comando}", "BUFFERPIPE"]
+Rende bufferizzato l'output del comnado @var{un-comando}.
+@xref{Noflush}.
+
 @item PROCINFO["NONFATAL"]
 Se questo elemento esiste, gli errori di I/O per tutte le ridirezioni
 consentono la prosecuzione del programma.
@@ -45653,6 +45718,25 @@ persistente (PMA) @`e disponibile.
 
 @end itemize
 
+La versione 5.3 ha aggiunto le seguenti funzionalit@`a:
+
+@itemize
+@item
+Divisione in campi per file di tipo CSV (Campi separati da virgola)
+(@pxref{Campi separati da virgola}).
+
+@item
+La possibilit@`a che @command{gawk} bufferizzi l'output a @dfn{pipe}
+(@pxref{Noflush}).
+
+@item
+La necessit@`a di utilizzare la libreria GNU @code{libsigsegv}
+@`e stata rimossa da @command{gawk}.
+Il valore aggiunto relativo non @`e mai stato grande e la funzionalit@`a
+causava problemi in alcuni sistemi.
+
+@end itemize
+
 @c XXX ADD MORE STUFF HERE
 @end ifclear
 

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

Summary of changes:
 doc/it/ChangeLog   |  4 +++
 doc/it/gawktexi.in | 90 ++++++++++++++++++++++++++++++++++++++++++++++++++++--
 2 files changed, 91 insertions(+), 3 deletions(-)


hooks/post-receive
-- 
gawk