[SCM] gawk branch, feature/docit, updated. gawk-4.1.0-5465-gd416aa83

[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  d416aa83d6de3931f5a512f4c06f131758214c40 (commit)
      from  92f32a62595bc534a112ed408ba4e2c2dcd6b02d (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=d416aa83d6de3931f5a512f4c06f131758214c40

commit d416aa83d6de3931f5a512f4c06f131758214c40
Author: Antonio Giovanni Colombo <azc100@gmail.com>
Date:   Tue Dec 26 18:24:07 2023 +0100

    Clarification about API + other minor stuff

diff --git a/doc/it/ChangeLog b/doc/it/ChangeLog
index 1cd14209..25fe7f6a 100755
--- a/doc/it/ChangeLog
+++ b/doc/it/ChangeLog
@@ -1,3 +1,7 @@
+2023-12-26         Antonio Giovanni Colombo   <azc100@gmail.com>
+
+       * gawk.texi: Updated.
+
 2023-12-04         Antonio Giovanni Colombo   <azc100@gmail.com>
 
        * gawk.texi: Updated.
diff --git a/doc/it/gawk.texi b/doc/it/gawk.texi
index 66abc9c4..c9e5ad91 100644
--- a/doc/it/gawk.texi
+++ b/doc/it/gawk.texi
@@ -84,12 +84,7 @@
 @set SECTIONS sezioni
 @set SUBSECTION sottosezione
 @set SUBSECTIONS sottosezioni
-@ifclear SMALLPRINT
 @set DARKCORNER @inmargin{@image{lflashlight,1cm}, @image{rflashlight,1cm}}
-@end ifclear
-@ifset SMALLPRINT
-@set DARKCORNER @inmargin{@image{lflashlight,0.7cm}, @image{rflashlight,0.7cm}}
-@end ifset
 @set COMMONEXT (e.c.)
 @set PAGE pagina
 @end iftex
@@ -480,26 +475,12 @@ URL: @uref{http://www.pluto.it/ildp}@*
 @w{ }
 @sp 9
 
-@ifclear SMALLPRINT
 @center @i{Ai miei genitori, per il loro amore, e per lo splendido esempio che 
mi hanno dato.}
 @sp 1
 @center @i{A mia moglie, Miriam, per avermi reso completo.
 Grazie per aver costruito la tua vita insieme a me.}
 @sp 1
 @center @i{Ai nostri figli, Chana, Rivka, Nachum e Malka, per aver arricchito 
le nostre vite in misura incalcolabile.}
-@end ifclear
-
-@ifset SMALLPRINT
-@center @i{Ai miei genitori, per il loro amore,}
-@center @i{ e per lo splendido esempio che mi hanno dato.}
-@sp 1
-@center @i{A mia moglie, Miriam, per avermi reso completo.} @*
-@center @i{ Grazie per aver costruito la tua vita insieme a me.}
-@sp 1
-@center @i{Ai nostri figli, Chana, Rivka, Nachum e Malka,}
-@center @i{per aver arricchito le nostre vite in misura incalcolabile.}
-@end ifset
-
 @sp 1
 @w{ }
 @page
@@ -1308,17 +1289,9 @@ Ai nostri figli Chana, Rivka, Nachum e Malka,
 per aver arricchito le nostre vite in misura incalcolabile.
 @end ifinfo
 
-@ifset SMALLPRINT
-@fonttextsize 10
-@end ifset
-
 @summarycontents
 @contents
 
-@ifset SMALLPRINT
-@fonttextsize 11
-@end ifset
-
 @node Introduzione3
 @unnumbered Introduzione alla Terza Edizione
 
@@ -18509,12 +18482,7 @@ concettualmente, se i valori degli elementi sono 8, 
@code{"pippo"},
 @ifnotdocbook
 @float Figura,vettore-elementi
 @caption{Un vettore contiguo}
-@ifset SMALLPRINT
-@center @image{gawk-vettore-elementi, 11cm, , Un vettore contiguo}
-@end ifset
-@ifclear SMALLPRINT
 @center @image{gawk-vettore-elementi, , , Un vettore contiguo}
-@end ifclear
 @end float
 @end ifnotdocbook
 
@@ -39222,13 +39190,7 @@ Questo si pu@`o vedere in @inlineraw{docbook, <xref 
linkend="figura-carica-esten
 @ifnotdocbook
 @float Figura,figura-carica-estensione
 @caption{Caricamento dell'estensione}
-@ifclear SMALLPRINT
 @center @image{gawk-api-figura1, , , Caricamento dell'estensione}
-@end ifclear
-@ifset SMALLPRINT
-@center @image{gawk-api-figura1, 11cm, , Caricamento dell'estensione}
-@end ifset
-
 @end float
 @end ifnotdocbook
 
@@ -39263,12 +39225,7 @@ Questo @`e shown in @inlineraw{docbook, <xref 
linkend="figura-registrare-una-nuo
 @ifnotdocbook
 @float Figura,figura-registrare-una-nuova-funzione
 @caption{Registrare una nuova funzione}
-@ifclear SMALLPRINT
 @center @image{gawk-api-figura2, , , Registrare una nuova funzione}
-@end ifclear
-@ifset SMALLPRINT
-@center @image{gawk-api-figura2, 11cm , , Registrare una nuova funzione}
-@end ifset
 @end float
 @end ifnotdocbook
 
@@ -39303,12 +39260,7 @@ Questo @`e mostrato in @inlineraw{docbook, <xref 
linkend="figura-chiamata-nuova-
 @ifnotdocbook
 @float Figura,figura-chiamata-nuova-funzione
 @caption{Chiamata della nuova funzione}
-@ifclear SMALLPRINT
 @center @image{gawk-api-figura3, , , Chiamata della nuova funzione}
-@end ifclear
-@ifset SMALLPRINT
-@center @image{gawk-api-figura3,11cm , , Chiamata della nuova funzione}
-@end ifset
 @end float
 @end ifnotdocbook
 
@@ -41186,12 +41138,15 @@ in
 @multitable @columnfractions .50 .50
 @headitem @tab Tipo di valore reale
 @end multitable
+@ignore
+@c 12/2023: Texinfo.tex has morphed enough that this produces
+@c bad output, so comment it out.
 @c 10/2014: Thanks to Karl Berry for this bit to reduce the space:
 @tex
 \vglue-1.1\baselineskip
 @end tex
+@end ignore
 @c @multitable @columnfractions .166 .166 .198 .15 .15 .166
-@ifclear SMALLPRINT
 @multitable {Richiesto} {Indefinito} {Numero} {Numero} {Scalare} {Regexp} 
{Numero} {Vettore} {Indefinito}
 @headitem @tab @tab Stringa @tab Strnum @tab Numero @tab Regexp @tab Booleano 
@tab Vettore @tab Indefinito
 @item @tab @b{Stringa} @tab Stringa @tab Stringa @tab Stringa @tab Stringa 
@tab Stringa @tab false @tab false
@@ -41204,24 +41159,6 @@ in
 @item @tab @b{Indefinito} @tab Stringa @tab Strnum @tab Numero @tab Regexp 
@tab Booleano @tab Vettore @tab Indefinito
 @item @tab @b{@dfn{Value cookie}} @tab false @tab false @tab false @tab false 
@tab false @tab false
 @end multitable
-@end ifclear
-
-@ifset SMALLPRINT
-@smallformat
-@multitable {Rich.} {Indef.} {Num.} {Num.} {Scal.} {Regex.} {Num.} {Vett.} 
{Indef.}
-@headitem @tab @tab Str. @tab Strn. @tab Num. @tab Regex. @tab Bool. @tab 
Vett. @tab Indef.
-@item @tab @b{Str.} @tab Str. @tab Str. @tab Str. @tab Str. @tab Str. @tab 
false @tab false
-@item @tab @b{Strn.} @tab false @tab Strn. @tab Strn. @tab false @tab false 
@tab false @tab false
-@item @tab @b{Num.} @tab Num. @tab Num. @tab Num. @tab false @tab Num. @tab 
false @tab false
-@item @b{Tipo} @tab @b{Regex.} @tab false @tab false @tab false @tab Regex. 
@tab Bool. @tab false @tab false
-@item @b{Rich.} @tab @b{Bool.} @tab false @tab false @tab false @tab false 
@tab Bool. @tab false @tab false
-@item @tab @b{Vett.} @tab false @tab false @tab false @tab false @tab false 
@tab Vett. @tab false
-@item @tab @b{Scal.} @tab Scal. @tab Scal. @tab Scal. @tab Scal. @tab Scal. 
@tab false @tab false
-@item @tab @b{Indef.} @tab Str. @tab Strn. @tab Num. @tab Regex. @tab Bool. 
@tab Vett. @tab Indef.
-@item @tab @b{@dfn{Val. coo.}} @tab false @tab false @tab false @tab false 
@tab false @tab false
-@end multitable
-@end smallformat
-@end ifset
 @end ifnotdocbook
 @end ifnotplaintext
 @ifplaintext
@@ -41254,6 +41191,38 @@ in
 @end ifplaintext
 @end float
 
+Ci sono alcune considerazioni di cui tener conto:
+
+@itemize @bullet
+@item
+Se si richiede il tipo @code{AWK_UNDEFINED}, la risposta @`e sempre
+@dfn{true}, insieme al tipo effettivamente riscontrato per la
+particolare variabile in questione.  Si pu@`o considerare questo
+caso come una specie di richiesta ``jolly''.
+
+@item
+Se si richiede il tipo @code{AWK_STRING}, @command{gawk} converte
+un valore scalare a una stringa, e questa @`e il valore restituito.
+
+@item
+Se si richiede il tipo @code{AWK_NUMBER}, @command{gawk} converte
+un valore scalare (tranne nel caso di una @dfn{regexp}, a un
+valore numerico, e questo @`e il valore restituito.
+
+La conversione fra numero e stringa nelle funzioni API corrisponde
+quindi al comportamento di @command{gawk} in un programma normale.
+
+@item
+Le funzioni API @emph{non} fanno distinzione fra il tipo
+@code{"undefined"} e il tipo @code{"unassigned"}, come restituiti
+dalla funzione @code{typeof()}
+(@pxref{Variabili di tipo dinamico in Gawk}).
+In entrambi i casi viene restituito @code{AWK_UNDEFINED}.
+@`E improbabile che questa differenza venga rimossa in futuro,
+perch@'e la documentazione e il codice sorgente sono gi@`a
+abbastanza complessi.
+@end itemize
+
 @node Accedere ai parametri
 @subsection Accedere ai parametri e aggiornarli
 
@@ -41267,13 +41236,13 @@ passati all'estensione. Esse sono:
 Riempie la struttura @code{awk_value_t} puntata da @code{risultato}
 con l'argomento numero @code{count}.  Restituisce @dfn{true} se il tipo
 dell'argomento corrisponde
-a quello specificato in @code{wanted}, e @dfn{false} in caso contrario.
+a quello specificato in @code{desiderato}, e @dfn{false} in caso contrario.
 In quest'ultimo caso,
 @code{risultato@w{->}val_type} indica il tipo effettivo dell'argomento
 (@pxref{table-value-types-returned}).  La numerazione degli argomenti parte
 da zero: il primo
 argomento @`e il numero zero, il secondo @`e il numero uno, e 
cos@`{@dotless{i}} via.
-@code{wanted} indica il tipo di valore atteso.
+@code{desiderato} indica il tipo di valore atteso.
 
 @item awk_bool_t set_argument(size_t count, awk_array_t array);
 Converte un parametro di tipo indefinito in un vettore; ci@`o permette la
@@ -41316,9 +41285,9 @@ Le funzioni sono le seguenti:
 Riempie la struttura @code{awk_value_t} puntata da @code{risultato}
 con il valore della variabile il cui nome @`e nella stringa @code{nome},
 che @`e una normale stringa di caratteri C.
-@code{wanted} indica il tipo di valore atteso.
+@code{desiderato} indica il tipo di valore atteso.
 La funzione restituisce @dfn{true} se il tipo effettivo della variabile @`e 
quello
-specificato in @code{wanted}, e @dfn{false} in caso contrario.
+specificato in @code{desiderato}, e @dfn{false} in caso contrario.
 In quest'ultimo caso, @code{risultato>val_type} indica il tipo effettivo
 della variabile
 (@pxref{table-value-types-returned}).
@@ -41758,8 +41727,8 @@ Restituisce @dfn{false} se si verifica un errore.
 @itemx @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ awk_value_t 
*risultato);
 Per il vettore rappresentato da @code{a_cookie}, restituisce in 
@code{*risultato}
 il valore dell'elemento il cui indice @`e @code{index}.
-@code{wanted} specifica il tipo di valore che si vuole ritrovare.
-Restituisce @dfn{false} se @code{wanted} non coincide con il tipo di dato o
+@code{desiderato} specifica il tipo di valore che si vuole ritrovare.
+Restituisce @dfn{false} se @code{desiderato} non coincide con il tipo di dato o
 se @code{index} non @`e nel vettore (@pxref{table-value-types-returned}).
 
 Il valore per @code{index} pu@`o essere numerico, nel qual caso @command{gawk}
@@ -48765,12 +48734,7 @@ Le persone che si occupano delle varie versioni di 
@command{gawk} sono:
 @cindex G., Daniel Richard
 @cindex Robbins @subentry Arnold
 @cindex Zaretskii, Eli
-@ifset SMALLPRINT
-@multitable {MS-Windows} {123456789012345678901234567890123456789001234567890}
-@end ifset
-@ifclear SMALLPRINT
 @multitable {MS-Windows con MinGW} 
{123456789012345678901234567890123456789001234567890}
-@end ifclear
 @item Unix e sistemi POSIX @tab Arnold Robbins, 
@EMAIL{arnold@@skeeve.com,arnold (chiocciola) skeeve (punto) com}
 
 @item MS-Windows con MinGW @tab Eli Zaretskii, @EMAIL{eliz@@gnu.org,eliz 
(chiocciola) gnu (punto) org}
@@ -50292,12 +50256,7 @@ Si veda la @inlineraw{docbook, <xref 
linkend="figura-generica-flusso"/>}.
 @ifnotdocbook
 @float Figura,figura-generica-flusso
 @caption{Flusso generico di un programma}
-@ifclear SMALLPRINT
 @center @image{gawk-programma-generico, , , Flusso generico di un programma}
-@end ifclear
-@ifset SMALLPRINT
-@center @image{gawk-programma-generico, 11cm, , Flusso generico di un 
programma}
-@end ifset
 @end float
 @end ifnotdocbook
 
@@ -50342,12 +50301,7 @@ come si vede nella @inlineraw{docbook, <xref 
linkend="figura-flusso-elaborazione
 @ifnotdocbook
 @float Figura,figura-flusso-elaborazione
 @caption{Fasi di un programma generico}
-@ifclear SMALLPRINT
 @center @image{gawk-flusso-elaborazione, , , Fasi di un programma generico}
-@end ifclear
-@ifset SMALLPRINT
-@center @image{gawk-flusso-elaborazione, 11cm , , Fasi di un programma 
generico}
-@end ifset
 @end float
 @end ifnotdocbook
 

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

Summary of changes:
 doc/it/ChangeLog |   4 ++
 doc/it/gawk.texi | 130 ++++++++++++++++++-------------------------------------
 2 files changed, 46 insertions(+), 88 deletions(-)


hooks/post-receive
-- 
gawk