aboutsummaryrefslogtreecommitdiffstats
path: root/doc
diff options
context:
space:
mode:
Diffstat (limited to 'doc')
-rw-r--r--doc/ChangeLog7
-rw-r--r--doc/gawk.info114
-rw-r--r--doc/gawk.texi5
-rw-r--r--doc/gawktexi.in5
-rw-r--r--doc/it/ChangeLog4
-rw-r--r--doc/it/gawktexi.in81
6 files changed, 124 insertions, 92 deletions
diff --git a/doc/ChangeLog b/doc/ChangeLog
index 2db4ea38..a8f90b81 100644
--- a/doc/ChangeLog
+++ b/doc/ChangeLog
@@ -100,7 +100,12 @@
function to be syntactically and semantically correct. Thanks to
Jaromir Obr <jaromir.obr@gmail.com> for the report.
(POSIX String Comparison): Add some URL references in @ignore.
-
+
+ Unrelated:
+
+ * gawktexi.in: Remove description of --with-whiny-user-strftime
+ configuration option.
+
2017-10-08 Andrew J. Schorr <aschorr@telemetry-investments.com>
* gawktexi.in: Fix discussion of AWKPATH in section on @include.
diff --git a/doc/gawk.info b/doc/gawk.info
index 5f52e258..aafd94bf 100644
--- a/doc/gawk.info
+++ b/doc/gawk.info
@@ -29009,10 +29009,6 @@ command line when compiling 'gawk' from scratch, including:
possible to keep extensions for different API versions on the same
system without their conflicting with one another.
-'--with-whiny-user-strftime'
- Force use of the included version of the C 'strftime()' function
- for deficient systems.
-
Use the command './configure --help' to see the full list of options
supplied by 'configure'.
@@ -32953,8 +32949,6 @@ Index
* --traditional option, --posix option and: Options. (line 286)
* --use-lc-numeric option: Options. (line 232)
* --version option: Options. (line 318)
-* --with-whiny-user-strftime configuration option: Additional Configuration Options.
- (line 48)
* -b option: Options. (line 69)
* -c option: Options. (line 82)
* -C option: Options. (line 89)
@@ -33661,8 +33655,6 @@ Index
(line 37)
* configuration option, --enable-versioned-extension-dir: Additional Configuration Options.
(line 42)
-* configuration option, --with-whiny-user-strftime: Additional Configuration Options.
- (line 48)
* configuration options, gawk: Additional Configuration Options.
(line 6)
* constant regexps: Regexp Usage. (line 57)
@@ -36505,58 +36497,58 @@ Node: Unix Installation1164331
Node: Quick Installation1165013
Node: Shell Startup Files1167427
Node: Additional Configuration Options1168516
-Node: Configuration Philosophy1170809
-Node: Non-Unix Installation1173178
-Node: PC Installation1173638
-Node: PC Binary Installation1174476
-Node: PC Compiling1174911
-Node: PC Using1176028
-Node: Cygwin1179073
-Node: MSYS1179843
-Node: VMS Installation1180344
-Node: VMS Compilation1181135
-Ref: VMS Compilation-Footnote-11182364
-Node: VMS Dynamic Extensions1182422
-Node: VMS Installation Details1184107
-Node: VMS Running1186360
-Node: VMS GNV1190639
-Node: VMS Old Gawk1191374
-Node: Bugs1191845
-Node: Bug address1192508
-Node: Usenet1195300
-Node: Maintainers1196077
-Node: Other Versions1197338
-Node: Installation summary1204100
-Node: Notes1205302
-Node: Compatibility Mode1206167
-Node: Additions1206949
-Node: Accessing The Source1207874
-Node: Adding Code1209311
-Node: New Ports1215530
-Node: Derived Files1220018
-Ref: Derived Files-Footnote-11225664
-Ref: Derived Files-Footnote-21225699
-Ref: Derived Files-Footnote-31226297
-Node: Future Extensions1226411
-Node: Implementation Limitations1227069
-Node: Extension Design1228252
-Node: Old Extension Problems1229406
-Ref: Old Extension Problems-Footnote-11230924
-Node: Extension New Mechanism Goals1230981
-Ref: Extension New Mechanism Goals-Footnote-11234345
-Node: Extension Other Design Decisions1234534
-Node: Extension Future Growth1236647
-Node: Old Extension Mechanism1237483
-Node: Notes summary1239246
-Node: Basic Concepts1240428
-Node: Basic High Level1241109
-Ref: figure-general-flow1241391
-Ref: figure-process-flow1242076
-Ref: Basic High Level-Footnote-11245377
-Node: Basic Data Typing1245562
-Node: Glossary1248890
-Node: Copying1280728
-Node: GNU Free Documentation License1318267
-Node: Index1343385
+Node: Configuration Philosophy1170681
+Node: Non-Unix Installation1173050
+Node: PC Installation1173510
+Node: PC Binary Installation1174348
+Node: PC Compiling1174783
+Node: PC Using1175900
+Node: Cygwin1178945
+Node: MSYS1179715
+Node: VMS Installation1180216
+Node: VMS Compilation1181007
+Ref: VMS Compilation-Footnote-11182236
+Node: VMS Dynamic Extensions1182294
+Node: VMS Installation Details1183979
+Node: VMS Running1186232
+Node: VMS GNV1190511
+Node: VMS Old Gawk1191246
+Node: Bugs1191717
+Node: Bug address1192380
+Node: Usenet1195172
+Node: Maintainers1195949
+Node: Other Versions1197210
+Node: Installation summary1203972
+Node: Notes1205174
+Node: Compatibility Mode1206039
+Node: Additions1206821
+Node: Accessing The Source1207746
+Node: Adding Code1209183
+Node: New Ports1215402
+Node: Derived Files1219890
+Ref: Derived Files-Footnote-11225536
+Ref: Derived Files-Footnote-21225571
+Ref: Derived Files-Footnote-31226169
+Node: Future Extensions1226283
+Node: Implementation Limitations1226941
+Node: Extension Design1228124
+Node: Old Extension Problems1229278
+Ref: Old Extension Problems-Footnote-11230796
+Node: Extension New Mechanism Goals1230853
+Ref: Extension New Mechanism Goals-Footnote-11234217
+Node: Extension Other Design Decisions1234406
+Node: Extension Future Growth1236519
+Node: Old Extension Mechanism1237355
+Node: Notes summary1239118
+Node: Basic Concepts1240300
+Node: Basic High Level1240981
+Ref: figure-general-flow1241263
+Ref: figure-process-flow1241948
+Ref: Basic High Level-Footnote-11245249
+Node: Basic Data Typing1245434
+Node: Glossary1248762
+Node: Copying1280600
+Node: GNU Free Documentation License1318139
+Node: Index1343257

End Tag Table
diff --git a/doc/gawk.texi b/doc/gawk.texi
index 5eb20995..61b232ea 100644
--- a/doc/gawk.texi
+++ b/doc/gawk.texi
@@ -39610,11 +39610,6 @@ include the major and minor API versions in it. This makes it possible
to keep extensions for different API versions on the same system
without their conflicting with one another.
-@cindex @option{--with-whiny-user-strftime} configuration option
-@cindex configuration option, @code{--with-whiny-user-strftime}
-@item --with-whiny-user-strftime
-Force use of the included version of the C @code{strftime()}
-function for deficient systems.
@end table
Use the command @samp{./configure --help} to see the full list of
diff --git a/doc/gawktexi.in b/doc/gawktexi.in
index 17100b6b..6c4e3b29 100644
--- a/doc/gawktexi.in
+++ b/doc/gawktexi.in
@@ -38584,11 +38584,6 @@ include the major and minor API versions in it. This makes it possible
to keep extensions for different API versions on the same system
without their conflicting with one another.
-@cindex @option{--with-whiny-user-strftime} configuration option
-@cindex configuration option, @code{--with-whiny-user-strftime}
-@item --with-whiny-user-strftime
-Force use of the included version of the C @code{strftime()}
-function for deficient systems.
@end table
Use the command @samp{./configure --help} to see the full list of
diff --git a/doc/it/ChangeLog b/doc/it/ChangeLog
index d38f9860..7cfe6a07 100644
--- a/doc/it/ChangeLog
+++ b/doc/it/ChangeLog
@@ -2,6 +2,10 @@
* gawk.1: New file. (Italian translation of the man page.)
+2017-12-05 Antonio Giovanni Colombo <azc100@gmail.com>
+
+ * gawktexi.in: Italian translation updated.
+
2017-10-19 Arnold D. Robbins <arnold@skeeve.com>
* 4.2.0: Release tar ball made.
diff --git a/doc/it/gawktexi.in b/doc/it/gawktexi.in
index aa99d614..c3cd68f3 100644
--- a/doc/it/gawktexi.in
+++ b/doc/it/gawktexi.in
@@ -14916,8 +14916,8 @@ awk '
@end example
@noindent
-Questo programma stampa i primi tre campi di ogni record in input, mettendo
-un campo su ogni riga.
+Questo programma stampa i primi tre campi di ogni record in input,
+mettendo un unico campo in una riga in output.
Non @`e possibile impostare
pi@`u di una variabile nella parte di
@@ -33385,14 +33385,15 @@ La corrispondenza tra @code{ROUNDMODE} e le modalit@`a di arrotondamento IEEE
@item Arrotonda verso infinito @tab @code{roundTowardPositive} @tab @code{"U"} o @code{"u"}
@item Arrotonda verso meno infinito @tab @code{roundTowardNegative} @tab @code{"D"} o @code{"d"}
@item Arrotonda verso zero (troncamento) @tab @code{roundTowardZero} @tab @code{"Z"} o @code{"z"}
-@item Arrotonda al pi@`u vicino, o per eccesso @tab @code{roundTiesToAway} @tab @code{"A"} o @code{"a"}
+@item Arrotonda lontano da zero (per eccesso) @tab @tab @code{"A"} o @code{"a"}
@end multitable
@end float
@code{ROUNDMODE} ha @code{"N"} come valore di default, ovvero si usa la
modalit@`a di arrotondamento IEEE 754 @code{roundTiesToEven}.
In @ref{table-gawk-rounding-modes}, il valore @code{"A"} seleziona
-@code{roundTiesToAway}. Questo @`e applicabile solo se la versione in uso
+l'arrotondamento lontano da zero (per eccesso).
+Questo @`e applicabile solo se la versione in uso
della libreria MPFR lo supporta; altrimenti, l'impostazione di @code{ROUNDMODE}
ad @code{"A"} non ha alcun effetto.
@@ -33455,9 +33456,8 @@ intervalli, dove si adotta questa modalit@`a di arrotondamento per calcolare
i limiti superiore e inferiore per l'intervallo di valori in uscita.
La modalit@`a
@code{roundTowardZero} pu@`o essere usata per convertire numeri a virgola mobile
-in numeri interi. La modalit@`a di arrotondamento @code{roundTiesToAway}
-arrotonda il risultato al numero pi@`u vicino, e in caso di equidistanza
-arrotonda per eccesso.
+in numeri interi. Quando si arrotonda lontano da zero (per eccesso), viene
+scelto il numero pi@`u vicino di grandezza maggiore o uguale al valore.
Qualche esperto di analisi numerica dir@`a che la scelta dello stile di
arrotondamento ha un grandissimo impatto sul risultato finale, e consiglier@`a
@@ -34524,13 +34524,19 @@ e ogni campo @`e del tipo appropriato.
L'uso di queste macro rende pi@`u facile da seguire l'accesso ai campi di
@code{awk_value_t}.
+@item enum AWK_NUMBER_TYPE @{
+@itemx @ @ @ @ AWK_NUMBER_TYPE_DOUBLE,
+@itemx @ @ @ @ AWK_NUMBER_TYPE_MPFR,
+@itemx @ @ @ @ AWK_NUMBER_TYPE_MPZ
+@itemx @};
+La lista @code{enum} @`e usata nella struttura seguente per definire
+il tipo di valore numerico con cui si ha a che fare. Va dichiarata al
+livello pi@`u alto del file, in modo da poter essere usata sia con il
+linguaggio C++ che con il C.
+
@item typedef struct awk_number @{
@itemx @ @ @ @ double d;
-@itemx @ @ @ @ enum AWK_NUMBER_TYPE @{
-@itemx @ @ @ @ @ @ @ @ AWK_NUMBER_TYPE_DOUBLE,
-@itemx @ @ @ @ @ @ @ @ AWK_NUMBER_TYPE_MPFR,
-@itemx @ @ @ @ @ @ @ @ AWK_NUMBER_TYPE_MPZ
-@itemx @ @ @ @ @} type;
+@itemx @ @ @ @ enum AWK_NUMBER_TYPE type;
@itemx @ @ @ @ void *ptr;
@itemx @} awk_number_t;
Questo rappresenta un valore numerico. Internamente, @command{gawk}
@@ -34547,7 +34553,6 @@ da @code{ptr} sia un numero intero GMP (tipo @code{mpz_ptr}), o un numero
MPFR a virgola mobile (tipo @code{mpfr_ptr_t}), e trasformarlo a seconda
delle necessit@`a.
-
@item typedef void *awk_scalar_t;
La variabili scalari possono essere rappresentate da un tipo opaco. Questi
valori sono ottenuti da @command{gawk} e in seguito gli vengono restituiti.
@@ -37236,6 +37241,49 @@ compilazione, l'API rimane compatibile a livello di codice sorgente con la
precedente versione API. Le differenze pi@`u rilevanti sono gli ulteriori
campi nella struttura @code{awk_ext_func_t}, e l'aggiunta del terzo argomento
nella funzione di implementazione in linguaggio C.
+(@pxref{Funzioni di estensione}).
+
+Quella che segue @`e una lista di singole funzionalit@`a che sono
+state modificate nella versione 2 rispetto alla versione 1 dell'API:
+
+@itemize @bullet
+
+@item
+I valori numerici possono ora essere anche di tipo MPFR/MPZ
+(@pxref{Tipi di dati generali}).
+
+@item
+Ci sono nuovi tipi di stringa: @code{AWK_REGEX} e @code{AWK_STRNUM}
+(@pxref{Tipi di dati generali}).
+
+@item
+@`E disponibile la nuova macro @code{ezalloc()}
+(@pxref{Funzioni di allocazione memoria}).
+
+@item
+La struttura @code{awk_ext_func_t} @`e stata modificata. Invece del
+parametro @code{num_expected_args}, ha ora i due parametri
+@code{max_expected} e @code{min_required}
+(@pxref{Funzioni di estensione}).
+
+@item
+In @code{get_record()}, un analizzatore di input pu@`o ora specificare
+l'ampiezza dei campi
+(@pxref{Analizzatori di input}).
+
+@item
+Le estensioni possono ora inviare messaggi di errore non fatali
+(@pxref{Stampare messaggi}).
+
+@item
+Quando di appiattisce un vettore, si pu@`o ora specificare il tipo
+dell'indice e quello dei valori
+(@pxref{Funzioni per i vettori}).
+
+@item
+C'@`e una nuova API, @code{get_file()}
+(@pxref{Ridirezione API}).
+@end itemize
@node Trovare le estensioni
@section Come @command{gawk} trova le estensioni compilate
@@ -41603,13 +41651,6 @@ il supporto MPFR non sia disponibile.
Non attiva la traduzione automatica dei messaggi.
Ci@`o normalmente non @`e consigliabile, ma pu@`o apportare qualche lieve
miglioramento nei tempi di esecuzione di un programma.
-
-@cindex @option{--with-whiny-user-strftime}, opzione di configurazione
-@cindex opzione di configurazione @code{--with-whiny-user-strftime}
-@item --with-whiny-user-strftime
-Forza l'uso della versione della funzione C @code{strftime()} inclusa nella
-distribuzione di @command{gawk}, per i sistemi in cui la funzione stessa
-non sia disponibile.
@end table
Si usi il comando @samp{./configure --help} per ottenere la lista completa
generated by cgit v1.2.3 (git 2.25.1) at 2025-05-07 23:51:36 +0000