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.texi6
-rw-r--r--doc/gawktexi.in6
-rw-r--r--doc/it/ChangeLog4
-rw-r--r--doc/it/gawktexi.in81
6 files changed, 124 insertions, 94 deletions
diff --git a/doc/ChangeLog b/doc/ChangeLog
index 761b4da8..3d0c232f 100644
--- a/doc/ChangeLog
+++ b/doc/ChangeLog
@@ -48,7 +48,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 405313a1..430c90f8 100644
--- a/doc/gawk.info
+++ b/doc/gawk.info
@@ -28960,10 +28960,6 @@ command line when compiling 'gawk' from scratch, including:
desirable, but it may bring you some slight performance
improvement.
-'--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'.
@@ -32902,8 +32898,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 42)
* -b option: Options. (line 69)
* -c option: Options. (line 82)
* -C option: Options. (line 89)
@@ -33607,8 +33601,6 @@ Index
(line 32)
* configuration option, --disable-nls: Additional Configuration Options.
(line 37)
-* configuration option, --with-whiny-user-strftime: Additional Configuration Options.
- (line 42)
* configuration options, gawk: Additional Configuration Options.
(line 6)
* constant regexps: Regexp Usage. (line 57)
@@ -36434,58 +36426,58 @@ Node: Unix Installation1162843
Node: Quick Installation1163525
Node: Shell Startup Files1165939
Node: Additional Configuration Options1167028
-Node: Configuration Philosophy1169017
-Node: Non-Unix Installation1171386
-Node: PC Installation1171846
-Node: PC Binary Installation1172684
-Node: PC Compiling1173119
-Node: PC Using1174236
-Node: Cygwin1177281
-Node: MSYS1178051
-Node: VMS Installation1178552
-Node: VMS Compilation1179343
-Ref: VMS Compilation-Footnote-11180572
-Node: VMS Dynamic Extensions1180630
-Node: VMS Installation Details1182315
-Node: VMS Running1184568
-Node: VMS GNV1188847
-Node: VMS Old Gawk1189582
-Node: Bugs1190053
-Node: Bug address1190716
-Node: Usenet1193508
-Node: Maintainers1194285
-Node: Other Versions1195546
-Node: Installation summary1202308
-Node: Notes1203510
-Node: Compatibility Mode1204375
-Node: Additions1205157
-Node: Accessing The Source1206082
-Node: Adding Code1207519
-Node: New Ports1213738
-Node: Derived Files1218226
-Ref: Derived Files-Footnote-11223872
-Ref: Derived Files-Footnote-21223907
-Ref: Derived Files-Footnote-31224505
-Node: Future Extensions1224619
-Node: Implementation Limitations1225277
-Node: Extension Design1226460
-Node: Old Extension Problems1227614
-Ref: Old Extension Problems-Footnote-11229132
-Node: Extension New Mechanism Goals1229189
-Ref: Extension New Mechanism Goals-Footnote-11232553
-Node: Extension Other Design Decisions1232742
-Node: Extension Future Growth1234855
-Node: Old Extension Mechanism1235691
-Node: Notes summary1237454
-Node: Basic Concepts1238636
-Node: Basic High Level1239317
-Ref: figure-general-flow1239599
-Ref: figure-process-flow1240284
-Ref: Basic High Level-Footnote-11243585
-Node: Basic Data Typing1243770
-Node: Glossary1247098
-Node: Copying1278934
-Node: GNU Free Documentation License1316473
-Node: Index1341591
+Node: Configuration Philosophy1168889
+Node: Non-Unix Installation1171258
+Node: PC Installation1171718
+Node: PC Binary Installation1172556
+Node: PC Compiling1172991
+Node: PC Using1174108
+Node: Cygwin1177153
+Node: MSYS1177923
+Node: VMS Installation1178424
+Node: VMS Compilation1179215
+Ref: VMS Compilation-Footnote-11180444
+Node: VMS Dynamic Extensions1180502
+Node: VMS Installation Details1182187
+Node: VMS Running1184440
+Node: VMS GNV1188719
+Node: VMS Old Gawk1189454
+Node: Bugs1189925
+Node: Bug address1190588
+Node: Usenet1193380
+Node: Maintainers1194157
+Node: Other Versions1195418
+Node: Installation summary1202180
+Node: Notes1203382
+Node: Compatibility Mode1204247
+Node: Additions1205029
+Node: Accessing The Source1205954
+Node: Adding Code1207391
+Node: New Ports1213610
+Node: Derived Files1218098
+Ref: Derived Files-Footnote-11223744
+Ref: Derived Files-Footnote-21223779
+Ref: Derived Files-Footnote-31224377
+Node: Future Extensions1224491
+Node: Implementation Limitations1225149
+Node: Extension Design1226332
+Node: Old Extension Problems1227486
+Ref: Old Extension Problems-Footnote-11229004
+Node: Extension New Mechanism Goals1229061
+Ref: Extension New Mechanism Goals-Footnote-11232425
+Node: Extension Other Design Decisions1232614
+Node: Extension Future Growth1234727
+Node: Old Extension Mechanism1235563
+Node: Notes summary1237326
+Node: Basic Concepts1238508
+Node: Basic High Level1239189
+Ref: figure-general-flow1239471
+Ref: figure-process-flow1240156
+Ref: Basic High Level-Footnote-11243457
+Node: Basic Data Typing1243642
+Node: Glossary1246970
+Node: Copying1278806
+Node: GNU Free Documentation License1316345
+Node: Index1341463

End Tag Table
diff --git a/doc/gawk.texi b/doc/gawk.texi
index 2a0653f8..e958fd18 100644
--- a/doc/gawk.texi
+++ b/doc/gawk.texi
@@ -39319,12 +39319,6 @@ MPFR support is not available.
Disable all message-translation facilities.
This is usually not desirable, but it may bring you some slight performance
improvement.
-
-@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 df9439df..33cc7d7c 100644
--- a/doc/gawktexi.in
+++ b/doc/gawktexi.in
@@ -38333,12 +38333,6 @@ MPFR support is not available.
Disable all message-translation facilities.
This is usually not desirable, but it may bring you some slight performance
improvement.
-
-@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-09 04:50:53 +0000