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 d73f9392..02cc0dd4 100644
--- a/doc/ChangeLog
+++ b/doc/ChangeLog
@@ -70,7 +70,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 e93b4d37..a60904e7 100644
--- a/doc/gawk.info
+++ b/doc/gawk.info
@@ -28971,10 +28971,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'.
@@ -32913,8 +32909,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)
@@ -33619,8 +33613,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)
@@ -36459,58 +36451,58 @@ Node: Unix Installation1163323
Node: Quick Installation1164005
Node: Shell Startup Files1166419
Node: Additional Configuration Options1167508
-Node: Configuration Philosophy1169497
-Node: Non-Unix Installation1171866
-Node: PC Installation1172326
-Node: PC Binary Installation1173164
-Node: PC Compiling1173599
-Node: PC Using1174716
-Node: Cygwin1177761
-Node: MSYS1178531
-Node: VMS Installation1179032
-Node: VMS Compilation1179823
-Ref: VMS Compilation-Footnote-11181052
-Node: VMS Dynamic Extensions1181110
-Node: VMS Installation Details1182795
-Node: VMS Running1185048
-Node: VMS GNV1189327
-Node: VMS Old Gawk1190062
-Node: Bugs1190533
-Node: Bug address1191196
-Node: Usenet1193988
-Node: Maintainers1194765
-Node: Other Versions1196026
-Node: Installation summary1202788
-Node: Notes1203990
-Node: Compatibility Mode1204855
-Node: Additions1205637
-Node: Accessing The Source1206562
-Node: Adding Code1207999
-Node: New Ports1214218
-Node: Derived Files1218706
-Ref: Derived Files-Footnote-11224352
-Ref: Derived Files-Footnote-21224387
-Ref: Derived Files-Footnote-31224985
-Node: Future Extensions1225099
-Node: Implementation Limitations1225757
-Node: Extension Design1226940
-Node: Old Extension Problems1228094
-Ref: Old Extension Problems-Footnote-11229612
-Node: Extension New Mechanism Goals1229669
-Ref: Extension New Mechanism Goals-Footnote-11233033
-Node: Extension Other Design Decisions1233222
-Node: Extension Future Growth1235335
-Node: Old Extension Mechanism1236171
-Node: Notes summary1237934
-Node: Basic Concepts1239116
-Node: Basic High Level1239797
-Ref: figure-general-flow1240079
-Ref: figure-process-flow1240764
-Ref: Basic High Level-Footnote-11244065
-Node: Basic Data Typing1244250
-Node: Glossary1247578
-Node: Copying1279416
-Node: GNU Free Documentation License1316955
-Node: Index1342073
+Node: Configuration Philosophy1169369
+Node: Non-Unix Installation1171738
+Node: PC Installation1172198
+Node: PC Binary Installation1173036
+Node: PC Compiling1173471
+Node: PC Using1174588
+Node: Cygwin1177633
+Node: MSYS1178403
+Node: VMS Installation1178904
+Node: VMS Compilation1179695
+Ref: VMS Compilation-Footnote-11180924
+Node: VMS Dynamic Extensions1180982
+Node: VMS Installation Details1182667
+Node: VMS Running1184920
+Node: VMS GNV1189199
+Node: VMS Old Gawk1189934
+Node: Bugs1190405
+Node: Bug address1191068
+Node: Usenet1193860
+Node: Maintainers1194637
+Node: Other Versions1195898
+Node: Installation summary1202660
+Node: Notes1203862
+Node: Compatibility Mode1204727
+Node: Additions1205509
+Node: Accessing The Source1206434
+Node: Adding Code1207871
+Node: New Ports1214090
+Node: Derived Files1218578
+Ref: Derived Files-Footnote-11224224
+Ref: Derived Files-Footnote-21224259
+Ref: Derived Files-Footnote-31224857
+Node: Future Extensions1224971
+Node: Implementation Limitations1225629
+Node: Extension Design1226812
+Node: Old Extension Problems1227966
+Ref: Old Extension Problems-Footnote-11229484
+Node: Extension New Mechanism Goals1229541
+Ref: Extension New Mechanism Goals-Footnote-11232905
+Node: Extension Other Design Decisions1233094
+Node: Extension Future Growth1235207
+Node: Old Extension Mechanism1236043
+Node: Notes summary1237806
+Node: Basic Concepts1238988
+Node: Basic High Level1239669
+Ref: figure-general-flow1239951
+Ref: figure-process-flow1240636
+Ref: Basic High Level-Footnote-11243937
+Node: Basic Data Typing1244122
+Node: Glossary1247450
+Node: Copying1279288
+Node: GNU Free Documentation License1316827
+Node: Index1341945

End Tag Table
diff --git a/doc/gawk.texi b/doc/gawk.texi
index 781f157e..dec51695 100644
--- a/doc/gawk.texi
+++ b/doc/gawk.texi
@@ -39551,12 +39551,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 7596bd95..654fa3eb 100644
--- a/doc/gawktexi.in
+++ b/doc/gawktexi.in
@@ -38564,12 +38564,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-06 21:56:27 +0000