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 edba8f15..3bd0dd5c 100644
--- a/doc/ChangeLog
+++ b/doc/ChangeLog
@@ -83,7 +83,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 b0b732bb..66d2b9b3 100644
--- a/doc/gawk.info
+++ b/doc/gawk.info
@@ -28977,10 +28977,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'.
@@ -32921,8 +32917,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)
@@ -33629,8 +33623,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)
@@ -36469,58 +36461,58 @@ Node: Unix Installation1163323
Node: Quick Installation1164005
Node: Shell Startup Files1166419
Node: Additional Configuration Options1167508
-Node: Configuration Philosophy1169801
-Node: Non-Unix Installation1172170
-Node: PC Installation1172630
-Node: PC Binary Installation1173468
-Node: PC Compiling1173903
-Node: PC Using1175020
-Node: Cygwin1178065
-Node: MSYS1178835
-Node: VMS Installation1179336
-Node: VMS Compilation1180127
-Ref: VMS Compilation-Footnote-11181356
-Node: VMS Dynamic Extensions1181414
-Node: VMS Installation Details1183099
-Node: VMS Running1185352
-Node: VMS GNV1189631
-Node: VMS Old Gawk1190366
-Node: Bugs1190837
-Node: Bug address1191500
-Node: Usenet1194292
-Node: Maintainers1195069
-Node: Other Versions1196330
-Node: Installation summary1203092
-Node: Notes1204294
-Node: Compatibility Mode1205159
-Node: Additions1205941
-Node: Accessing The Source1206866
-Node: Adding Code1208303
-Node: New Ports1214522
-Node: Derived Files1219010
-Ref: Derived Files-Footnote-11224656
-Ref: Derived Files-Footnote-21224691
-Ref: Derived Files-Footnote-31225289
-Node: Future Extensions1225403
-Node: Implementation Limitations1226061
-Node: Extension Design1227244
-Node: Old Extension Problems1228398
-Ref: Old Extension Problems-Footnote-11229916
-Node: Extension New Mechanism Goals1229973
-Ref: Extension New Mechanism Goals-Footnote-11233337
-Node: Extension Other Design Decisions1233526
-Node: Extension Future Growth1235639
-Node: Old Extension Mechanism1236475
-Node: Notes summary1238238
-Node: Basic Concepts1239420
-Node: Basic High Level1240101
-Ref: figure-general-flow1240383
-Ref: figure-process-flow1241068
-Ref: Basic High Level-Footnote-11244369
-Node: Basic Data Typing1244554
-Node: Glossary1247882
-Node: Copying1279720
-Node: GNU Free Documentation License1317259
-Node: Index1342377
+Node: Configuration Philosophy1169673
+Node: Non-Unix Installation1172042
+Node: PC Installation1172502
+Node: PC Binary Installation1173340
+Node: PC Compiling1173775
+Node: PC Using1174892
+Node: Cygwin1177937
+Node: MSYS1178707
+Node: VMS Installation1179208
+Node: VMS Compilation1179999
+Ref: VMS Compilation-Footnote-11181228
+Node: VMS Dynamic Extensions1181286
+Node: VMS Installation Details1182971
+Node: VMS Running1185224
+Node: VMS GNV1189503
+Node: VMS Old Gawk1190238
+Node: Bugs1190709
+Node: Bug address1191372
+Node: Usenet1194164
+Node: Maintainers1194941
+Node: Other Versions1196202
+Node: Installation summary1202964
+Node: Notes1204166
+Node: Compatibility Mode1205031
+Node: Additions1205813
+Node: Accessing The Source1206738
+Node: Adding Code1208175
+Node: New Ports1214394
+Node: Derived Files1218882
+Ref: Derived Files-Footnote-11224528
+Ref: Derived Files-Footnote-21224563
+Ref: Derived Files-Footnote-31225161
+Node: Future Extensions1225275
+Node: Implementation Limitations1225933
+Node: Extension Design1227116
+Node: Old Extension Problems1228270
+Ref: Old Extension Problems-Footnote-11229788
+Node: Extension New Mechanism Goals1229845
+Ref: Extension New Mechanism Goals-Footnote-11233209
+Node: Extension Other Design Decisions1233398
+Node: Extension Future Growth1235511
+Node: Old Extension Mechanism1236347
+Node: Notes summary1238110
+Node: Basic Concepts1239292
+Node: Basic High Level1239973
+Ref: figure-general-flow1240255
+Ref: figure-process-flow1240940
+Ref: Basic High Level-Footnote-11244241
+Node: Basic Data Typing1244426
+Node: Glossary1247754
+Node: Copying1279592
+Node: GNU Free Documentation License1317131
+Node: Index1342249

End Tag Table
diff --git a/doc/gawk.texi b/doc/gawk.texi
index cc32cb84..bca4eb39 100644
--- a/doc/gawk.texi
+++ b/doc/gawk.texi
@@ -39560,11 +39560,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 20321ada..8ec07642 100644
--- a/doc/gawktexi.in
+++ b/doc/gawktexi.in
@@ -38573,11 +38573,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 09:59:14 +0000