[SCM] gawk branch, feature/docit, updated. gawk-4.1.0-4539-g19a4de3

[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  19a4de34496c20c1c8d068837dba4e3357b75146 (commit)
      from  fc1c85bd36910c9ef743db07022055e2d417c21b (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=19a4de34496c20c1c8d068837dba4e3357b75146

commit 19a4de34496c20c1c8d068837dba4e3357b75146
Author: Antonio Giovanni Colombo <azc100@gmail.com>
Date:   Thu Oct 21 15:39:00 2021 +0200

    Added section about FS and FPAT

diff --git a/doc/it/ChangeLog b/doc/it/ChangeLog
index cb6cfdb..1576bc2 100644
--- a/doc/it/ChangeLog
+++ b/doc/it/ChangeLog
@@ -1,3 +1,7 @@
+2021-10-21         Antonio Giovanni Colombo   <azc100@gmail.com>
+
+       * gawktexi.in: Updated.
+
 2021-10-11         Antonio Giovanni Colombo   <azc100@gmail.com>
 
        * gawktexi.in: Updated.
diff --git a/doc/it/gawktexi.in b/doc/it/gawktexi.in
index 9f5b7f8..e56d63d 100755
--- a/doc/it/gawktexi.in
+++ b/doc/it/gawktexi.in
@@ -693,6 +693,7 @@ Copyright dell'edizione italiana @copyright{} 2016 -- Free 
Software Foundation,
                                         fissa.
 * Separazione in base al contenuto::    Definire campi dal loro contenuto.
 * File CSV::                            Ancora sui file CSV.
+* FS rispetto a FPAT::                  Una differenza sottile.
 * Controllare la creazione di campi::   Controllare come @command{gawk} sta
                                         suddividendo i record.
 * Righe multiple::                      Record su righe multiple
@@ -8697,6 +8698,7 @@ per un esempio di tale funzione).
 
 @menu
 * File CSV::                    Ancora sui file CSV.
+* FS rispetto a FPAT::          Una differenza sottile.
 @end menu
 
 @c O'Reilly doesn't like it as a note the first thing in the section.
@@ -8932,6 +8934,31 @@ In generale, usare @code{FPAT} per effettuare l'analisi 
di dati in formato CSV
 messa a disposizione da Manuel Collado.  Vedere:
 @uref{http://mcollado.z15.es/xgawk/, @code{CSVMODE} libreria per 
@command{gawk}}.
 
+@node FS rispetto a FPAT
+@subsection @code{FS} rispetto a @code{FPAT}: Una differenza sottile
+
+Come gi@`a spiegato, @code{FS} descrive i data che si trovano tra un campo e
+l'altro (``ci@`o che non @`e un campo'') mentre @code{FPAT} descrive i campi 
stessi
+(``ci@`o che @`e un campo'').
+Ci@`o pu@`o portare a una sottile differenza nell'individuazione dei campi, se 
si usano
+@dfn{regexp} [espressioni regolari] come valori per @code{FS} o @code{FPAT}.
+
+Per distinguere un campo da un altro, ci dev'essere un separatore (diverso 
dalla stringa
+nulla) fra i campi stessi.  Ci@`o @`e evidentemente sensato---altrimenti non 
si potrebbero
+distinguere i campi dai separatori.
+
+Quindi, il valore di un'espressione regolare specificata come @code{FS} non 
pu@`o
+essere la stringa nulla; dev'essere lunga almeno un carattere, per poter
+esguire i controlli sull'intero record.
+
+D'altro canto, il valore di un'espressione regolare specificata come 
@code{FPAT}
+pu@`o essere la stringa nulla, e i caratteri che non corrispondono ad essa
+vengono utilizzati come separatori.
+
+Questa stessa differenza si riscontra nel modo con cui si individuano le
+stringhe utilizzando le funzioni @code{split()} e @code{patsplit()}
+(@pxref{Funzioni per stringhe}).
+
 @node Controllare la creazione di campi
 @section Controllare come @command{gawk} sta suddividendo i record
 
@@ -20296,6 +20323,18 @@ I caratteri non alfabetici non vengono modificati.  
Per esempio,
 @code{"MAIUSCOLO MINUSCOLO 123"}.
 @end table
 
+A prima vista, le funzioni @code{split()} e @code{patsplit()} sembrano
+essere immagini speculari l'una dell'altra.  Ma ci sono delle differenze:
+
+@itemize @bullet
+@item @code{split()} tratta il suo terzo argomento allo stesso modo della
+variabile @code{FS}, con tutte le regole speciali che riguardano
+@code{FS}.
+
+@item L'individuazioni di stringhe nulle @`e invece differente.
+Questo @`e spiegato in @ref{FS rispetto a FPAT}.
+@end itemize
+
 @sidebar Individuare la stringa nulla
 @cindex individuare @subentry la stringa nulla
 @cindex stringa nulla @subentry individuare la

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

Summary of changes:
 doc/it/ChangeLog   |  4 ++++
 doc/it/gawktexi.in | 39 +++++++++++++++++++++++++++++++++++++++
 2 files changed, 43 insertions(+)


hooks/post-receive
-- 
gawk