[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[gawk-diffs] [SCM] gawk branch, master, updated. gawk-4.1.0-3701-gb4e4ba
|
From: |
Arnold Robbins |
|
Subject: |
[gawk-diffs] [SCM] gawk branch, master, updated. gawk-4.1.0-3701-gb4e4ba4 |
|
Date: |
Fri, 12 Apr 2019 05:36:25 -0400 (EDT) |
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, master has been updated
via b4e4ba4663f3be1dbecf0699eb702786fda5eca7 (commit)
via 784296f3a8bc7b156ce395b8426478d5cd13c4ec (commit)
via c207be6666450bb55132dc7045d12c9064dc395d (commit)
via e4370e3e9fea4b6a4821c7561c7fb1ea9711c052 (commit)
via 846375cf4aa711be438d5da3a0ac00ef6acbf836 (commit)
via 414addfde0ca368a19b65276a7ab9ec830df5865 (commit)
from 8339e748b99c7a630e9d731bcb0b270cc8627fae (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=b4e4ba4663f3be1dbecf0699eb702786fda5eca7
commit b4e4ba4663f3be1dbecf0699eb702786fda5eca7
Author: Arnold D. Robbins <address@hidden>
Date: Fri Apr 12 12:35:17 2019 +0300
Files revised after 'make distcheck'.
diff --git a/pc/config.h b/pc/config.h
index 9a243b2..5582041 100644
--- a/pc/config.h
+++ b/pc/config.h
@@ -458,7 +458,7 @@
#define PACKAGE_NAME "GNU Awk"
/* Define to the full name and version of this package. */
-#define PACKAGE_STRING "GNU Awk 4.2.65"
+#define PACKAGE_STRING "GNU Awk 5.0.0"
/* Define to the one symbol short name of this package. */
#define PACKAGE_TARNAME "gawk"
@@ -467,7 +467,7 @@
#define PACKAGE_URL "http://www.gnu.org/software/gawk/";
/* Define to the version of this package. */
-#define PACKAGE_VERSION "4.2.65"
+#define PACKAGE_VERSION "5.0.0"
/* Define to 1 if *printf supports %a format */
#define PRINTF_HAS_A_FORMAT 1
@@ -528,7 +528,7 @@
/* Version number of package */
-#define VERSION "4.2.65"
+#define VERSION "5.0.0"
/* Enable large inode numbers on Mac OS X 10.5. */
#ifndef _DARWIN_USE_64_BIT_INODE
diff --git a/po/ca.gmo b/po/ca.gmo
index 315be68..99af8ab 100644
Binary files a/po/ca.gmo and b/po/ca.gmo differ
diff --git a/po/ca.po b/po/ca.po
index 6bc98b6..f619d45 100644
--- a/po/ca.po
+++ b/po/ca.po
@@ -7,7 +7,7 @@ msgid ""
msgstr ""
"Project-Id-Version: gawk 4.1.3h\n"
"Report-Msgid-Bugs-To: address@hidden"
-"POT-Creation-Date: 2019-04-10 21:31+0300\n"
+"POT-Creation-Date: 2019-04-12 12:29+0300\n"
"PO-Revision-Date: 2016-12-18 19:51+0100\n"
"Last-Translator: Walter Garcia-Fontes <address@hidden>\n"
"Language-Team: Catalan <address@hidden>\n"
diff --git a/po/da.gmo b/po/da.gmo
index 0680992..83e2e5b 100644
Binary files a/po/da.gmo and b/po/da.gmo differ
diff --git a/po/da.po b/po/da.po
index 65b5289..2e46c72 100644
--- a/po/da.po
+++ b/po/da.po
@@ -10,7 +10,7 @@ msgid ""
msgstr ""
"Project-Id-Version: gawk 4.1.1d\n"
"Report-Msgid-Bugs-To: address@hidden"
-"POT-Creation-Date: 2019-04-10 21:31+0300\n"
+"POT-Creation-Date: 2019-04-12 12:29+0300\n"
"PO-Revision-Date: 2015-05-18 12:37+0200\n"
"Last-Translator: Keld Simonsen <address@hidden>\n"
"Language-Team: Danish <address@hidden>\n"
diff --git a/po/de.gmo b/po/de.gmo
index 56ab92a..1965810 100644
Binary files a/po/de.gmo and b/po/de.gmo differ
diff --git a/po/de.po b/po/de.po
index 5dd5ec5..edac4e4 100644
--- a/po/de.po
+++ b/po/de.po
@@ -8,7 +8,7 @@ msgid ""
msgstr ""
"Project-Id-Version: gawk 4.1.64\n"
"Report-Msgid-Bugs-To: address@hidden"
-"POT-Creation-Date: 2019-04-10 21:31+0300\n"
+"POT-Creation-Date: 2019-04-12 12:29+0300\n"
"PO-Revision-Date: 2017-09-18 09:08+0200\n"
"Last-Translator: Philipp Thomas <address@hidden>\n"
"Language-Team: German <address@hidden>\n"
diff --git a/po/es.gmo b/po/es.gmo
index 1d5a875..85ea996 100644
Binary files a/po/es.gmo and b/po/es.gmo differ
diff --git a/po/es.po b/po/es.po
index 8f93625..dacd44f 100644
--- a/po/es.po
+++ b/po/es.po
@@ -8,7 +8,7 @@ msgid ""
msgstr ""
"Project-Id-Version: gawk 4.2.0e\n"
"Report-Msgid-Bugs-To: address@hidden"
-"POT-Creation-Date: 2019-04-10 21:31+0300\n"
+"POT-Creation-Date: 2019-04-12 12:29+0300\n"
"PO-Revision-Date: 2018-03-24 17:48+0200\n"
"Last-Translator: Francisco Javier Serrador <address@hidden>\n"
"Language-Team: Spanish <address@hidden>\n"
diff --git a/po/fi.gmo b/po/fi.gmo
index 0653d63..7501fcf 100644
Binary files a/po/fi.gmo and b/po/fi.gmo differ
diff --git a/po/fi.po b/po/fi.po
index 186f1d0..9cf081c 100644
--- a/po/fi.po
+++ b/po/fi.po
@@ -7,7 +7,7 @@ msgid ""
msgstr ""
"Project-Id-Version: gawk 4.1.62\n"
"Report-Msgid-Bugs-To: address@hidden"
-"POT-Creation-Date: 2019-04-10 21:31+0300\n"
+"POT-Creation-Date: 2019-04-12 12:29+0300\n"
"PO-Revision-Date: 2017-08-19 12:18+0300\n"
"Last-Translator: Jorma Karvonen <address@hidden>\n"
"Language-Team: Finnish <address@hidden>\n"
diff --git a/po/fr.gmo b/po/fr.gmo
index d026628..01be141 100644
Binary files a/po/fr.gmo and b/po/fr.gmo differ
diff --git a/po/fr.po b/po/fr.po
index 8f78733..6b23ddc 100644
--- a/po/fr.po
+++ b/po/fr.po
@@ -9,7 +9,7 @@ msgid ""
msgstr ""
"Project-Id-Version: gawk 4.2.63\n"
"Report-Msgid-Bugs-To: address@hidden"
-"POT-Creation-Date: 2019-04-10 21:31+0300\n"
+"POT-Creation-Date: 2019-04-12 12:29+0300\n"
"PO-Revision-Date: 2019-03-02 23:58+0100\n"
"Last-Translator: Jean-Philippe Guérard <address@hidden"
"org>\n"
diff --git a/po/gawk.pot b/po/gawk.pot
index b5939b0..450ca75 100644
--- a/po/gawk.pot
+++ b/po/gawk.pot
@@ -6,9 +6,9 @@
#, fuzzy
msgid ""
msgstr ""
-"Project-Id-Version: gawk 4.2.65\n"
+"Project-Id-Version: gawk 5.0.0\n"
"Report-Msgid-Bugs-To: address@hidden"
-"POT-Creation-Date: 2019-04-10 21:31+0300\n"
+"POT-Creation-Date: 2019-04-12 12:29+0300\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <address@hidden>\n"
"Language-Team: LANGUAGE <address@hidden>\n"
diff --git a/po/id.gmo b/po/id.gmo
index a1205ea..1c0a395 100644
Binary files a/po/id.gmo and b/po/id.gmo differ
diff --git a/po/id.po b/po/id.po
index c07a347..bfc59eb 100644
--- a/po/id.po
+++ b/po/id.po
@@ -7,7 +7,7 @@ msgid ""
msgstr ""
"Project-Id-Version: gawk 4.1.0b\n"
"Report-Msgid-Bugs-To: address@hidden"
-"POT-Creation-Date: 2019-04-10 21:31+0300\n"
+"POT-Creation-Date: 2019-04-12 12:29+0300\n"
"PO-Revision-Date: 2014-08-03 07:30+0700\n"
"Last-Translator: Arif E. Nugroho <address@hidden>\n"
"Language-Team: Indonesian <address@hidden>\n"
diff --git a/po/it.gmo b/po/it.gmo
index 0b9001f..86e1e9b 100644
Binary files a/po/it.gmo and b/po/it.gmo differ
diff --git a/po/it.po b/po/it.po
index 5ff6fdd..bff2f80 100644
--- a/po/it.po
+++ b/po/it.po
@@ -6,7 +6,7 @@ msgid ""
msgstr ""
"Project-Id-Version: GNU Awk 4.2.2, API: 2.0\n"
"Report-Msgid-Bugs-To: address@hidden"
-"POT-Creation-Date: 2019-04-10 21:31+0300\n"
+"POT-Creation-Date: 2019-04-12 12:29+0300\n"
"PO-Revision-Date: 2019-02-17 20:00+0100\n"
"Last-Translator: Antonio Colombo <address@hidden>\n"
"Language-Team: Italian <address@hidden>\n"
diff --git a/po/ja.gmo b/po/ja.gmo
index 8828151..34dfa11 100644
Binary files a/po/ja.gmo and b/po/ja.gmo differ
diff --git a/po/ja.po b/po/ja.po
index a570ebe..6d23228 100644
--- a/po/ja.po
+++ b/po/ja.po
@@ -8,7 +8,7 @@ msgid ""
msgstr ""
"Project-Id-Version: gawk 4.1.0b\n"
"Report-Msgid-Bugs-To: address@hidden"
-"POT-Creation-Date: 2019-04-10 21:31+0300\n"
+"POT-Creation-Date: 2019-04-12 12:29+0300\n"
"PO-Revision-Date: 2014-11-07 12:26+0000\n"
"Last-Translator: Yasuaki Taniguchi <address@hidden>\n"
"Language-Team: Japanese <address@hidden>\n"
diff --git a/po/ko.gmo b/po/ko.gmo
index 4cb5f3b..84f22d9 100644
Binary files a/po/ko.gmo and b/po/ko.gmo differ
diff --git a/po/ko.po b/po/ko.po
index 29aedf0..c9f2604 100644
--- a/po/ko.po
+++ b/po/ko.po
@@ -7,7 +7,7 @@ msgid ""
msgstr ""
"Project-Id-Version: gawk 4.2.63\n"
"Report-Msgid-Bugs-To: address@hidden"
-"POT-Creation-Date: 2019-04-10 21:31+0300\n"
+"POT-Creation-Date: 2019-04-12 12:29+0300\n"
"PO-Revision-Date: 2019-03-04 16:44+0900\n"
"Last-Translator: Seong-ho Cho <address@hidden>\n"
"Language-Team: Korean <address@hidden>\n"
diff --git a/po/ms.gmo b/po/ms.gmo
index 1955f47..980363d 100644
Binary files a/po/ms.gmo and b/po/ms.gmo differ
diff --git a/po/ms.po b/po/ms.po
index b384864..2e2d6d8 100644
--- a/po/ms.po
+++ b/po/ms.po
@@ -7,7 +7,7 @@ msgid ""
msgstr ""
"Project-Id-Version: gawk 4.0.75\n"
"Report-Msgid-Bugs-To: address@hidden"
-"POT-Creation-Date: 2019-04-10 21:31+0300\n"
+"POT-Creation-Date: 2019-04-12 12:29+0300\n"
"PO-Revision-Date: 2013-04-19 10:45+0800\n"
"Last-Translator: Sharuzzaman Ahmat Raslan <address@hidden>\n"
"Language-Team: Malay <address@hidden>\n"
diff --git a/po/nl.gmo b/po/nl.gmo
index 71e099b..d8b5726 100644
Binary files a/po/nl.gmo and b/po/nl.gmo differ
diff --git a/po/nl.po b/po/nl.po
index 760b8a7..8a525fe 100644
--- a/po/nl.po
+++ b/po/nl.po
@@ -11,7 +11,7 @@ msgid ""
msgstr ""
"Project-Id-Version: gawk 4.2.63\n"
"Report-Msgid-Bugs-To: address@hidden"
-"POT-Creation-Date: 2019-04-10 21:31+0300\n"
+"POT-Creation-Date: 2019-04-12 12:29+0300\n"
"PO-Revision-Date: 2019-03-04 10:51+0100\n"
"Last-Translator: Benno Schulenberg <address@hidden>\n"
"Language-Team: Dutch <address@hidden>\n"
diff --git a/po/pl.gmo b/po/pl.gmo
index 3e20b66..47327b6 100644
Binary files a/po/pl.gmo and b/po/pl.gmo differ
diff --git a/po/pl.po b/po/pl.po
index 6970e17..cc443de 100644
--- a/po/pl.po
+++ b/po/pl.po
@@ -9,7 +9,7 @@ msgid ""
msgstr ""
"Project-Id-Version: gawk 4.1.0b\n"
"Report-Msgid-Bugs-To: address@hidden"
-"POT-Creation-Date: 2019-04-10 21:31+0300\n"
+"POT-Creation-Date: 2019-04-12 12:29+0300\n"
"PO-Revision-Date: 2014-03-22 17:49+0100\n"
"Last-Translator: Wojciech Polak <address@hidden>\n"
"Language-Team: Polish <address@hidden>\n"
diff --git a/po/pt_BR.gmo b/po/pt_BR.gmo
index 6614e96..dbf043d 100644
Binary files a/po/pt_BR.gmo and b/po/pt_BR.gmo differ
diff --git a/po/pt_BR.po b/po/pt_BR.po
index cfaf288..c0a5c03 100644
--- a/po/pt_BR.po
+++ b/po/pt_BR.po
@@ -8,7 +8,7 @@ msgid ""
msgstr ""
"Project-Id-Version: gawk 4.2.63\n"
"Report-Msgid-Bugs-To: address@hidden"
-"POT-Creation-Date: 2019-04-10 21:31+0300\n"
+"POT-Creation-Date: 2019-04-12 12:29+0300\n"
"PO-Revision-Date: 2019-03-07 08:07-0200\n"
"Last-Translator: Rafael Fontenelle <address@hidden>\n"
"Language-Team: Brazilian Portuguese <address@hidden"
diff --git a/po/sv.gmo b/po/sv.gmo
index a87af16..b3652a6 100644
Binary files a/po/sv.gmo and b/po/sv.gmo differ
diff --git a/po/sv.po b/po/sv.po
index b9e52ab..22b6bfb 100644
--- a/po/sv.po
+++ b/po/sv.po
@@ -11,7 +11,7 @@ msgid ""
msgstr ""
"Project-Id-Version: gawk 4.2.63\n"
"Report-Msgid-Bugs-To: address@hidden"
-"POT-Creation-Date: 2019-04-10 21:31+0300\n"
+"POT-Creation-Date: 2019-04-12 12:29+0300\n"
"PO-Revision-Date: 2019-03-09 21:06+0100\n"
"Last-Translator: Göran Uddeborg <address@hidden>\n"
"Language-Team: Swedish <address@hidden>\n"
diff --git a/po/vi.gmo b/po/vi.gmo
index 1b328c8..497d6ba 100644
Binary files a/po/vi.gmo and b/po/vi.gmo differ
diff --git a/po/vi.po b/po/vi.po
index 9cbedb2..c259cbe 100644
--- a/po/vi.po
+++ b/po/vi.po
@@ -9,7 +9,7 @@ msgid ""
msgstr ""
"Project-Id-Version: gawk 4.2.0e\n"
"Report-Msgid-Bugs-To: address@hidden"
-"POT-Creation-Date: 2019-04-10 21:31+0300\n"
+"POT-Creation-Date: 2019-04-12 12:29+0300\n"
"PO-Revision-Date: 2018-01-30 08:07+0700\n"
"Last-Translator: Trần Ngá»c Quân <address@hidden>\n"
"Language-Team: Vietnamese <address@hidden>\n"
diff --git a/po/zh_CN.gmo b/po/zh_CN.gmo
index 722dd8f..ef367a0 100644
Binary files a/po/zh_CN.gmo and b/po/zh_CN.gmo differ
diff --git a/po/zh_CN.po b/po/zh_CN.po
index 2345825..29acc92 100644
--- a/po/zh_CN.po
+++ b/po/zh_CN.po
@@ -10,7 +10,7 @@ msgid ""
msgstr ""
"Project-Id-Version: gawk 4.2.63\n"
"Report-Msgid-Bugs-To: address@hidden"
-"POT-Creation-Date: 2019-04-10 21:31+0300\n"
+"POT-Creation-Date: 2019-04-12 12:29+0300\n"
"PO-Revision-Date: 2019-03-19 17:46+0100\n"
"Last-Translator: Tianze Wang <address@hidden>\n"
"Language-Team: Chinese (simplified) <address@hidden>\n"
http://git.sv.gnu.org/cgit/gawk.git/commit/?id=784296f3a8bc7b156ce395b8426478d5cd13c4ec
commit 784296f3a8bc7b156ce395b8426478d5cd13c4ec
Author: Arnold D. Robbins <address@hidden>
Date: Fri Apr 12 12:34:46 2019 +0300
Add new ChangeLog files.
diff --git a/ChangeLog b/ChangeLog
new file mode 100644
index 0000000..8c92378
--- /dev/null
+++ b/ChangeLog
@@ -0,0 +1,8 @@
+2019-04-12 Arnold D. Robbins <address@hidden>
+
+ * configure.ac: Update version to 5.0.0.
+ * configure: Regenerated.
+ * ChangeLog.1: Rotated ChangeLog into this file.
+ * ChangeLog: Created anew for gawk 5.0.0 and on.
+ * README: Bump version to 5.0.0.
+ * 5.0.0: Release tar ball made.
diff --git a/README_d/ChangeLog b/README_d/ChangeLog
new file mode 100644
index 0000000..862c2b8
--- /dev/null
+++ b/README_d/ChangeLog
@@ -0,0 +1,5 @@
+2019-04-12 Arnold D. Robbins <address@hidden>
+
+ * ChangeLog.1: Rotated ChangeLog into this file.
+ * ChangeLog: Created anew for gawk 5.0.0 and on.
+ * 5.0.0: Release tar ball made.
diff --git a/awklib/ChangeLog b/awklib/ChangeLog
new file mode 100644
index 0000000..862c2b8
--- /dev/null
+++ b/awklib/ChangeLog
@@ -0,0 +1,5 @@
+2019-04-12 Arnold D. Robbins <address@hidden>
+
+ * ChangeLog.1: Rotated ChangeLog into this file.
+ * ChangeLog: Created anew for gawk 5.0.0 and on.
+ * 5.0.0: Release tar ball made.
diff --git a/doc/ChangeLog b/doc/ChangeLog
new file mode 100644
index 0000000..862c2b8
--- /dev/null
+++ b/doc/ChangeLog
@@ -0,0 +1,5 @@
+2019-04-12 Arnold D. Robbins <address@hidden>
+
+ * ChangeLog.1: Rotated ChangeLog into this file.
+ * ChangeLog: Created anew for gawk 5.0.0 and on.
+ * 5.0.0: Release tar ball made.
diff --git a/extension/ChangeLog b/extension/ChangeLog
new file mode 100644
index 0000000..862c2b8
--- /dev/null
+++ b/extension/ChangeLog
@@ -0,0 +1,5 @@
+2019-04-12 Arnold D. Robbins <address@hidden>
+
+ * ChangeLog.1: Rotated ChangeLog into this file.
+ * ChangeLog: Created anew for gawk 5.0.0 and on.
+ * 5.0.0: Release tar ball made.
diff --git a/m4/ChangeLog b/m4/ChangeLog
new file mode 100644
index 0000000..862c2b8
--- /dev/null
+++ b/m4/ChangeLog
@@ -0,0 +1,5 @@
+2019-04-12 Arnold D. Robbins <address@hidden>
+
+ * ChangeLog.1: Rotated ChangeLog into this file.
+ * ChangeLog: Created anew for gawk 5.0.0 and on.
+ * 5.0.0: Release tar ball made.
diff --git a/missing_d/ChangeLog b/missing_d/ChangeLog
new file mode 100644
index 0000000..862c2b8
--- /dev/null
+++ b/missing_d/ChangeLog
@@ -0,0 +1,5 @@
+2019-04-12 Arnold D. Robbins <address@hidden>
+
+ * ChangeLog.1: Rotated ChangeLog into this file.
+ * ChangeLog: Created anew for gawk 5.0.0 and on.
+ * 5.0.0: Release tar ball made.
diff --git a/pc/ChangeLog b/pc/ChangeLog
new file mode 100644
index 0000000..862c2b8
--- /dev/null
+++ b/pc/ChangeLog
@@ -0,0 +1,5 @@
+2019-04-12 Arnold D. Robbins <address@hidden>
+
+ * ChangeLog.1: Rotated ChangeLog into this file.
+ * ChangeLog: Created anew for gawk 5.0.0 and on.
+ * 5.0.0: Release tar ball made.
diff --git a/po/ChangeLog b/po/ChangeLog
new file mode 100644
index 0000000..862c2b8
--- /dev/null
+++ b/po/ChangeLog
@@ -0,0 +1,5 @@
+2019-04-12 Arnold D. Robbins <address@hidden>
+
+ * ChangeLog.1: Rotated ChangeLog into this file.
+ * ChangeLog: Created anew for gawk 5.0.0 and on.
+ * 5.0.0: Release tar ball made.
diff --git a/posix/ChangeLog b/posix/ChangeLog
new file mode 100644
index 0000000..862c2b8
--- /dev/null
+++ b/posix/ChangeLog
@@ -0,0 +1,5 @@
+2019-04-12 Arnold D. Robbins <address@hidden>
+
+ * ChangeLog.1: Rotated ChangeLog into this file.
+ * ChangeLog: Created anew for gawk 5.0.0 and on.
+ * 5.0.0: Release tar ball made.
diff --git a/support/ChangeLog b/support/ChangeLog
new file mode 100644
index 0000000..55af128
--- /dev/null
+++ b/support/ChangeLog
@@ -0,0 +1,5 @@
+2019-04-12 Arnold D. Robbins <address@hidden>
+
+ * ChangeLog.0: Rotated ChangeLog into this file.
+ * ChangeLog: Created anew for gawk 5.0.0 and on.
+ * 5.0.0: Release tar ball made.
diff --git a/test/ChangeLog b/test/ChangeLog
new file mode 100644
index 0000000..862c2b8
--- /dev/null
+++ b/test/ChangeLog
@@ -0,0 +1,5 @@
+2019-04-12 Arnold D. Robbins <address@hidden>
+
+ * ChangeLog.1: Rotated ChangeLog into this file.
+ * ChangeLog: Created anew for gawk 5.0.0 and on.
+ * 5.0.0: Release tar ball made.
diff --git a/vms/ChangeLog b/vms/ChangeLog
new file mode 100644
index 0000000..862c2b8
--- /dev/null
+++ b/vms/ChangeLog
@@ -0,0 +1,5 @@
+2019-04-12 Arnold D. Robbins <address@hidden>
+
+ * ChangeLog.1: Rotated ChangeLog into this file.
+ * ChangeLog: Created anew for gawk 5.0.0 and on.
+ * 5.0.0: Release tar ball made.
http://git.sv.gnu.org/cgit/gawk.git/commit/?id=c207be6666450bb55132dc7045d12c9064dc395d
commit c207be6666450bb55132dc7045d12c9064dc395d
Author: Arnold D. Robbins <address@hidden>
Date: Fri Apr 12 12:29:08 2019 +0300
Bump version in configure.ac files and README.
diff --git a/README b/README
index 9696fb3..73f0e0d 100644
--- a/README
+++ b/README
@@ -1,5 +1,5 @@
Copyright (C) 2005, 2006, 2007, 2009, 2010, 2011, 2012, 2013, 2014, 2015,
- 2016, 2017 Free Software Foundation, Inc.
+ 2016, 2017, 2018, 2019 Free Software Foundation, Inc.
Copying and distribution of this file, with or without modification,
are permitted in any medium without royalty provided the copyright
@@ -7,11 +7,11 @@
README:
-This is GNU Awk 4.2.1. It is upwardly compatible with Brian Kernighan's
+This is GNU Awk 5.0.0. It is upwardly compatible with Brian Kernighan's
version of Unix awk. It is almost completely compliant with the
-2008 POSIX 1003.1 standard for awk. (See the note below about POSIX.)
+2018 POSIX 1003.1 standard for awk. (See the note below about POSIX.)
-This is a bug-fix release. See NEWS and ChangeLog for details.
+This is a major release. See NEWS and ChangeLog for details.
Work to be done is described briefly in the TODO file, which is available
only in the 'master' branch in the Git repo.
@@ -23,8 +23,8 @@ says one thing but gawk does something different.
To format the documentation with TeX, use at least version 2017-09.16
of texinfo.tex. There is a usable copy of texinfo.tex in the doc directory.
-You should also use at least version 6.1 of texindex and of makeinfo
-from the texinfo-6.1 distribution.
+You should also use at least version 6.5 of texindex and of makeinfo
+from the texinfo-6.5 distribution.
INSTALLATION:
@@ -72,8 +72,9 @@ BUG REPORTS AND FIXES (Un*x systems):
Please coordinate changes through Arnold Robbins. In particular, see
the section in the manual on reporting bugs. Note that comp.lang.awk
-is about the worst place to post a gawk bug report. Please, use the
-mechanisms outlined in the manual.
+is about the worst place to post a gawk bug report. So too is use of
+a web forum such as Stack Overflow. Please, use the mechanisms outlined
+in the manual.
Email should be sent to address@hidden This is a separate mailing
list at GNU Central. The advantage to using this address is that bug
@@ -102,7 +103,3 @@ VMS:
z/OS (OS/390) Contact:
Daniel Richard G.
address@hidden
-
-z/OS (OS/390) Maintainer Emeritus:
- Dave Pitts
- address@hidden
diff --git a/configure b/configure
index 01f92de..b2b728b 100755
--- a/configure
+++ b/configure
@@ -1,6 +1,6 @@
#! /bin/sh
# Guess values for system-dependent variables and create Makefiles.
-# Generated by GNU Autoconf 2.69 for GNU Awk 4.2.65.
+# Generated by GNU Autoconf 2.69 for GNU Awk 5.0.0.
#
# Report bugs to <address@hidden>.
#
@@ -580,8 +580,8 @@ MAKEFLAGS=
# Identity of this package.
PACKAGE_NAME='GNU Awk'
PACKAGE_TARNAME='gawk'
-PACKAGE_VERSION='4.2.65'
-PACKAGE_STRING='GNU Awk 4.2.65'
+PACKAGE_VERSION='5.0.0'
+PACKAGE_STRING='GNU Awk 5.0.0'
PACKAGE_BUGREPORT='address@hidden'
PACKAGE_URL='http://www.gnu.org/software/gawk/'
@@ -1331,7 +1331,7 @@ if test "$ac_init_help" = "long"; then
# Omit some internal or obsolete options to make the list less imposing.
# This message is too long to be a string in the A/UX 3.1 sh.
cat <<_ACEOF
-\`configure' configures GNU Awk 4.2.65 to adapt to many kinds of systems.
+\`configure' configures GNU Awk 5.0.0 to adapt to many kinds of systems.
Usage: $0 [OPTION]... [VAR=VALUE]...
@@ -1401,7 +1401,7 @@ fi
if test -n "$ac_init_help"; then
case $ac_init_help in
- short | recursive ) echo "Configuration of GNU Awk 4.2.65:";;
+ short | recursive ) echo "Configuration of GNU Awk 5.0.0:";;
esac
cat <<\_ACEOF
@@ -1523,7 +1523,7 @@ fi
test -n "$ac_init_help" && exit $ac_status
if $ac_init_version; then
cat <<\_ACEOF
-GNU Awk configure 4.2.65
+GNU Awk configure 5.0.0
generated by GNU Autoconf 2.69
Copyright (C) 2012 Free Software Foundation, Inc.
@@ -2232,7 +2232,7 @@ cat >config.log <<_ACEOF
This file contains any messages produced by compilers while
running configure, to aid debugging if configure makes a mistake.
-It was created by GNU Awk $as_me 4.2.65, which was
+It was created by GNU Awk $as_me 5.0.0, which was
generated by GNU Autoconf 2.69. Invocation command line was
$ $0 $@
@@ -3115,7 +3115,7 @@ fi
# Define the identity of the package.
PACKAGE='gawk'
- VERSION='4.2.65'
+ VERSION='5.0.0'
cat >>confdefs.h <<_ACEOF
@@ -11606,7 +11606,7 @@ cat >>$CONFIG_STATUS <<\_ACEOF || ac_write_fail=1
# report actual input values of CONFIG_FILES etc. instead of their
# values after options handling.
ac_log="
-This file was extended by GNU Awk $as_me 4.2.65, which was
+This file was extended by GNU Awk $as_me 5.0.0, which was
generated by GNU Autoconf 2.69. Invocation command line was
CONFIG_FILES = $CONFIG_FILES
@@ -11674,7 +11674,7 @@ _ACEOF
cat >>$CONFIG_STATUS <<_ACEOF || ac_write_fail=1
ac_cs_config="`$as_echo "$ac_configure_args" | sed 's/^ //;
s/[\\""\`\$]/\\\\&/g'`"
ac_cs_version="\\
-GNU Awk config.status 4.2.65
+GNU Awk config.status 5.0.0
configured by $0, generated by GNU Autoconf 2.69,
with options \\"\$ac_cs_config\\"
diff --git a/configure.ac b/configure.ac
index ffab8e5..58e57c5 100644
--- a/configure.ac
+++ b/configure.ac
@@ -23,7 +23,7 @@ dnl
dnl Process this file with autoconf to produce a configure script.
-AC_INIT([GNU Awk],[4.2.65],address@hidden,[gawk])
+AC_INIT([GNU Awk],[5.0.0],address@hidden,[gawk])
# This is a hack. Different versions of install on different systems
# are just too different. Chuck it and use install-sh.
diff --git a/extension/configure b/extension/configure
index 5759ddc..297f24d 100755
--- a/extension/configure
+++ b/extension/configure
@@ -1,6 +1,6 @@
#! /bin/sh
# Guess values for system-dependent variables and create Makefiles.
-# Generated by GNU Autoconf 2.69 for GNU Awk Bundled Extensions 4.2.1.
+# Generated by GNU Autoconf 2.69 for GNU Awk Bundled Extensions 5.0.0.
#
# Report bugs to <address@hidden>.
#
@@ -590,8 +590,8 @@ MAKEFLAGS=
# Identity of this package.
PACKAGE_NAME='GNU Awk Bundled Extensions'
PACKAGE_TARNAME='gawk-extensions'
-PACKAGE_VERSION='4.2.1'
-PACKAGE_STRING='GNU Awk Bundled Extensions 4.2.1'
+PACKAGE_VERSION='5.0.0'
+PACKAGE_STRING='GNU Awk Bundled Extensions 5.0.0'
PACKAGE_BUGREPORT='address@hidden'
PACKAGE_URL='http://www.gnu.org/software/gawk-extensions/'
@@ -1339,7 +1339,7 @@ if test "$ac_init_help" = "long"; then
# Omit some internal or obsolete options to make the list less imposing.
# This message is too long to be a string in the A/UX 3.1 sh.
cat <<_ACEOF
-\`configure' configures GNU Awk Bundled Extensions 4.2.1 to adapt to many
kinds of systems.
+\`configure' configures GNU Awk Bundled Extensions 5.0.0 to adapt to many
kinds of systems.
Usage: $0 [OPTION]... [VAR=VALUE]...
@@ -1409,7 +1409,7 @@ fi
if test -n "$ac_init_help"; then
case $ac_init_help in
- short | recursive ) echo "Configuration of GNU Awk Bundled Extensions
4.2.1:";;
+ short | recursive ) echo "Configuration of GNU Awk Bundled Extensions
5.0.0:";;
esac
cat <<\_ACEOF
@@ -1531,7 +1531,7 @@ fi
test -n "$ac_init_help" && exit $ac_status
if $ac_init_version; then
cat <<\_ACEOF
-GNU Awk Bundled Extensions configure 4.2.1
+GNU Awk Bundled Extensions configure 5.0.0
generated by GNU Autoconf 2.69
Copyright (C) 2012 Free Software Foundation, Inc.
@@ -2003,7 +2003,7 @@ cat >config.log <<_ACEOF
This file contains any messages produced by compilers while
running configure, to aid debugging if configure makes a mistake.
-It was created by GNU Awk Bundled Extensions $as_me 4.2.1, which was
+It was created by GNU Awk Bundled Extensions $as_me 5.0.0, which was
generated by GNU Autoconf 2.69. Invocation command line was
$ $0 $@
@@ -2872,7 +2872,7 @@ fi
# Define the identity of the package.
PACKAGE='gawk-extensions'
- VERSION='4.2.1'
+ VERSION='5.0.0'
cat >>confdefs.h <<_ACEOF
@@ -15943,7 +15943,7 @@ cat >>$CONFIG_STATUS <<\_ACEOF || ac_write_fail=1
# report actual input values of CONFIG_FILES etc. instead of their
# values after options handling.
ac_log="
-This file was extended by GNU Awk Bundled Extensions $as_me 4.2.1, which was
+This file was extended by GNU Awk Bundled Extensions $as_me 5.0.0, which was
generated by GNU Autoconf 2.69. Invocation command line was
CONFIG_FILES = $CONFIG_FILES
@@ -16011,7 +16011,7 @@ _ACEOF
cat >>$CONFIG_STATUS <<_ACEOF || ac_write_fail=1
ac_cs_config="`$as_echo "$ac_configure_args" | sed 's/^ //;
s/[\\""\`\$]/\\\\&/g'`"
ac_cs_version="\\
-GNU Awk Bundled Extensions config.status 4.2.1
+GNU Awk Bundled Extensions config.status 5.0.0
configured by $0, generated by GNU Autoconf 2.69,
with options \\"\$ac_cs_config\\"
diff --git a/extension/configure.ac b/extension/configure.ac
index 39399ac..f6ec3ce 100644
--- a/extension/configure.ac
+++ b/extension/configure.ac
@@ -23,7 +23,7 @@ dnl
dnl Process this file with autoconf to produce a configure script.
-AC_INIT([GNU Awk Bundled Extensions],[4.2.1],address@hidden,[gawk-extensions])
+AC_INIT([GNU Awk Bundled Extensions],[5.0.0],address@hidden,[gawk-extensions])
AC_PREREQ([2.69])
http://git.sv.gnu.org/cgit/gawk.git/commit/?id=e4370e3e9fea4b6a4821c7561c7fb1ea9711c052
commit e4370e3e9fea4b6a4821c7561c7fb1ea9711c052
Author: Arnold D. Robbins <address@hidden>
Date: Fri Apr 12 12:28:36 2019 +0300
Renamed old ChangeLog files, added new ones for 5.0 release.
diff --git a/ChangeLog.1 b/ChangeLog.1
index 172b902..aa8226e 100755
--- a/ChangeLog.1
+++ b/ChangeLog.1
@@ -1,3 +1,7 @@
+2019-04-12 Arnold D. Robbins <address@hidden>
+
+ * README: Updated in preparation for a release.
+
2019-04-07 Arnold D. Robbins <address@hidden>
* config.sub: Updated from GNULIB.
diff --git a/cmake/ChangeLog b/cmake/ChangeLog
index 8437a28..745b834 100644
--- a/cmake/ChangeLog
+++ b/cmake/ChangeLog
@@ -1,3 +1,7 @@
+2019-04-12 Arnold D. Robbins <address@hidden>
+
+ * 5.0.0: Release tar ball made.
+
2018-02-25 Arnold D. Robbins <address@hidden>
* 4.2.1: Release tar ball made.
diff --git a/extension/build-aux/ChangeLog b/extension/build-aux/ChangeLog
index b596877..98cda49 100644
--- a/extension/build-aux/ChangeLog
+++ b/extension/build-aux/ChangeLog
@@ -1,3 +1,7 @@
+2019-04-12 Arnold D. Robbins <address@hidden>
+
+ * 5.0.0: Release tar ball made.
+
2019-04-07 Arnold D. Robbins <address@hidden>
* config.sub: Updated from GNULIB.
diff --git a/extension/m4/ChangeLog b/extension/m4/ChangeLog
index 7ec4a7d..9386aa8 100644
--- a/extension/m4/ChangeLog
+++ b/extension/m4/ChangeLog
@@ -1,3 +1,7 @@
+2019-04-12 Arnold D. Robbins <address@hidden>
+
+ * 5.0.0: Release tar ball made.
+
2018-03-07 gettextize <address@hidden>
* gettext.m4: New file, from gettext-0.19.7.
diff --git a/extension/po/ChangeLog b/extension/po/ChangeLog
index c2eb8f7..2c93113 100644
--- a/extension/po/ChangeLog
+++ b/extension/po/ChangeLog
@@ -1,3 +1,7 @@
+2019-04-12 Arnold D. Robbins <address@hidden>
+
+ * 5.0.0: Release tar ball made.
+
2018-04-08 Arnold D. Robbins <address@hidden>
* .gitignore: New file.
diff --git a/extras/ChangeLog b/extras/ChangeLog
index ac11537..87d5932 100644
--- a/extras/ChangeLog
+++ b/extras/ChangeLog
@@ -1,3 +1,7 @@
+2019-04-12 Arnold D. Robbins <address@hidden>
+
+ * 5.0.0: Release tar ball made.
+
2018-09-16 Arnold D. Robbins <address@hidden>
* Makefile.in: Regenerated, using Automake 1.16.1.
diff --git a/helpers/ChangeLog b/helpers/ChangeLog
index d54de86..29f3971 100644
--- a/helpers/ChangeLog
+++ b/helpers/ChangeLog
@@ -1,3 +1,7 @@
+2019-04-12 Arnold D. Robbins <address@hidden>
+
+ * 5.0.0: Release tar ball made.
+
2018-02-25 Arnold D. Robbins <address@hidden>
* 4.2.1: Release tar ball made.
diff --git a/old-extension/ChangeLog b/old-extension/ChangeLog
index 0e67c74..0cc99e4 100644
--- a/old-extension/ChangeLog
+++ b/old-extension/ChangeLog
@@ -1,3 +1,7 @@
+2019-04-12 Arnold D. Robbins <address@hidden>
+
+ * 5.0.0: Release tar ball made.
+
2018-02-25 Arnold D. Robbins <address@hidden>
* 4.2.1: Release tar ball made.
diff --git a/vms/vax/ChangeLog b/vms/vax/ChangeLog
index ccc3a9e..ed6f9e7 100644
--- a/vms/vax/ChangeLog
+++ b/vms/vax/ChangeLog
@@ -1,3 +1,7 @@
+2019-04-12 Arnold D. Robbins <address@hidden>
+
+ * 5.0.0: Release tar ball made.
+
2018-02-25 Arnold D. Robbins <address@hidden>
* 4.2.1: Release tar ball made.
http://git.sv.gnu.org/cgit/gawk.git/commit/?id=846375cf4aa711be438d5da3a0ac00ef6acbf836
commit 846375cf4aa711be438d5da3a0ac00ef6acbf836
Author: Arnold D. Robbins <address@hidden>
Date: Fri Apr 12 12:28:05 2019 +0300
Update gettext version in the doc.
diff --git a/ChangeLog b/ChangeLog.1
similarity index 100%
rename from ChangeLog
rename to ChangeLog.1
diff --git a/README_d/ChangeLog b/README_d/ChangeLog.1
similarity index 100%
rename from README_d/ChangeLog
rename to README_d/ChangeLog.1
diff --git a/awklib/ChangeLog b/awklib/ChangeLog.1
similarity index 100%
rename from awklib/ChangeLog
rename to awklib/ChangeLog.1
diff --git a/doc/ChangeLog b/doc/ChangeLog.1
similarity index 100%
rename from doc/ChangeLog
rename to doc/ChangeLog.1
diff --git a/doc/gawk.info b/doc/gawk.info
index 19be939..bca05d1 100644
--- a/doc/gawk.info
+++ b/doc/gawk.info
@@ -21680,8 +21680,8 @@ File: gawk.info, Node: Gawk I18N, Next: I18N Summary,
Prev: I18N Example, Up
'gawk' itself has been internationalized using the GNU 'gettext'
package. (GNU 'gettext' is described in complete detail in *note (GNU
'gettext' utilities, gettext, GNU 'gettext' utilities)Top::.) As of
-this writing, the latest version of GNU 'gettext' is version 0.19.4
-(ftp://ftp.gnu.org/gnu/gettext/gettext-0.19.4.tar.gz).
+this writing, the latest version of GNU 'gettext' is version 0.19.8.1
+(ftp://ftp.gnu.org/gnu/gettext/gettext-0.19.8.1.tar.gz).
If a translation of 'gawk''s messages exists, then 'gawk' produces
usage messages, warnings, and fatal errors in the local language.
@@ -37257,212 +37257,212 @@ Node: I18N Example875940
Ref: I18N Example-Footnote-1879215
Ref: I18N Example-Footnote-2879288
Node: Gawk I18N879397
-Node: I18N Summary880042
-Node: Debugger881383
-Node: Debugging882383
-Node: Debugging Concepts882824
-Node: Debugging Terms884633
-Node: Awk Debugging887208
-Ref: Awk Debugging-Footnote-1888153
-Node: Sample Debugging Session888285
-Node: Debugger Invocation888819
-Node: Finding The Bug890205
-Node: List of Debugger Commands896679
-Node: Breakpoint Control898012
-Node: Debugger Execution Control901706
-Node: Viewing And Changing Data905068
-Node: Execution Stack908609
-Node: Debugger Info910246
-Node: Miscellaneous Debugger Commands914317
-Node: Readline Support919379
-Node: Limitations920275
-Node: Debugging Summary922384
-Node: Namespaces923663
-Node: Global Namespace924742
-Node: Qualified Names926140
-Node: Default Namespace927139
-Node: Changing The Namespace927880
-Node: Naming Rules929494
-Node: Internal Name Management931342
-Node: Namespace Example932384
-Node: Namespace And Features934946
-Node: Namespace Summary936381
-Node: Arbitrary Precision Arithmetic937858
-Node: Computer Arithmetic939345
-Ref: table-numeric-ranges943111
-Ref: table-floating-point-ranges943604
-Ref: Computer Arithmetic-Footnote-1944262
-Node: Math Definitions944319
-Ref: table-ieee-formats947635
-Ref: Math Definitions-Footnote-1948238
-Node: MPFR features948343
-Node: FP Math Caution950061
-Ref: FP Math Caution-Footnote-1951133
-Node: Inexactness of computations951502
-Node: Inexact representation952462
-Node: Comparing FP Values953822
-Node: Errors accumulate955063
-Node: Getting Accuracy956496
-Node: Try To Round959206
-Node: Setting precision960105
-Ref: table-predefined-precision-strings960802
-Node: Setting the rounding mode962632
-Ref: table-gawk-rounding-modes963006
-Ref: Setting the rounding mode-Footnote-1966937
-Node: Arbitrary Precision Integers967116
-Ref: Arbitrary Precision Integers-Footnote-1970291
-Node: Checking for MPFR970440
-Node: POSIX Floating Point Problems971914
-Ref: POSIX Floating Point Problems-Footnote-1976199
-Node: Floating point summary976237
-Node: Dynamic Extensions978427
-Node: Extension Intro979980
-Node: Plugin License981246
-Node: Extension Mechanism Outline982043
-Ref: figure-load-extension982482
-Ref: figure-register-new-function984047
-Ref: figure-call-new-function985139
-Node: Extension API Description987201
-Node: Extension API Functions Introduction988843
-Ref: table-api-std-headers990679
-Node: General Data Types994544
-Ref: General Data Types-Footnote-11002905
-Node: Memory Allocation Functions1003204
-Ref: Memory Allocation Functions-Footnote-11007414
-Node: Constructor Functions1007513
-Node: Registration Functions1011099
-Node: Extension Functions1011784
-Node: Exit Callback Functions1017106
-Node: Extension Version String1018356
-Node: Input Parsers1019019
-Node: Output Wrappers1031740
-Node: Two-way processors1036252
-Node: Printing Messages1038517
-Ref: Printing Messages-Footnote-11039688
-Node: Updating ERRNO1039841
-Node: Requesting Values1040580
-Ref: table-value-types-returned1041317
-Node: Accessing Parameters1042253
-Node: Symbol Table Access1043488
-Node: Symbol table by name1044000
-Ref: Symbol table by name-Footnote-11047024
-Node: Symbol table by cookie1047152
-Ref: Symbol table by cookie-Footnote-11051337
-Node: Cached values1051401
-Ref: Cached values-Footnote-11054937
-Node: Array Manipulation1055090
-Ref: Array Manipulation-Footnote-11056181
-Node: Array Data Types1056218
-Ref: Array Data Types-Footnote-11058876
-Node: Array Functions1058968
-Node: Flattening Arrays1063466
-Node: Creating Arrays1070442
-Node: Redirection API1075209
-Node: Extension API Variables1078042
-Node: Extension Versioning1078753
-Ref: gawk-api-version1079182
-Node: Extension GMP/MPFR Versioning1080913
-Node: Extension API Informational Variables1082541
-Node: Extension API Boilerplate1083614
-Node: Changes from API V11087588
-Node: Finding Extensions1089160
-Node: Extension Example1089719
-Node: Internal File Description1090517
-Node: Internal File Ops1094597
-Ref: Internal File Ops-Footnote-11105947
-Node: Using Internal File Ops1106087
-Ref: Using Internal File Ops-Footnote-11108470
-Node: Extension Samples1108744
-Node: Extension Sample File Functions1110273
-Node: Extension Sample Fnmatch1117922
-Node: Extension Sample Fork1119409
-Node: Extension Sample Inplace1120627
-Node: Extension Sample Ord1123931
-Node: Extension Sample Readdir1124767
-Ref: table-readdir-file-types1125656
-Node: Extension Sample Revout1126461
-Node: Extension Sample Rev2way1127050
-Node: Extension Sample Read write array1127790
-Node: Extension Sample Readfile1129732
-Node: Extension Sample Time1130827
-Node: Extension Sample API Tests1132175
-Node: gawkextlib1132667
-Node: Extension summary1135585
-Node: Extension Exercises1139287
-Node: Language History1140529
-Node: V7/SVR3.11142185
-Node: SVR41144337
-Node: POSIX1145771
-Node: BTL1147151
-Node: POSIX/GNU1147880
-Node: Feature History1153658
-Node: Common Extensions1169704
-Node: Ranges and Locales1170987
-Ref: Ranges and Locales-Footnote-11175603
-Ref: Ranges and Locales-Footnote-21175630
-Ref: Ranges and Locales-Footnote-31175865
-Node: Contributors1176086
-Node: History summary1182031
-Node: Installation1183411
-Node: Gawk Distribution1184355
-Node: Getting1184839
-Node: Extracting1185802
-Node: Distribution contents1187440
-Node: Unix Installation1193920
-Node: Quick Installation1194602
-Node: Shell Startup Files1197016
-Node: Additional Configuration Options1198105
-Node: Configuration Philosophy1200270
-Node: Non-Unix Installation1202639
-Node: PC Installation1203099
-Node: PC Binary Installation1203937
-Node: PC Compiling1204372
-Node: PC Using1205489
-Node: Cygwin1209042
-Node: MSYS1210141
-Node: VMS Installation1210642
-Node: VMS Compilation1211433
-Ref: VMS Compilation-Footnote-11212662
-Node: VMS Dynamic Extensions1212720
-Node: VMS Installation Details1214405
-Node: VMS Running1216658
-Node: VMS GNV1220937
-Node: VMS Old Gawk1221672
-Node: Bugs1222143
-Node: Bug address1222806
-Node: Usenet1225788
-Node: Maintainers1226792
-Node: Other Versions1228053
-Node: Installation summary1234967
-Node: Notes1236169
-Node: Compatibility Mode1236963
-Node: Additions1237745
-Node: Accessing The Source1238670
-Node: Adding Code1240107
-Node: New Ports1246326
-Node: Derived Files1250701
-Ref: Derived Files-Footnote-11256361
-Ref: Derived Files-Footnote-21256396
-Ref: Derived Files-Footnote-31256994
-Node: Future Extensions1257108
-Node: Implementation Limitations1257766
-Node: Extension Design1258949
-Node: Old Extension Problems1260093
-Ref: Old Extension Problems-Footnote-11261611
-Node: Extension New Mechanism Goals1261668
-Ref: Extension New Mechanism Goals-Footnote-11265032
-Node: Extension Other Design Decisions1265221
-Node: Extension Future Growth1267334
-Node: Notes summary1268170
-Node: Basic Concepts1269328
-Node: Basic High Level1270009
-Ref: figure-general-flow1270291
-Ref: figure-process-flow1270976
-Ref: Basic High Level-Footnote-11274277
-Node: Basic Data Typing1274462
-Node: Glossary1277790
-Node: Copying1309628
-Node: GNU Free Documentation License1347171
-Node: Index1372291
+Node: I18N Summary880046
+Node: Debugger881387
+Node: Debugging882387
+Node: Debugging Concepts882828
+Node: Debugging Terms884637
+Node: Awk Debugging887212
+Ref: Awk Debugging-Footnote-1888157
+Node: Sample Debugging Session888289
+Node: Debugger Invocation888823
+Node: Finding The Bug890209
+Node: List of Debugger Commands896683
+Node: Breakpoint Control898016
+Node: Debugger Execution Control901710
+Node: Viewing And Changing Data905072
+Node: Execution Stack908613
+Node: Debugger Info910250
+Node: Miscellaneous Debugger Commands914321
+Node: Readline Support919383
+Node: Limitations920279
+Node: Debugging Summary922388
+Node: Namespaces923667
+Node: Global Namespace924746
+Node: Qualified Names926144
+Node: Default Namespace927143
+Node: Changing The Namespace927884
+Node: Naming Rules929498
+Node: Internal Name Management931346
+Node: Namespace Example932388
+Node: Namespace And Features934950
+Node: Namespace Summary936385
+Node: Arbitrary Precision Arithmetic937862
+Node: Computer Arithmetic939349
+Ref: table-numeric-ranges943115
+Ref: table-floating-point-ranges943608
+Ref: Computer Arithmetic-Footnote-1944266
+Node: Math Definitions944323
+Ref: table-ieee-formats947639
+Ref: Math Definitions-Footnote-1948242
+Node: MPFR features948347
+Node: FP Math Caution950065
+Ref: FP Math Caution-Footnote-1951137
+Node: Inexactness of computations951506
+Node: Inexact representation952466
+Node: Comparing FP Values953826
+Node: Errors accumulate955067
+Node: Getting Accuracy956500
+Node: Try To Round959210
+Node: Setting precision960109
+Ref: table-predefined-precision-strings960806
+Node: Setting the rounding mode962636
+Ref: table-gawk-rounding-modes963010
+Ref: Setting the rounding mode-Footnote-1966941
+Node: Arbitrary Precision Integers967120
+Ref: Arbitrary Precision Integers-Footnote-1970295
+Node: Checking for MPFR970444
+Node: POSIX Floating Point Problems971918
+Ref: POSIX Floating Point Problems-Footnote-1976203
+Node: Floating point summary976241
+Node: Dynamic Extensions978431
+Node: Extension Intro979984
+Node: Plugin License981250
+Node: Extension Mechanism Outline982047
+Ref: figure-load-extension982486
+Ref: figure-register-new-function984051
+Ref: figure-call-new-function985143
+Node: Extension API Description987205
+Node: Extension API Functions Introduction988847
+Ref: table-api-std-headers990683
+Node: General Data Types994548
+Ref: General Data Types-Footnote-11002909
+Node: Memory Allocation Functions1003208
+Ref: Memory Allocation Functions-Footnote-11007418
+Node: Constructor Functions1007517
+Node: Registration Functions1011103
+Node: Extension Functions1011788
+Node: Exit Callback Functions1017110
+Node: Extension Version String1018360
+Node: Input Parsers1019023
+Node: Output Wrappers1031744
+Node: Two-way processors1036256
+Node: Printing Messages1038521
+Ref: Printing Messages-Footnote-11039692
+Node: Updating ERRNO1039845
+Node: Requesting Values1040584
+Ref: table-value-types-returned1041321
+Node: Accessing Parameters1042257
+Node: Symbol Table Access1043492
+Node: Symbol table by name1044004
+Ref: Symbol table by name-Footnote-11047028
+Node: Symbol table by cookie1047156
+Ref: Symbol table by cookie-Footnote-11051341
+Node: Cached values1051405
+Ref: Cached values-Footnote-11054941
+Node: Array Manipulation1055094
+Ref: Array Manipulation-Footnote-11056185
+Node: Array Data Types1056222
+Ref: Array Data Types-Footnote-11058880
+Node: Array Functions1058972
+Node: Flattening Arrays1063470
+Node: Creating Arrays1070446
+Node: Redirection API1075213
+Node: Extension API Variables1078046
+Node: Extension Versioning1078757
+Ref: gawk-api-version1079186
+Node: Extension GMP/MPFR Versioning1080917
+Node: Extension API Informational Variables1082545
+Node: Extension API Boilerplate1083618
+Node: Changes from API V11087592
+Node: Finding Extensions1089164
+Node: Extension Example1089723
+Node: Internal File Description1090521
+Node: Internal File Ops1094601
+Ref: Internal File Ops-Footnote-11105951
+Node: Using Internal File Ops1106091
+Ref: Using Internal File Ops-Footnote-11108474
+Node: Extension Samples1108748
+Node: Extension Sample File Functions1110277
+Node: Extension Sample Fnmatch1117926
+Node: Extension Sample Fork1119413
+Node: Extension Sample Inplace1120631
+Node: Extension Sample Ord1123935
+Node: Extension Sample Readdir1124771
+Ref: table-readdir-file-types1125660
+Node: Extension Sample Revout1126465
+Node: Extension Sample Rev2way1127054
+Node: Extension Sample Read write array1127794
+Node: Extension Sample Readfile1129736
+Node: Extension Sample Time1130831
+Node: Extension Sample API Tests1132179
+Node: gawkextlib1132671
+Node: Extension summary1135589
+Node: Extension Exercises1139291
+Node: Language History1140533
+Node: V7/SVR3.11142189
+Node: SVR41144341
+Node: POSIX1145775
+Node: BTL1147155
+Node: POSIX/GNU1147884
+Node: Feature History1153662
+Node: Common Extensions1169708
+Node: Ranges and Locales1170991
+Ref: Ranges and Locales-Footnote-11175607
+Ref: Ranges and Locales-Footnote-21175634
+Ref: Ranges and Locales-Footnote-31175869
+Node: Contributors1176090
+Node: History summary1182035
+Node: Installation1183415
+Node: Gawk Distribution1184359
+Node: Getting1184843
+Node: Extracting1185806
+Node: Distribution contents1187444
+Node: Unix Installation1193924
+Node: Quick Installation1194606
+Node: Shell Startup Files1197020
+Node: Additional Configuration Options1198109
+Node: Configuration Philosophy1200274
+Node: Non-Unix Installation1202643
+Node: PC Installation1203103
+Node: PC Binary Installation1203941
+Node: PC Compiling1204376
+Node: PC Using1205493
+Node: Cygwin1209046
+Node: MSYS1210145
+Node: VMS Installation1210646
+Node: VMS Compilation1211437
+Ref: VMS Compilation-Footnote-11212666
+Node: VMS Dynamic Extensions1212724
+Node: VMS Installation Details1214409
+Node: VMS Running1216662
+Node: VMS GNV1220941
+Node: VMS Old Gawk1221676
+Node: Bugs1222147
+Node: Bug address1222810
+Node: Usenet1225792
+Node: Maintainers1226796
+Node: Other Versions1228057
+Node: Installation summary1234971
+Node: Notes1236173
+Node: Compatibility Mode1236967
+Node: Additions1237749
+Node: Accessing The Source1238674
+Node: Adding Code1240111
+Node: New Ports1246330
+Node: Derived Files1250705
+Ref: Derived Files-Footnote-11256365
+Ref: Derived Files-Footnote-21256400
+Ref: Derived Files-Footnote-31256998
+Node: Future Extensions1257112
+Node: Implementation Limitations1257770
+Node: Extension Design1258953
+Node: Old Extension Problems1260097
+Ref: Old Extension Problems-Footnote-11261615
+Node: Extension New Mechanism Goals1261672
+Ref: Extension New Mechanism Goals-Footnote-11265036
+Node: Extension Other Design Decisions1265225
+Node: Extension Future Growth1267338
+Node: Notes summary1268174
+Node: Basic Concepts1269332
+Node: Basic High Level1270013
+Ref: figure-general-flow1270295
+Ref: figure-process-flow1270980
+Ref: Basic High Level-Footnote-11274281
+Node: Basic Data Typing1274466
+Node: Glossary1277794
+Node: Copying1309632
+Node: GNU Free Documentation License1347175
+Node: Index1372295
End Tag Table
diff --git a/doc/gawk.texi b/doc/gawk.texi
index 15c33a1..c3d01a6 100644
--- a/doc/gawk.texi
+++ b/doc/gawk.texi
@@ -30306,8 +30306,8 @@ complete detail in
@cite{GNU @command{gettext} utilities}}.)
@end ifnotinfo
As of this writing, the latest version of GNU @command{gettext} is
address@hidden://ftp.gnu.org/gnu/gettext/gettext-0.19.4.tar.gz,
address@hidden 0.19.4}.
address@hidden://ftp.gnu.org/gnu/gettext/gettext-0.19.8.1.tar.gz,
address@hidden 0.19.8.1}.
If a translation of @command{gawk}'s messages exists,
then @command{gawk} produces usage messages, warnings,
diff --git a/doc/gawktexi.in b/doc/gawktexi.in
index 9a6e452..202f47f 100644
--- a/doc/gawktexi.in
+++ b/doc/gawktexi.in
@@ -29318,8 +29318,8 @@ complete detail in
@cite{GNU @command{gettext} utilities}}.)
@end ifnotinfo
As of this writing, the latest version of GNU @command{gettext} is
address@hidden://ftp.gnu.org/gnu/gettext/gettext-0.19.4.tar.gz,
address@hidden 0.19.4}.
address@hidden://ftp.gnu.org/gnu/gettext/gettext-0.19.8.1.tar.gz,
address@hidden 0.19.8.1}.
If a translation of @command{gawk}'s messages exists,
then @command{gawk} produces usage messages, warnings,
diff --git a/doc/it/ChangeLog b/doc/it/ChangeLog
index 101e75a..a384a80 100644
--- a/doc/it/ChangeLog
+++ b/doc/it/ChangeLog
@@ -1,3 +1,7 @@
+2019-04-12 Arnold D. Robbins <address@hidden>
+
+ * 5.0.0: Release tar ball made.
+
2019-04-12 Antonio Giovanni Colombo <address@hidden>
* gawktexi.in: Updated.
diff --git a/doc/it/gawktexi.in b/doc/it/gawktexi.in
index b203a75..b0ff86e 100644
--- a/doc/it/gawktexi.in
+++ b/doc/it/gawktexi.in
@@ -31768,8 +31768,8 @@ maniera esauriente in
@end ifnotinfo
Al momento in cui questo libro @`e stato scritto, la versione address@hidden
recente di
GNU @command{gettext} @`e
address@hidden://ftp.gnu.org/gnu/gettext/gettext-0.19.4.tar.gz,
address@hidden 0.19.4}.
address@hidden://ftp.gnu.org/gnu/gettext/gettext-0.19.8.1.tar.gz,
address@hidden 0.19.8.1}.
Se esiste una traduzione dei messaggi di @command{gawk},
@command{gawk} invia messaggi, avvertimenti, ed errori fatali
diff --git a/extension/ChangeLog b/extension/ChangeLog.1
similarity index 100%
rename from extension/ChangeLog
rename to extension/ChangeLog.1
diff --git a/m4/ChangeLog b/m4/ChangeLog.1
similarity index 100%
rename from m4/ChangeLog
rename to m4/ChangeLog.1
diff --git a/missing_d/ChangeLog b/missing_d/ChangeLog.1
similarity index 100%
rename from missing_d/ChangeLog
rename to missing_d/ChangeLog.1
diff --git a/pc/ChangeLog b/pc/ChangeLog.1
similarity index 100%
rename from pc/ChangeLog
rename to pc/ChangeLog.1
diff --git a/po/ChangeLog b/po/ChangeLog.1
similarity index 100%
rename from po/ChangeLog
rename to po/ChangeLog.1
diff --git a/posix/ChangeLog b/posix/ChangeLog.1
similarity index 100%
rename from posix/ChangeLog
rename to posix/ChangeLog.1
diff --git a/support/ChangeLog b/support/ChangeLog.0
similarity index 100%
rename from support/ChangeLog
rename to support/ChangeLog.0
diff --git a/test/ChangeLog b/test/ChangeLog.1
similarity index 100%
rename from test/ChangeLog
rename to test/ChangeLog.1
diff --git a/vms/ChangeLog b/vms/ChangeLog.1
similarity index 100%
rename from vms/ChangeLog
rename to vms/ChangeLog.1
http://git.sv.gnu.org/cgit/gawk.git/commit/?id=414addfde0ca368a19b65276a7ab9ec830df5865
commit 414addfde0ca368a19b65276a7ab9ec830df5865
Author: Arnold D. Robbins <address@hidden>
Date: Fri Apr 12 11:56:47 2019 +0300
Update Italian translation.
diff --git a/doc/it/ChangeLog b/doc/it/ChangeLog
index 3e010bb..101e75a 100644
--- a/doc/it/ChangeLog
+++ b/doc/it/ChangeLog
@@ -1,3 +1,7 @@
+2019-04-12 Antonio Giovanni Colombo <address@hidden>
+
+ * gawktexi.in: Updated.
+
2018-12-18 Antonio Giovanni Colombo <address@hidden>
* gawk.1: Updated.
diff --git a/doc/it/gawktexi.in b/doc/it/gawktexi.in
index 5a56e8f..b203a75 100644
--- a/doc/it/gawktexi.in
+++ b/doc/it/gawktexi.in
@@ -16,11 +16,6 @@
* awk: (gawk)Avviare Gawk. Scansione e processo di testi.
@end direntry
address@hidden Enable better indexing, requires texindex from Texinfo 6 or
later.
address@hidden
-\global\usebracesinindexestrue
address@hidden tex
-
@ifset FOR_PRINT
@tex
\gdef\xrefprintnodename#1{``#1''}
@@ -52,18 +47,18 @@
@ifnottex
@set VOLTE *
@end ifnottex
-
address@hidden xref-automatic-section-title
address@hidden Let texinfo.tex give us full section titles
address@hidden on
@c The following information should be updated here only!
@c This sets the edition of the document, the version of gawk it
@c applies to and all the info about who's publishing this edition
@c These apply across the board.
address@hidden UPDATE-MONTH Settembre 2018
address@hidden VERSION 4.2
address@hidden PATCHLEVEL 1
address@hidden UPDATE-MONTH Marzo 2019
address@hidden VERSION 5.0
address@hidden PATCHLEVEL 0
@c added Italian hyphenation stuff
@hyphenation{ven-go-no o-met-te-re o-met-ten-do}
@@ -76,7 +71,7 @@
@set TITLE GAWK: Programmare efficacemente in AWK
@end ifclear
@set SUBTITLE Una Guida Utente per GNU Awk
address@hidden EDITION 4.2
address@hidden EDITION 5.0
@iftex
@set DOCUMENT libro
@@ -308,7 +303,7 @@ Some comments on the layout for TeX.
Tel.: +1-617-542-5942 Fax: +1-617-542-2652 Email: <email>gnu@@gnu.org</email>
URL: <ulink
url="https://www.gnu.org";>https://www.gnu.org/</ulink></literallayout>
-<literallayout class="normal">Copyright © 1989, 1991, 1992, 1993,
1996–2005, 2007, 2009–2018
+<literallayout class="normal">Copyright © 1989, 1991, 1992, 1993,
1996–2005, 2007, 2009–2019
Free Software Foundation, Inc.
All Rights Reserved.
</literallayout>
@@ -330,7 +325,7 @@ Italian Linux Documentation Project (ILDP)
Email: <emailildp@@pluto.it
URL: <ulink
url="http://www.pluto.it/ildp";>http://www.pluto.it/ildp/</ulink></literallayout>
-<literallayout class="normal">Copyright © 2016
+<literallayout class="normal">Copyright © 2016–2019
Free Software Foundation, Inc.
All Rights Reserved.
</literallayout>
@@ -338,7 +333,7 @@ All Rights Reserved.
@ifnotdocbook
@iftex
-Copyright @copyright{} 1989, 1991, 1992, 1993, 1996--2005, 2007, 2009--2018 @*
+Copyright @copyright{} 1989, 1991, 1992, 1993, 1996--2005, 2007, 2009--2019 @*
Free Software Foundation, Inc.
@end iftex
@end ifnotdocbook
@@ -557,6 +552,8 @@ Copyright dell'edizione italiana @copyright{} 2016 -- Free
Software Foundation,
* Internazionalizzazione:: Come far address@hidden@dotless{i}} che
@command{gawk} parli la
vostra lingua.
* Debugger:: Il debugger di @command{gawk}.
+* Spazi-dei-nomi:: Come funzionano gli spazi-dei-nomi
+ (@dfn{spazi-dei-nomi}) in @command{gawk}.
* Calcolo con precisione arbitraria:: Calcolo con precisione arbitraria in
@command{gawk}.
* Estensioni dinamiche:: Aggiungere nuove funzioni predefinite di
@@ -646,6 +643,8 @@ Copyright dell'edizione italiana @copyright{} 2016 -- Free
Software Foundation,
* Uso di @dfn{regexp}:: Come usare le espressioni regolari.
* Sequenze di protezione:: Come scrivere caratteri non stampabili.
* Operatori di espressioni regolari:: Operatori di espressioni regolari.
+* Dettagli sugli operatori di @dfn{regexp}:: Descrizione dettagliata.
+* Espressioni di intervallo:: Note sulle espressioni di intervallo.
* Espressioni tra parentesi quadre:: Cosa possono contenere @samp{[...]}.
* address@hidden lungo da sinistra:: Quanto @`e lungo il testo
individuato.
* Espressioni regolari calcolate:: Usare @dfn{regexp} dinamiche.
@@ -895,10 +894,11 @@ Copyright dell'edizione italiana @copyright{} 2016 --
Free Software Foundation,
significano.
* Esempio di funzione:: Un esempio di definizione di
funzione e spiegazione della stessa.
-* Precisazioni sulle funzioni:: Cose a cui prestare attenzione.
+* Chiamata di una funzione:: Chiamare funzioni definite dall'utente.
* Chiamare una funzione:: Non usare spazi.
* Campo di address@hidden variabili:: Variabili locali e globali.
* Parametri per valore/riferimento:: Passaggio parametri.
+* Precisazioni sulle funzioni:: Cose a cui prestare attenzione.
* Istruzione return:: Specificare il valore che una
funzione restituisce.
* Variabili di tipo dinamico:: Come cambiare tipo a una variabile in
@@ -1033,6 +1033,19 @@ Copyright dell'edizione italiana @copyright{} 2016 --
Free Software Foundation,
* Supporto per Readline:: Supporto per Readline.
* Limitazioni:: Limitazioni.
* Sommario sul debug:: Sommario sul debug.
+* Spazio-dei-nomi globale:: Lo spazio-dei-nomi globale in
@command{awk}
+ standard.
+* Nomi qualificati:: Come qualificare nomi con uno
+ spazio-dei-nomi.
+* Spazio-dei-nomi di default:: Lo spazio-dei-nomi di default.
+* Cambiare lo spazio-dei-nomi:: Come cambiare lo spazio-dei-nomi.
+* Regole per i nomi:: Regole per assegnare nomi a uno
+ spazio-dei-nomi e ai suoi componenti.
+* Gestione interna dei nomi:: Come i nomi sono gestiti internamente.
+* Esempio di spazio-dei-nomi:: Esempio di codice che usa uno
spazio-dei-nomi.
+* Spazio-dei-nomi e address@hidden:: Lo spazio-dei-nomi e le altre
address@hidden
+ di @command{gawk}.
+* Sommario sugli spazi-dei-nomi:: Sommario sugli spazi-dei-nomi.
* Aritmetica del computer:: Una rapida introduzione alla
matematica del
computer.
* Definizioni matematiche:: Altre cose da sapere.
@@ -1060,8 +1073,8 @@ Copyright dell'edizione italiana @copyright{} 2016 --
Free Software Foundation,
* Introduzione alle estensioni:: Cos'@`e un'estensione.
* Licenza delle estensioni:: tipo di licenza delle estensioni.
* Panoramica sul meccanismo delle estensioni:: Come funziona a grandi linee.
-* Descrizione dell'API delle estensioni:: Una descrizione completa dell'API.
-* Intro funzioni API delle estensioni:: Introduzione alle funzioni dell'API.
+* Descrizione dell'estensione API:: Una descrizione completa dell'API.
+* Intro funzioni estensione API:: Introduzione alle funzioni dell'API.
* Tipi di dati generali:: I tipi di dati.
* Funzioni di allocazione memoria:: Funzioni per allocare memoria.
* Funzioni di costruzione:: Funzioni per creare valori.
@@ -1895,6 +1908,11 @@ di programma in diverse lingue in fase di esecuzione.
@ref{Debugger}, descrive il debugger di @command{gawk}.
@item
address@hidden, descrive come @command{gawk} permette
+che variabili e/o funzioni con lo stesso nome coesistano
+in distinti spazi-dei-nomi (@dfn{spazi-dei-nomi}).
+
address@hidden
@ref{Calcolo con precisione arbitraria},
illustra le address@hidden di calcolo avanzate.
@@ -2877,7 +2895,7 @@ Molti linguaggi moderni sono interpretati.
La riga che inizia con @samp{#!} lista l'intero @value{FN} di un
interpretatore
-da richiamare, con degli argomenti facoltativi che saranno passati a
+da richiamare, con degli argomenti opzionali che saranno passati a
quell'interpretatore sulla riga di comando. Il sistema operativo quindi
richiama l'interpretatore con gli argomenti dati e con l'intera lista di
argomenti con cui era stato invocato il programma. Il primo argomento nella
@@ -3124,7 +3142,7 @@ address@hidden come minimo genera un errore di sintassi,
e un comportamento confuso nel
caso peggiore.
@end itemize
address@hidden protezione, nella riga di comando di @command{gawk}, trucchi per
address@hidden protezione, nella riga di comando di @command{gawk}, trucchi per
la
Mischiare apici singoli e doppi @`e difficile. Occorre utilizzare
trucchi della shell per gli apici, come questi:
@@ -3811,6 +3829,8 @@ il @code{BEGIN} @`e marcato come errore di sintassi.
@cindex istruzioni multiple
@cindex @code{;} (punto e virgola), separare istruzioni nelle azioni
@cindex punto e virgola (@code{;}), separare istruzioni nelle azioni
address@hidden @code{;} (punto e virgola), separare regole
address@hidden punto e virgola (@code{;}), separare regole
Quando le istruzioni @command{awk} all'interno di una regola sono brevi, si
potrebbe metterne address@hidden d'una su una riga sola. address@hidden @`e
possibile separando le
istruzioni con un punto e virgola (@samp{;}).
@@ -4074,6 +4094,11 @@ Quest'opzione address@hidden essere data address@hidden
volte; il programma @command{awk}
@`e formato dalla concatenazione del contenuto di ogni
@var{file-sorgente} specificato.
+I file specificati dall'opzione @option{-i} sono considerati
+appartenere allo spazio-dei-nomi @samp{"awk" (@@namespace "awk")}
+a inizio programma. @xref{Cambiare lo spazio-dei-nomi}, per ulteriori
+informazioni.
+
@item -v @address@hidden
@itemx --assign @address@hidden
@cindex @option{-v}, opzione
@@ -4225,9 +4250,10 @@ da un carattere di ritorno a capo (anche se non @`e
questo il caso).
address@hidden facilita la costruzione del programma completo.
@quotation ATTENZIONE
-Non c'@`e ancora alcuna specifica che imponga che ogni @var{testo-di-programma}
-costituisca un'address@hidden sintattica completa. P.es., il codice che segue
-funziona a tutt'oggi:
+Prima della @value{PVERSION} 5.0, non era necessario
+che ogni @var{testo-di-programma} costituisse
+un'address@hidden sintattica completa. P.es., il codice che segue
+funzionava:
@example
$ @kbd{gawk -e 'BEGIN @{ a = 5 ;' -e 'print a @}'}
@@ -4235,8 +4261,13 @@ $ @kbd{gawk -e 'BEGIN @{ a = 5 ;' -e 'print a @}'}
@end example
@noindent
-Comunque address@hidden potrebbe cambiare in futuro, e per questo motivo non
@`e una
-buona idea utilizzare questa address@hidden
+Comunque address@hidden non @`e address@hidden possibile. Se c'@`e qualche
@dfn{script}
+che utilizza tale address@hidden, @`e necessario modificarlo.
+
+Il motivo di address@hidden @`e che ogni @var{testo-di-programma} @`e
considerato
+appartenere allo spazio di nomi @samp{"awk" (@@namespace "awk")}
+a inizio programma. @xref{Cambiare lo spazio-dei-nomi}, per ulteriori
+informazioni.
@end quotation
@item @option{-E} @var{file}
@@ -4318,6 +4349,11 @@ costituenti l'input del programma principale.
address@hidden@dotless{i}}, dopo l'elabor
un argomento @option{-i}, @command{gawk} si aspetta di trovare il codice
sorgente principale attraverso l'opzione @option{-f} o sulla riga di comando.
+I file specificati dall'opzione @option{-i} sono considerati
+appartenere allo spazio-dei-nomi @samp{"awk" (@@namespace "awk")}
+a inizio programma. @xref{Cambiare lo spazio-dei-nomi}, per ulteriori
+informazioni.
+
@item @option{-l} @var{ext}
@itemx @option{--load} @var{ext}
@cindex @option{-l}, opzione
@@ -4395,6 +4431,7 @@ Forza l'uso del carattere di separazione decimale della
localizzazione
quando analizza i dati in input
(@pxref{Localizzazioni}).
address@hidden stampa elegante
@item @address@hidden
@itemx @address@hidden@var{file}]
@cindex @option{-o}, opzione
@@ -4430,7 +4467,7 @@ opzione @option{-s} (si veda address@hidden sotto in
questa lista).
@itemx @address@hidden@var{file}]
@cindex @option{-p}, opzione
@cindex @option{--profile}, opzione
address@hidden @command{awk}, profilatura, abilitare la
address@hidden @command{awk}, profilazione, abilitare la
Abilita la creazione del profilo di esecuzione di programmi @command{awk}
(@pxref{Profilare}).
Implicitamente viene forzata l'opzione @option{--no-optimize}.
@@ -4468,7 +4505,8 @@ I ritorni a capo non sono consentiti dopo @samp{?} o
@samp{:}
(@pxref{Espressioni condizionali}).
address@hidden @code{FS}, variabile, come carattere TAB
address@hidden @code{FS}, variabile, carattere TAB come
address@hidden variabile @code{FS}, carattere TAB come
@item
Specificando @samp{-Ft} sulla riga di comando non si imposta il valore
della variabile @code{FS} a un singolo carattere TAB
@@ -4732,6 +4770,9 @@ l'output di @var{qualche_comando}, e infile legge
Si address@hidden anche usare @code{"-"} per indicare lo standard input quando
si leggono
i file con @code{getline} (@pxref{Getline file}).
+E si address@hidden perfino usare @code{"-"} con l'opzione @option{-f} per
+leggere il sorgente del programma dallo standard input
+(@pxref{Opzioni}).
In aggiunta, @command{gawk} consente di specificare il
@value{FN} speciale @file{/dev/stdin}, sia sulla riga di comando che
@@ -5153,6 +5194,11 @@ Le regole usate per trovare un file sorgente, descritte
in
@ref{AWKPATH (Variabile)}, valgono anche per i file
caricati tramite @code{@@include}.
+Infine, i file inclusi con @code{@@include} sono considerati
+appartenere allo spazio-dei-nomi @samp{"awk" (@@namespace "awk")}
+a inizio programma. @xref{Cambiare lo spazio-dei-nomi}, per ulteriori
+informazioni.
+
@node Caricare librerie condivise
@section Caricare librerie condivise nel proprio programma
@@ -5244,8 +5290,8 @@ in case some option becomes obsolete in a future version
of @command{gawk}.
@cindex address@hidden non documentate
@cindex Skywalker, Luke
@cindex Kenobi, Obi-Wan
address@hidden Jedi, Cavalieri
address@hidden Cavalieri Jedi
address@hidden jedi, cavalieri
address@hidden cavalieri jedi
@quotation
@i{Usa il codice sorgente, Luke!}
@author Obi-Wan
@@ -5323,14 +5369,25 @@ programmi erano stati scritti.
Le funzioni predefinite standard di command{awk}, per esempio
@code{sin()} o @code{substr()} @emph{non} ammettono questa address@hidden
address@hidden possibile specificare in @code{printf} un modificatore @samp{P}
address@hidden possibile specificare in @code{printf} un modificatore @samp{P}
fra le lettere di controllo dei numeri in virgola mobile, per
utilizzare il risultato fornito dalle funzioni di libreria C
-per i valori NaN [Not a Number] e Infinity [Infinito], invece dei
+per i valori NaN [Non un Numero] e Infinity [Infinito], invece dei
valori speciali normalmente prodotti da @command{gawk}, come
descritto in @ref{Problemi virgola mobile POSIX}.
Questo serve principalmente nella fase di test delle componenti aggiunte.
+La funzione predefinita @code{typeof()}
+(@pxref{Funzioni per i tipi})
+accetta un nome di vettore, opzionale, come secondo argomento, il quale,
+se presente address@hidden svuotato degli eventuali contenuti, e riempito con
+alcune informazioni che descrivono l'implementazione interna della
+variabile. address@hidden address@hidden essere utile per il debug. Per ora
viene
+restituita una versione formato testo dei flag per le variabili di
+tipo scalare, e il tipo di implementazione interna per i vettori.
+Per quest'interfaccia sono possibili variazioni in futuro, e quindi
+i valori restituiti possono non rimanere fissi.
+
@end ignore
@node Sommario invocazione
@@ -5435,6 +5492,7 @@ complesse.
@node Uso di @dfn{regexp}
@section Uso di espressioni regolari
address@hidden criteri di ricerca, espressioni regolari usate come
@cindex espressioni regolari, come criteri di ricerca
Un'espressione regolare address@hidden essere usata come modello di ricerca
racchiudendola tra barre. L'espressione regolare @`e quindi confrontata
@@ -5769,6 +5827,14 @@ letteramente, quando sono usati in costanti
@dfn{regexp}. Quindi,
detti @dfn{operatori di espressioni regolari} o @dfn{metacaratteri}, per
aumentarne il potere e la address@hidden
address@hidden
+* Dettagli sugli operatori di @dfn{regexp}:: Descrizione dettagliata.
+* Espressioni di intervallo:: Note sulle espressioni di
intervallo.
address@hidden menu
+
address@hidden Dettagli sugli operatori di @dfn{regexp}
address@hidden Operatori di @dfn{regexp} in @command{awk}
+
Le sequenze di protezione descritte
@ifnotinfo
prima
@@ -5955,6 +6021,28 @@ Riconosce soltanto @samp{whhhy}, @samp{whhhhy}, o
@samp{whhhhhy}.
@item address@hidden,@}y
Riconosce @samp{whhy}, @samp{whhhy} e address@hidden@dotless{i}} via.
@end table
address@hidden table
+
address@hidden precedenza, operatori @dfn{regexp}
address@hidden espressioni regolari, operatori, precedenza degli
+Nelle espressioni regolari, gli operatori @samp{*}, @samp{+}, e @samp{?},
+come pure le parentesi graffe @address@hidden e @address@hidden,
+hanno
+la precedenza address@hidden alta, seguite dalla concatenazione, e poi da
address@hidden|}.
+Come nell'algebra, le parentesi possono cambiare il raggruppamento degli
+operatori.
+
address@hidden POSIX @command{awk}, espressioni regolari e
address@hidden @command{gawk}, espressioni regolari, precedenza
+In POSIX @command{awk} e @command{gawk}, gli operatori @samp{*}, @samp{+}
+e @samp{?} rappresentano se stessi quando non c'@`e nulla prima di essi
+nella @dfn{regexp}. Per esempio, @code{/+/} individua un semplice segno
address@hidden Tuttavia, molte altre versioni di @command{awk} trattano una
+tale notazione come un errore di sintassi.
+
address@hidden Espressioni di intervallo
address@hidden Alcune note sulle espressioni di intervallo
@cindex POSIX @command{awk}, espressioni di intervallo in
Le espressioni di intervallo non erano tradizionalmente disponibili in
@@ -5983,34 +6071,23 @@ funzione.}
Infine, quando @address@hidden e @address@hidden appaiono in costanti
@dfn{regexp}
in un modo non interpretabile come espressione di intervallo
(come in @code{/address@hidden@}/}), allora sono prese letteralmente.
address@hidden table
address@hidden precedenza, operatore @dfn{regexp}
address@hidden espressioni regolari, operatori, precedenza di
-Nelle espressioni regolari, gli operatori @samp{*}, @samp{+}, e @samp{?},
-come pure le parentesi graffe @address@hidden e @address@hidden,
-hanno
-la precedenza address@hidden alta, seguiti dalla concatenazione, e infine da
@samp{|}.
-Come nell'algebra, le parentesi possono cambiare il raggruppamento degli
-operatori.
address@hidden POSIX @command{awk}, espressioni regolari e
address@hidden @command{gawk}, espressioni regolari, precedenza
-In POSIX @command{awk} e in @command{gawk}, gli operatori @samp{*},
address@hidden, e @samp{?} rappresentano se stessi quando non c'@`e nulla
-nella @dfn{regexp} che li precede. Per esempio, @code{/+/} individua un
-semplice segno address@hidden Comunque, molte altre versioni di @command{awk}
-trattano una simile notazione come un errore di sintassi.
+Come detto sopra, le espressioni di intervallo non erano tradizionalmente
+disponibili in @command{awk}. Con la versione di Marzo 2019 di
+BWK @command{awk} sono (finalmente) disponibili.
-Se @command{gawk} @`e in address@hidden compatibile (@pxref{Opzioni}), le
espressioni
-di intervallo non si possono usare nelle espressioni regolari.
+Ciononostante, non essendo state disponibili per parecchi decenni,
address@hidden continua a non renderle disponibili quando viene
+eseguito in address@hidden compatibile (@pxref{Opzioni}).
@node Espressioni tra parentesi quadre
@section Usare espressioni tra parentesi quadre
@cindex espressioni tra parentesi quadre
@cindex espressioni tra parentesi quadre, espressioni di intervallo
@cindex espressioni di intervallo, (@dfn{regexp})
address@hidden elenchi di caratteri in un'espressione regolare
address@hidden caratteri, elenchi di, in un'espressione regolare
address@hidden elenchi di caratteri in espressioni regolari
address@hidden caratteri, elenchi di, in espressioni regolari
address@hidden espressioni regolari, elenchi di caratteri in
Come detto sopra, un'espressione tra parentesi quadre individua qualsiasi
carattere incluso tra le parentesi quadre aperta e chiusa.
@@ -6117,6 +6194,28 @@ Con le classi di caratteri POSIX si address@hidden
scrivere
@code{/[[:alnum:]]/} per designare i caratteri alfabetici e numerici
dell'insieme di caratteri in uso.
address@hidden
+From address@hidden Fri Feb 15 03:38:41 2019
+Date: Fri, 15 Feb 2019 12:38:23 +0200
+From: Eli Zaretskii <address@hidden>
+To: address@hidden
+CC: address@hidden, address@hidden
+Subject: Re: [bug-gawk] Does gawk character classes follow this?
+
+> From: address@hidden
+> Date: Fri, 15 Feb 2019 03:01:34 -0700
+> Cc: address@hidden, address@hidden
+>
+> I get the feeling that there's something really bothering you, but
+> I don't understand what.
+>
+> Can you clarify, please?
+
+I thought I already did: we cannot be expected to provide a definitive
+description of what the named classes stand for, because the answer
+depends on various factors out of our control.
address@hidden ignore
+
@c Thanks to
@c Date: Tue, 01 Jul 2014 07:39:51 +0200
@c From: Hermann Peifer <address@hidden>
@@ -6130,7 +6229,7 @@ dell'insieme di caratteri ASCII. Usando una lista di
caratteri che esclude
sono nell'intervallo ASCII.
@quotation NOTA
-Alcune vecchie versioni Unix di @command{awk}
+Alcune vecchie versioni Unix di @command{awk}
trattano @code{[:blank:]} come @code{[:space:]}, individuando quindi
address@hidden caratteri del dovuto. Caveat Emptor! [Stia in guardia il
compratore!].
@end quotation
@@ -6776,6 +6875,7 @@ Questo @`e il motivo per cui i record sono, per default,
righe singole.
Per usare un diverso carattere come separatore di record
basta assegnare quel carattere alla variabile predefinita @code{RS}.
address@hidden separatore di record, ritorno a capo come
@cindex ritorno a capo, come separatore di record
@cindex a capo, come separatore di record
@cindex @code{RS}, variabile
@@ -6938,6 +7038,7 @@ elaborati.
@cindex @code{RT}, variabile
@cindex record, fine dei
@cindex differenze tra @command{awk} e @command{gawk}, separatori di record
address@hidden differenze tra @command{awk} e @command{gawk}, variabili
@code{RS}/@code{RT}
@cindex espressioni regolari, come separatori di record
@cindex record, separatori di, espressioni regolari come
@cindex separatori di record, espressioni regolari come
@@ -7020,6 +7121,9 @@ in cui possono essere presenti dei caratteri di ritorno a
capo.
@`E meglio address@hidden evitare metacaratteri di ancoraggio nel valore di
@code{RS}.
@end quotation
address@hidden @command{gawk}, variabile @code{RT} in
address@hidden @code{RT}, variabile
address@hidden variabile @code{RT}
@cindex differenze tra @command{awk} e @command{gawk}, variabili
@code{RS}/@code{RT}
L'uso di @code{RS} come espressione regolare e la variabile @code{RT} sono
estensioni @command{gawk}; non sono disponibili in
@@ -7065,8 +7169,10 @@ Capita che recenti versioni di @command{mawk} possano
usare i carattere
@command{mawk} non consente di includere caratteri @sc{NUL} nelle stringhe.
(address@hidden potrebbe cambiare in una versione futura di @command{mawk}.)
address@hidden record, trattare un file come un solo
address@hidden trattare un file, come un solo record
address@hidden record, trattare file come un solo
address@hidden trattare un file come un solo record
address@hidden record unico, trattare un file come un
address@hidden unico record, trattare un file come un
@xref{Funzione readfile} per un modo interessante di leggere
file interi. Se si usa @command{gawk}, si veda
@ref{Esempio di estensione Readfile} per un'altra opzione.
@@ -7486,7 +7592,7 @@ questo programma @command{awk} estrae e stampa la stringa
@address@hidden@address@hidden
@cindex separatori di campo, scelta dei
address@hidden espressioni regolari come separatori di campo
address@hidden espressioni regolari, come separatori di campo
@cindex separatori di campo, espressioni regolari come
A volte i dati in input contengono caratteri separatori che non
separano i campi nel modo in cui ci si sarebbe atteso. Per esempio, il
@@ -7510,6 +7616,7 @@ si possano manipolare con un programma @command{awk}
separato.)
@node Separatori di campo di default
@subsection Lo spazio vuoto normalmente separa i campi
address@hidden separatori di campo, spazi vuoti come
@cindex spazi vuoti, come separatori di campo
I campi sono separati normalmente da spazi vuoti
(spazi, tabulazioni e ritorni a capo), non solo da spazi singoli. Due spazi
@@ -7711,6 +7818,7 @@ awk -F\\\\ '@dots{}' file @dots{}
@end example
@noindent
address@hidden separatore di campo, @code{\} (barra inversa) come
@cindex @code{\} (barra inversa), come separatore di campo
@cindex barra inversa (@code{\}), come separatore di campo
Poich@'e @samp{\} @`e usato nella shell per proteggere caratteri, a
@command{awk}
@@ -8055,7 +8163,7 @@ schede @`e un'altra storia!)
@subsection Saltare campi intermedi
A partire dalla @value{PVERSION} 4.2, ogni specifica di una larghezza di campo
address@hidden essere facoltativamente preceduta da un valore, delimitato da
due punti
address@hidden essere opzionalmente preceduta da un valore, delimitato da due
punti
(@code{:}), che indica il numero di caratteri da saltare prima dell'inizio del
campo
successivo. Quindi, il programma precedente potrebbe essere riscritto per
specificare @code{FIELDWIDTHS} in questo modo:
@@ -8325,7 +8433,7 @@ per suddividere normali stringhe (@pxref{Funzioni per
stringhe}).
@cindex @command{gawk}, separazione in campi e
Come visto sopra, @command{gawk} fornisce tre metodi indipendenti per
dividere i record in input in campi. Il meccanismo utilizzato dipende da
-quale delle tre address@hidden, @code{FIELDWIDTHS} o
+quale delle tre address@hidden, @code{FIELDWIDTHS} o
@address@hidden stato definito per ultimo.
Inoltre, un analizzatore di input che utilizzi l'API (Application
Programming Interface) address@hidden scegliere di modificare il meccanismo di
@@ -8359,7 +8467,7 @@ else
Quest'informazione @`e utile se si sta scrivendo una funzione che
deve cambiare provvisoriamente @code{FS} o @code{FIELDWIDTHS}, leggere alcuni
record e poi ripristinare le inpostazioni originali. Si veda
-(@pxref{Funzioni Passwd} per un esempio si una funzione di questo tipo.
+(@pxref{Funzioni Passwd} per un esempio di una funzione di questo tipo.
@node Righe multiple
@section Record su righe multiple
@@ -8538,6 +8646,7 @@ standard POSIX.)
@cindex @command{gawk}, @code{RT} variabile in
@cindex @code{RT}, variabile
address@hidden differenze tra @command{awk} e @command{gawk}, variabili
@code{RS}/@code{RT}
Se non @`e eseguito in address@hidden di address@hidden (@pxref{Opzioni}),
@command{gawk} imposta @code{RT} al testo di input corrispondente
al valore specificato da @code{RS}.
@@ -9533,7 +9642,7 @@ print @var{elemento1}, @var{elemento2}, @dots{}
@end example
@noindent
-L'intera lista di elementi address@hidden facoltativamente essere racchiusa fra
+L'intera lista di elementi address@hidden opzionalmente essere racchiusa fra
parentesi. Le parentesi sono obbligatorie se qualche espressione presente
in uno degli elementi usa l'operatore relazionale @samp{>}, che potrebbe
essere confuso con una ridirezione dell'output (@pxref{Ridirezione}).
@@ -9839,7 +9948,7 @@ printf @var{formato}, @var{elemento1}, @var{elemento2},
@dots{}
@noindent
Come nel caso di @code{print}, l'intera lista degli argomenti address@hidden
-facoltativamente essere racchiusa fra
+opzionalmente essere racchiusa fra
parentesi. Anche qui, le parentesi sono obbligatorie se l'espressione di
qualche elemento usa l'operatore
relazionale @samp{>}, che potrebbe
@@ -9893,7 +10002,7 @@ una @dfn{lettera di controllo del formato}; e dice
all'istruzione
@code{printf} come stampare un elemento. La lettera di controllo del
formato specifica che @emph{tipo}
di valore stampare. Il resto dello specificatore di formato @`e costituito da
address@hidden facoltativi che controllano @emph{come} stampare il valore,
address@hidden opzionali che controllano @emph{come} stampare il valore,
per esempio stabilendo la larghezza del campo. Ecco una lista delle
lettere di controllo del formato:
@@ -9916,7 +10025,7 @@ estremamente non-portabile!
Inoltre, questi formati non sono disponibili su alcun sistema in cui
la funzione di libreria C @code{printf()} utilizzata da @command{gawk}
-non li supporta.
+non li supporta.
Al momento in cui questo libro @`e stato scritto, fra i sistemi su cui
@`e stato portato @command{gawk}, il solo sistema noto che
non li supporta @`e OpenVMS.
@@ -9979,7 +10088,7 @@ printf "%4.3f", 1950
@end example
@noindent
-stampa @samp{1950.000}, con un totale di quattro cifre significative, tre
+stampa @samp{1950.000}, con un minimo di quattro cifre significative, tre
delle quali vengono dopo il punto decimale.
(L'espressione @samp{4.3} rappresenta due modificatori,
introdotti nella prossima @value{SUBSECTION}).
@@ -10051,7 +10160,7 @@ avere valori speciali per rappresentare ``infinito''
(sia positivo che
negativo) e valori che sono ``non numerici'' (NaN - [Not a Number]).
L'input e l'output di tali valori avviene sotto forma di stringhe di
-testo. address@hidden pone dei problemi nel linguaggio @command{awk}, che
+testo. address@hidden pone dei problemi nel linguaggio @command{awk}, che
esisteva address@hidden prima della definizione dello standard IEEE. Dettagli
ulteriori si possono trovare in @ref{Problemi virgola mobile POSIX};
si prega di fare riferimento a quel testo.
@@ -11088,7 +11197,14 @@ quando chiude una @dfn{pipe}.
@node Continuazione dopo errori
@section Abilitare continuazione dopo errori in output
-Questa @value{SECTION} descrive una address@hidden specifica di @command{gawk}.
address@hidden
+Questa
address@hidden ifnotinfo
address@hidden
+Questo
address@hidden ifinfo
address@hidden descrive una address@hidden disponibile solo in
address@hidden
In @command{awk} standard, l'output con @code{print} o @code{printf}
a un file che non esiste, o qualche altro errore di I/O (come p.es.
@@ -11406,14 +11522,14 @@ In address@hidden POSIX (@pxref{Opzioni}),
@command{gawk} non consente
caratteri protetti di avanzamento riga. Altrimenti, il
comportamento @`e quello descritto sopra.
-BKW @command{awk} e Busybox @command{awk}
+BKW @command{awk} e BusyBox @command{awk}
tolgono la barra inversa, ma lasciano indisturbato il carattere
di avanzamento riga, che fa quindi parte della stringa:
@example
$ @kbd{nawk 'BEGIN @{ print "ciao, \}
> @kbd{mondo" @}'}
address@hidden ciao,
address@hidden ciao,
@print{} mondo
@end example
@@ -11692,7 +11808,8 @@ Questa
@ifinfo
Questo
@end ifinfo
address@hidden descrive una address@hidden specifica di @command{gawk}.
address@hidden descrive una address@hidden disponibile solo in
address@hidden
Come visto
@iftex
@@ -11726,6 +11843,7 @@ sarebbe bello poter avere costanti @dfn{regexp} che sono
una @dfn{regexp} utile per effettuare dei confronti,
e non una semplice espressione regolare.
address@hidden valori, @dfn{regexp}
@command{gawk} prevede questa address@hidden Un'espressione regolare
fortemente tipizzata @`e molto simile a un'espressione regolare normale,
tranne per il fatto di essere preceduta dal simbolo @samp{@@}:
@@ -11941,7 +12059,7 @@ gawk -v 're1=@/pippo|pluto/' '@dots{}'
/percorso/al/file1 're2=@/ciao|salve/' /p
@noindent
Le costanti @dfn{regexp} fortemente tipizzate sono un'altra
address@hidden avanzata disponibile
-(@pxref{costanti @dfn{regexp} fortemente tipizzate}).
+(@pxref{Costanti @dfn{regexp} forti}).
Sono ricordate qui solo per completezza.
@node Conversione
@@ -12564,7 +12682,7 @@ BEGIN @{
for (x in pippo)
print x, pippo[x]
@end group
-
+
@group
pluto[rand()] = pluto[rand()] + 5
for (x in pluto)
@@ -12776,7 +12894,7 @@ come valore dell'espressione.
@sidebar Ordine di valutazione degli operatori
@cindex precedenza
address@hidden operatori, precedenza
address@hidden operatori, precedenza degli
@cindex address@hidden, operatori
@cindex valutazione, ordine di
@cindex Marx, Groucho
@@ -13933,6 +14051,8 @@ Appartenenza a un vettore.
@cindex @code{?} (punto interrogativo), operatore @code{?:}
@cindex punto interrogativo (@code{?}), operatore @code{?:}
address@hidden @code{:} (due punti), operatore @code{?:}
address@hidden due punti (@code{:}), operatore @code{?:}
@item @code{?:}
Operatore condizionale. Questo operatore raggruppa da destra verso sinistra.
@@ -14167,7 +14287,7 @@ Il criterio di ricerca vuoto corrisponde a ciascun
record in input.
@node @dfn{regexp} come criteri di ricerca
@subsection Espressioni regolari come criteri di ricerca
address@hidden criteri di ricerca, espressioni come
address@hidden criteri di ricerca, espressioni regolari come
@cindex espressioni regolari, come criteri di ricerca
Le espressioni regolari sono uno dei primi tipi di criteri di ricerca
@@ -14187,6 +14307,7 @@ END @{ print personaggi_Disney, "Personaggi
Disney visti" @}
@node Espressioni come criteri di ricerca
@subsection Espressioni come criteri di ricerca
@cindex espressioni regolari, come criteri di ricerca
address@hidden criteri di ricerca, espressioni regolari come
Qualsiasi espressione @command{awk} address@hidden essere usata come un
criterio di
ricerca @command{awk}.
@@ -14242,6 +14363,7 @@ viene trovato nel record in input corrente. Quindi,
come criterio di ricerca,
@code{/li/} individua tutti i record che contengono la stringa @samp{li}.
@cindex espressioni booleane, come criteri di ricerca
address@hidden criteri di ricerca, espressioni booleane come
Anche le espressioni booleane sono frequentemente usate come criteri di
ricerca. Se un criterio di ricerca
individua o no un record in input dipende dalla verifica delle
@@ -14575,7 +14697,14 @@ Analogamente, tali istruzioni non sono valide
all'interno di una regola
@cindex @code{ENDFILE}, criterio di ricerca
@cindex differenze tra @command{awk} e @command{gawk}, criteri di ricerca
@code{BEGINFILE}/@code{ENDFILE}
-Questa @value{SECTION} descrive una address@hidden specifica di @command{gawk}.
address@hidden
+Questa
address@hidden ifnotinfo
address@hidden
+Questo
address@hidden ifinfo
address@hidden descrive una address@hidden disponibile solo in
address@hidden
Due tipi speciali di criterio di ricerca, @code{BEGINFILE} ed @code{ENDFILE},
forniscono
@@ -14769,7 +14898,7 @@ apici.
@node Panoramica sulle azioni
@section Azioni
address@hidden @cindex action, definition of
address@hidden @cindex action, definizione di
@c @cindex curly braces
@c @cindex action, curly braces
@c @cindex action, separating statements
@@ -14933,7 +15062,7 @@ dell'istruzione. Se la @var{condizione} @`e vera,
viene eseguita la
parte @var{se-vera-fai}; altrimenti viene
eseguita la parte @var{se-falsa-fai}.
La parte @code{else} dell'istruzione @`e
-facoltativa. La condizione @`e considerata falsa se il suo valore @`e zero o
+opzionale. La condizione @`e considerata falsa se il suo valore @`e zero o
la stringa nulla; altrimenti, la condizione @`e vera.
Si consideri quanto segue:
@@ -15207,7 +15336,13 @@ per maggiori informazioni su questa versione del ciclo
@code{for}.
@cindex @code{default}, parola chiave
@cindex parola chiave @code{default}
-Questa @value{SECTION} descrive una address@hidden disponibile solo in
address@hidden
+Questa
address@hidden ifnotinfo
address@hidden
+Questo
address@hidden ifinfo
address@hidden descrive una address@hidden disponibile solo in
@command{gawk}.
Se @command{gawk} @`e in address@hidden compatibile (@pxref{Opzioni}),
la address@hidden non @`e disponibile.
@@ -15762,7 +15897,7 @@ Una lista di posizioni di colonna, separate da spazi,
per dire a
@command{gawk}
come dividere campi in input posti su colonne fisse.
A partire dalla @value{PVERSION} 4.2, ogni lunghezza di campo address@hidden
essere
-facoltativamente preceduta da un valore, separato da due punti (@code{:})
+opzionalmente preceduta da un valore, separato da due punti (@code{:})
che specifica il numero di caratteri da ignorare prima dell'inizio del campo.
Assegnando un valore a @code{FIELDWIDTHS}, le variabili @code{FS} e
@code{FPAT}
@@ -15828,8 +15963,8 @@ Un modo semplice per fare questo
@cindex @code{IGNORECASE}, variabile
@cindex variabile @code{IGNORECASE}
@cindex differenze tra @command{awk} e @command{gawk}, variabile
@code{IGNORECASE}
address@hidden maiuscolo/minuscolo e confronti tra stringhe
address@hidden maiuscolo/minuscolo e @dfn{regexp}
address@hidden maiuscolo/minuscolo, confronti tra stringhe e
address@hidden maiuscolo/minuscolo, @dfn{regexp} e
@cindex espressioni regolari, maiuscolo/minuscolo
@item IGNORECASE #
Se la variabile @code{IGNORECASE} @`e diversa da zero o dalla stringa nulla,
@@ -15894,7 +16029,6 @@ usavano @code{OFMT} per specificare il formato da usare
per convertire
numeri in stringhe in espressioni generali; questo compito @`e ora svolto
da @code{CONVFMT}.
address@hidden @code{sprintf()}, funzione, variabile @code{OFMT} e
@cindex funzione @code{sprintf()}, variabile @code{OFMT} e
@cindex @code{print}, istruzione, variabile @code{OFMT} e
@cindex istruzione @code{print}, variabile @code{OFMT} e
@@ -16219,7 +16353,8 @@ sono sicuramente sempre disponibili:
@table @code
@item PROCINFO["argv"]
address@hidden argomenti, riga di comando, @code{PROCINFO["argv"]}
address@hidden argomenti, riga di comando
address@hidden riga di comando, argomenti
Il vettore @code{PROCINFO["argv"]} contiene tutti gli argomenti della riga di
comando (dopo che l'eventuale elaborazione di valutazione e ridirezione,
nelle piattaforme in cui address@hidden debba essere fatto a cura del
programma), con
@@ -16301,16 +16436,13 @@ dopo aver finito l'analisi iniziale del programma;
questi valori @emph{non}
vengono address@hidden aggiornati durante l'esecuzione del programma.
@item PROCINFO["platform"]
address@hidden piattaforma di esecuzione, @code{PROCINFO["platform"]}
address@hidden piattaforma di esecuzione
Quest'elemento restituisce una stringa che indica la piattaforma
per la quale @command{gawk} @`e stato compilato. Il valore address@hidden
uno dei seguenti:
@c nested table
@table @code
address@hidden "vms"
-OpenVMS o Vax/VMS.
-
@item "djgpp"
@itemx "mingw"
Microsoft Windows, utilizzando DJGPP o MinGW, rispettivamente.
@@ -16323,6 +16455,9 @@ OS/390.
@item "posix"
GNU/Linux, Cygwin, Mac OS X, e sistemi Unix tradizionali.
+
address@hidden "vms"
+OpenVMS o Vax/VMS.
@end table
@item PROCINFO["pgrpid"]
@@ -16474,7 +16609,7 @@ individuata, oppure zero, se non @`e stata trovata
alcuna corrispondenza.
@cindex @command{gawk}, variabile @code{RT} in
@cindex @code{RT}, variabile
@cindex variabile @code{RT}
address@hidden differenze tra @command{awk} e @command{gawk}, variabile
@code{RT}
address@hidden differenze tra @command{awk} e @command{gawk}, variabili
@code{RS}/@code{RT}
@item @code{RT #}
Il testo in input che corrisponde al testo individuato da @code{RS},
il separatore di record. Questa variabile viene impostata dopo aver letto
@@ -17157,8 +17292,8 @@ lo converte automaticamente in una stringa.
@cindex @command{gawk}, variabile @code{IGNORECASE} in
@cindex maiuscolo/minuscolo, distinzione, indici dei vettori e
@cindex vettori, ordinamento, variabile @code{IGNORECASE} e
address@hidden @code{IGNORECASE}, variabile, e indici dei vettori
address@hidden variabile @code{IGNORECASE}, e indici dei vettori
address@hidden @code{IGNORECASE}, variabile, indici dei vettori e
address@hidden variabile @code{IGNORECASE}, indici dei vettori e
Il valore di @code{IGNORECASE} non ha alcun effetto sull'indicizzazione dei
vettori. Lo stesso valore di stringa usato per memorizzare un elemento di un
vettore address@hidden essere usato per richiamarlo.
@@ -17487,7 +17622,13 @@ $ @kbd{nawk -f vediciclo.awk}
@node Controllare visita
@subsection Visita di vettori in ordine predefinito con @command{gawk}
-Questa @value{SUBSECTION} descrive una address@hidden disponibile solo in
address@hidden
+Questa
address@hidden ifnotinfo
address@hidden
+Questo
address@hidden ifinfo
address@hidden descrive una address@hidden disponibile solo in
@command{gawk}.
Per default, quando un ciclo @code{for} visita un vettore, l'ordine
@@ -17658,9 +17799,10 @@ dei vettori; si veda @ref{Funzioni di ordinamento di
vettori}.
@section Usare numeri per indicizzare i vettori
@cindex numeri, come indici di vettore
address@hidden vettori, indici numerici di
@cindex indici di vettori, numeri come
address@hidden @code{CONVFMT}, variabile, e indici di vettore
address@hidden vettori, indici numerici di
address@hidden variabile @code{CONVFMT}, indici di vettore e
address@hidden @code{CONVFMT}, variabile, indici di vettore e
Un aspetto importante da ricordare riguardo ai vettori @`e che
@emph{gli indici dei vettori sono sempre stringhe}.
Quando un valore numerico @`e usato come indice,
@@ -17776,6 +17918,7 @@ Qui, @samp{++} forza @code{righe} a essere di tipo
numerico, rendendo
quindi il ``vecchio valore'' uno zero numerico. Questo viene poi convertito
in @code{"0"} come l'indice del vettore.
address@hidden indici di vettore, stringhe nulle come
@cindex nulle, stringhe, come indici di vettore
@cindex stringhe nulle, come indici di vettore
@cindex angolo buio, indici di vettori
@@ -17826,8 +17969,8 @@ if (4 in pippo)
print "Questo non address@hidden mai stampato"
@end example
address@hidden nulle, stringhe, ed eliminazione di elementi di un vettore
address@hidden stringhe nulle, ed eliminazione di elementi di un vettore
address@hidden nulle, stringhe, eliminazione di elementi di un vettore e
address@hidden stringhe nulle, eliminazione di elementi di un vettore e
@`E importante notare che eliminare un elemento @emph{non} @`e la stessa cosa
che assegnargli un valore nullo (la stringa vuota, @code{""}).
Per esempio:
@@ -17927,8 +18070,8 @@ molti linguaggi, compreso @command{awk}) per far
riferimento a un elemento di
un vettore multidimensionale chiamato @code{griglia} @`e con
@address@hidden,@var{y}]}.
address@hidden @code{SUBSEP}, variabile, e vettori multidimensionali
address@hidden variabile @code{SUBSEP}, e vettori multidimensionali
address@hidden @code{SUBSEP}, variabile, vettori multidimensionali e
address@hidden variabile @code{SUBSEP}, vettori multidimensionali e
I vettori multidimensionali sono resi disponibili in @command{awk} attraverso
la concatenazione di address@hidden indici in una stringa;
@command{awk} converte gli indici in stringhe
@@ -18435,7 +18578,7 @@ funzione @code{atan2()} @`e chiamata con i due
argomenti 11 e 10.
La seguente lista descrive tutte le
funzioni predefinite che hanno a che fare con i numeri.
-I parametri facoltativi sono racchiusi tra parentesi address@hidden ([ ]):}
+I parametri opzionali sono racchiusi tra parentesi address@hidden ([ ]):}
@c @asis for docbook
@table @asis
@@ -18503,20 +18646,26 @@ implementano lo standard IEEE 754.
Inoltre, @command{gawk} stampa un messaggio di avvertimento qualora @code{x}
sia negativo.
address@hidden Beebe, Nelson H.F.@:
@item @code{rand()}
@cindexawkfunc{rand}
@cindex numeri casuali, funzioni @code{rand()}/@code{srand()}
Restituisce un numero casuale. I valori di @code{rand()} sono
uniformemente distribuiti tra zero e uno.
Il valore potrebbe essere zero ma non @`e mai address@hidden versione C di
address@hidden()} in molti sistemi Unix
-produce notoriamente delle sequenze piuttosto mediocri di numeri casuali.
-Tuttavia, non @`e prescritto che un'implementazione di @command{awk}
-debba usare la funzione @code{rand()} del linguaggio C per implementare
-la versione @command{awk} di @code{rand()}.
-In effetti, @command{gawk} usa, per generare numeri casuali,
-la funzione @code{random()} di BSD, che @`e
-notevolmente migliore di @code{rand()}}
address@hidden()} in molti sistemi Unix genera notoriamente delle sequenze
+piuttosto mediocri di numeri casuali. Tuttavia, non @`e scritto da nessuna
+parte che un'implementazione di @command{awk} debba necessariamente
+usare la funzione @code{rand()} del linguaggio C per implementare
+la versione @command{awk} di @code{rand()}. In effetti, @command{gawk}
+ha usato per parecchi anni la funzione @code{random()} di BSD, che @`e
+notevolmente migliore di @code{rand()}, per generare dei numeri casuali.
+Dalla @value{PVERSION} 4.1.4, grazie al contributo di Nelson H.F.@:
+Beebe, @command{gawk} usa l'algoritmo di rimescolamento nella scatola
+di Bayes-Durham, che estende in maniera notevole il periodo dopo il
+quale i numeri si ripetono ed elimina le correlazioni a breve distanza
+e a lunga distanza che potrebbero esistere nel generatore originale
+di numeri casuali.}
Spesso servono dei numeri casuali interi invece che frazionari.
La seguente funzione definita dall'utente address@hidden essere usata per
ottenere
@@ -18641,7 +18790,7 @@ zero. @`E importante ricordarlo quando si fanno
calcoli sugli indici, in
particolare se si ha address@hidden con il linguaggio C.
@end quotation
-Nella lista seguente, i parametri facoltativi sono racchiusi tra parentesi
+Nella lista seguente, i parametri opzionali sono racchiusi tra parentesi
address@hidden ([ ]).}
Parecchie funzioni operano sostituzioni in una stringa; la spiegazione
completa di address@hidden @`e contenuta nella descrizione della funzione
@code{sub()},
@@ -18914,7 +19063,7 @@ avvertimento a questo riguardo.
@cindex estensioni comuni, @code{length()} applicato a un vettore
@cindex comuni, address@hidden @code{length()} applicato a un vettore
address@hidden differenze tra @command{gawk} e @command{awk}
address@hidden differenze tra @command{gawk} e @command{awk}, funzione
@code{length()}
@cindex numero di elementi di un vettore
@cindex vettore, determinare il numero degli elementi
In @command{gawk} e in parecchie altre implementazioni @command{awk},
@@ -19780,7 +19929,7 @@ da fare delle sostituzioni.
@cindex funzioni di input/output
Le seguenti funzioni riguardano l'input/output (I/O).
-I parametri facoltativi sono racchiusi tra parentesi quadre ([ ]):
+I parametri opzionali sono racchiusi tra parentesi quadre ([ ]):
@table @asis
@item @code{close(address@hidden address@hidden,} @address@hidden)}
@@ -20143,7 +20292,7 @@ non sono previste nello standard address@hidden comando
di address@hidden GNU
@command{date} address@hidden fare anche molte delle cose qui descritte.
address@hidden essere
preferibile usarlo per semplici operazioni relative a data e ora in semplici
script della shell.} Tuttavia, anche versioni recenti di @command{mawk}
-(@pxref{Altre versioni}) prevedono queste funzioni. I parametri facoltativi
+(@pxref{Altre versioni}) prevedono queste funzioni. I parametri opzionali
sono racchiusi tra parentesi quadre ([ ]):
@c @asis for docbook
@@ -20673,7 +20822,7 @@ Partendo nuovamente da @samp{10111001} e spostandolo a
sinistra di tre
bit, si ottiene @samp{11001000}. La lista seguente descrive
le funzioni predefinite di @command{gawk} che rendono disponibili
le operazioni a livello di bit.
-I parametri facoltativi sono racchiusi tra parentesi quadre ([ ]):
+I parametri opzionali sono racchiusi tra parentesi quadre ([ ]):
@cindex @command{gawk}, operazioni a livello di bit in
@table @asis
@@ -20803,7 +20952,7 @@ $ @kbd{gawk -f testbits.awk}
@cindex stringhe, conversione
@cindex numeri, conversione in stringhe
@cindex conversione da numeri a stringhe
address@hidden numero visto come stringa di bit
address@hidden numeri, visti come stringhe di bit
La funzione @code{bits2str()} trasforma un numero binario in una stringa.
Inizializzando @code{maschera} a uno otteniamo
un valore binario in cui il bit address@hidden a destra @`e impostato a
@@ -20999,7 +21148,7 @@ Questi sono costituiti dalle funzioni descritte nella
lista seguente.
Le descrizioni sono volutamente concise.
@xref{Internazionalizzazione},
per un'esposizione completa.
-I parametri facoltativi sono racchiusi tra parentesi quadre ([ ]):
+I parametri opzionali sono racchiusi tra parentesi quadre ([ ]):
@table @asis
@cindexgawkfunc{bindtextdomain}
@@ -21055,6 +21204,7 @@ ma dipende dall'utente la loro definizione
significano.
* Esempio di funzione:: Un esempio di definizione di
funzione e spiegazione della stessa.
+* Chiamata di una funzione:: Chiamare funzioni definite dall'utente.
* Precisazioni sulle funzioni:: Cose a cui prestare attenzione.
* Istruzione return:: Specificare il valore che una
funzione restituisce.
@@ -21361,7 +21511,7 @@ come stringa di formato. Sarebbe un errore, perch@'e
si suppone che
e qualche codice a livello utente potrebbe aver modificato in precedenza
@code{PROCINFO["strftime"]}.
address@hidden Precisazioni sulle funzioni
address@hidden Chiamata di una funzione
@subsection Chiamare funzioni definite dall'utente
@cindex funzioni definite dall'utente, chiamare
@@ -21374,7 +21524,8 @@ restituito dalla funzione.
@menu
* Chiamare una funzione:: Non usare spazi.
* Campo di address@hidden variabili:: Variabili locali e globali.
-* Parametri per valore/riferimento:: Passaggio parametri.
+* Parametri per valore/riferimento:: Passaggio parametri.
+* Precisazioni sulle funzioni:: Cose a cui prestare attenzione.
@end menu
@node Chiamare una funzione
@@ -21629,6 +21780,9 @@ stampa @samp{a[1] = 1, a[2] = due, a[3] = 3}, perch@'e
@code{cambialo()} memorizza @code{"due"} nel secondo elemento di @code{a}.
@end quotation
address@hidden Precisazioni sulle funzioni
address@hidden Cose a cui prestare attenzione
+
@cindex indefinite, funzioni
@cindex funzioni indefinite
Alcune implementazioni di @command{awk} consentono di chiamare una
@@ -21678,6 +21832,42 @@ o @code{nextfile}
all'interno di una funzione definita dall'utente.
@command{gawk} non ha questa limitazione.
address@hidden possibile chiamare una funzione specificando parametri in
address@hidden rispetto
+a quelli che la funzione si aspetta, come p.es.:
+
address@hidden
+function pippo(p1, p2)
address@hidden
+ @dots{}
address@hidden
+
+BEGIN @{
+ pippo(1, 2, 3, 4)
address@hidden
address@hidden example
+
+Fare questo, tuttavia, @`e una pratica sconsigliata. La funzione chiamata
+potrebbe fare qualsiasi cosa con i valori ulteriori che le vengono passati,
+quindi @command{awk} calcola le espressioni richieste, per poi non
+utilizzarle affatto.
+
address@hidden inoltre ancora address@hidden importante notare che una simile
chiamata di funzione
address@hidden essere causa di confusione per la persona che potrebbe leggere in
+seguito il programma in address@hidden persona potresti
+anche essere tu, dopo qualche tempo, e a quel punto ti domanderesti
+``cosa stavo pensando?!?''}
+I parametri di una funzione sono generalmente elementi dell'input che
+influenzano l'elaborazione eseguita dalla funzione. Chiamare una funzione
+con address@hidden parametri del necessario potrebbe comunicare la falsa
impressione
+che quei valori siano importanti per la funzione, mentre in address@hidden non
+lo sono affatto.
+
+Poich@'e questa pratica non @`e affatto raccomandabile, @command{gawk}
+manda @emph{sempre} un messaggio di avvertimento quando si trova a
+eseguire una tale chiamata di funzione. (Se non si vuole ricevere
+il messaggio, occorre modificare il codice! In fondo, non @`e
+corretto).
+
@node Istruzione return
@subsection L'istruzione @code{return}
@cindex @code{return}, address@hidden in funzioni definite dall'utente
@@ -21696,7 +21886,7 @@ Questo @`e un esempio:
@code{return} address@hidden
@end display
-La parte @var{espressione} @`e facoltativa.
+La parte @var{espressione} @`e opzionale.
Probabilmente per una svista, POSIX non definisce qual @`e il valore
restituito, se si omette @var{espressione}. Tecnicamente parlando, questo
rende il valore restituito indefinito, e quindi, indeterminato.
@@ -22563,6 +22753,12 @@ Le convenzioni illustrate in questa @value{SECTION}
sono esattamente
quello che indica il termine: convenzioni. Non si @`e obbligati a scrivere
i propri programmi in questo modo: @`e solo auspicabile che lo si faccia.
+A partire dalla @value{PVERSION} 5.0, @command{gawk} fornisce
+un meccanismo efficiente per risolvere i problemi descritti in
+questa sezione: gli spazi-dei-nomi (@dfn{spazi-dei-nomi}).
+Gli spazi-dei-nomi e il loro utilizzo sono descritti in dettaglio
+in @ref{Spazi-dei-nomi}.
+
@node Funzioni di tipo generale
@section Programmazione di tipo generale
@@ -22976,7 +23172,7 @@ non vi @`e nessun reale motivo per inglobarle come
funzioni predefinite
@c file eg/lib/ord.awk
# ord.awk --- implementa ord e chr
-# Identificatori globali:
+# Identificativi globali:
# _ord_: valori numerici indicizzati da caratteri
# _ord_init: funzione per inizializzare _ord_
@c endfile
@@ -24668,7 +24864,7 @@ usa queste funzioni.
@cindex funzioni, libreria di, leggere la lista dei gruppi
@cindex gruppi, lista dei, leggere la
@cindex lista dei gruppi, leggere la
address@hidden @code{PROCINFO}, vettore, e appartenenza a gruppi
address@hidden @code{PROCINFO}, vettore, appartenenza a gruppi e
@cindex @code{getgrent()}, funzione (libreria C)
@cindex funzione @code{getgrent()} (libreria C)
@cindex @code{getgrent()}, funzione definita dall'utente
@@ -26086,7 +26282,8 @@ $ @kbd{id}
@print{} uid=1000(arnold) gid=1000(arnold)
groups=1000(arnold),4(adm),7(lp),27(sudo)
@end example
address@hidden @code{PROCINFO}, vettore, e @dfn{process ID} di utente e di
gruppo
address@hidden @code{PROCINFO}, vettore, @dfn{process ID} di utente e di gruppo
e
address@hidden vettore @code{PROCINFO}, @dfn{process ID} di utente e di gruppo e
Questa informazione @`e parte di address@hidden che @`e reso disponibile dal
vettore
@code{PROCINFO} di @command{gawk} (@pxref{Variabili predefinite}).
Comunque, il programma di address@hidden @command{id} fornisce un output
address@hidden
@@ -26768,12 +26965,10 @@ END @{
@c endfile
@end example
address@hidden FIXME: Include this?
address@hidden
-This program does not follow our recommended convention of naming
-global variables with a leading capital letter. Doing that would
-make the program a little easier to follow.
address@hidden ignore
+Incidentalmente, questo programma non segue la convenzione,
+raccomandabile, di assegnare alle variabili globali un nome
+con la lettera iniziale maiuscola. Se lo si fosse fatto, il programma
+sarebbe stato un po' address@hidden semplice da comprendere.
@ifset FOR_PRINT
La logica per scegliere quali righe stampare rappresenta una @dfn{macchina a
@@ -29161,6 +29356,9 @@ Contiene i seguenti capitoli:
@itemize @value{BULLET}
@item
address@hidden di nomi}
+
address@hidden
@address@hidden avanzate}
@item
@@ -29357,7 +29555,7 @@ durante un ciclo @code{for}.
Inoltre, il valore di @code{PROCINFO["sorted_in"]} address@hidden essere un
nome di
address@hidden @`e il motivo per cui gli ordinamenti predefiniti
iniziano con il carattere @samp{@@}, che non address@hidden essere usato in un
-identificatore.}
+identificativo.}
Questo consente di scorrere un vettore sulla base di un qualsiasi criterio
personalizzato. Gli elementi del vettore vengono ordinati in accordo col valore
ritornato da questa funzione. La funzione che fa il confronto dovrebbe essere
@@ -29730,8 +29928,8 @@ valori che esiste in memoria.
@c Document It And Call It A Feature. Sigh.
@cindex @command{gawk}, variabile @code{IGNORECASE} in
@cindex vettori, ordinamento, variabile @code{IGNORECASE} e
address@hidden @code{IGNORECASE}, variabile, e funzioni di ordinamento dei
vettori
address@hidden variabile @code{IGNORECASE}, e funzioni di ordinamento dei
vettori
address@hidden @code{IGNORECASE}, variabile, funzioni di ordinamento dei
vettori e
address@hidden variabile @code{IGNORECASE}, funzioni di ordinamento dei vettori
e
Poich@'e @code{IGNORECASE} influenza i confronti tra stringhe, il valore di
@code{IGNORECASE} influisce anche sull'ordinamento sia con @code{asort()} che
con @code{asorti()}.
@@ -29997,7 +30195,8 @@ o @code{getline}.
@end quotation
@cindex @command{gawk}, vettore @code{PROCINFO} in
address@hidden @code{PROCINFO}, vettore, e comunicazioni attraverso le @dfn{pty}
address@hidden @code{PROCINFO}, vettore, comunicazioni attraverso le @dfn{pty} e
address@hidden vettore @code{PROCINFO}, comunicazioni attraverso le @dfn{pty} e
Per le comunicazioni bidirezionali si possono anche usare delle pseudo
@dfn{tty}
(@dfn{pty}) al posto delle @dfn{pipe}, se il sistema in uso le prevede.
Questo vien fatto, a seconda del comando da usare, impostando un elemento
@@ -30052,16 +30251,16 @@ semplice, che address@hidden svolgere tale funzione:
@example
$ @kbd{cat add.c}
-#include <stdio.h>
-
-int
-main(void)
address@hidden
- int x, y;
- while (scanf("%d %d", & x, & y) == 2)
- printf("%d\n", x + y);
- return 0;
address@hidden
+#include <stdio.h>
+
+int
+main(void)
address@hidden
+ int x, y;
+ while (scanf("%d %d", & x, & y) == 2)
+ printf("%d\n", x + y);
+ return 0;
address@hidden
$ @kbd{cc -O add.c -o add} @ii{Compilazione del programma}
@end example
@@ -30076,13 +30275,13 @@ $ @kbd{echo 1 2 |}
E il programma andrebbe in stallo, poich@'e, @file{add.c} non chiama a sua
volta @samp{setlinebuf(stdout)}. Il programma @command{add} si blocca.
-Ora, si provi invece con:
+Ora, si provi invece con:
@example
$ @kbd{echo 1 2 |}
> @kbd{gawk -v cmd=add 'BEGIN @{ PROCINFO[cmd, "pty"] = 1 @}}
> @kbd{ @{ print |& cmd; cmd |& getline x; print x @}'}
address@hidden 3
address@hidden 3
@end example
Usando una @dfn{pty}, @command{gawk} fa address@hidden@dotless{i}} che la
libreria di I/O
@@ -30303,10 +30502,10 @@ del profilatore di @command{gawk} su questo programma
e sui dati (quest'esempio
dimostra anche che i programmatori di @command{awk} a volte si alzano molto
presto al mattino per lavorare):
address@hidden @code{BEGIN}, criterio di ricerca, e profilatura
address@hidden criterio di ricerca @code{BEGIN}, e profilatura
address@hidden @code{END}, criterio di ricerca, e profilatura
address@hidden criterio di ricerca @code{END}, e profilatura
address@hidden @code{BEGIN}, criterio di ricerca, profilazione e
address@hidden criterio di ricerca @code{BEGIN}, profilazione e
address@hidden @code{END}, criterio di ricerca, profilazione e
address@hidden criterio di ricerca @code{END}, profilazione e
@example
# profilo gawk, creato Mon Sep 29 05:16:21 2014
@@ -30399,8 +30598,8 @@ o @code{while}) mostra quante volte il test del ciclo
@`e stato eseguito.
istruzione in una regola per determinare quante volte la regola @`e stata
eseguita. Se la prima istruzione @`e un ciclo, il conteggio @`e ingannevole.)
address@hidden funzioni definite dall'utente, conteggi, in un profilo
address@hidden definite dall'utente, funzioni, conteggi, in un profilo
address@hidden funzioni definite dall'utente, address@hidden in un profilo
address@hidden definite dall'utente, funzioni, address@hidden in un profilo
@item
Per le funzioni definite dall'utente, il conteggio vicino alla parola chiave
@code{function} indica quante volte la funzione @`e stata chiamata.
@@ -30542,6 +30741,7 @@ tastiera. Il segnale @code{INT} @`e generato dalle
combinazioni di tasti
@kbd{Ctrl-c} o @kbd{Ctrl-BREAK}, mentre il segnale
@code{QUIT} @`e generato dalla combinazione di tasti @kbd{Ctrl-\}.
address@hidden stampa elegante
Infine, @command{gawk} accetta anche un'altra opzione, @option{--pretty-print}.
Quando viene chiamato in questo modo, @command{gawk} fa una ``stampa elegante''
del programma nel file @file{awkprof.out}, senza conteggi sull'esecuzione.
@@ -30551,6 +30751,8 @@ Una volta, l'opzione @option{--pretty-print} eseguiva
anche il programma.
Ora non address@hidden
@end quotation
address@hidden profilazione, differenza rispetto alla stampa elegante
address@hidden stampa elegante, differenza rispetto alla profilazione
C'@`e una differenza significativa tra l'output creato durante la profilazione,
e quello creato durante la stampa elegante. L'output della stampa elegante
preserva i commenti originali che erano nel programma, anche se la loro
@@ -30572,12 +30774,12 @@ del proprio codice una volta completato lo sviluppo,
usando poi il risultato
come versione finale del programma.
Poich@'e la rappresentazione interna del programma @`e formattata per
-essere aderente al programma @command{awk} in questione, la profilatura
-e la formattazione graziosa (opzione @option{--pretty-print}) disabilitano
+essere aderente al programma @command{awk} in questione, la profilazione
+e la stampa elegante (opzione @option{--pretty-print}) disabilitano
automaticamente le optimizzazioni di default di @command{gawk}.
-La formattazione elegante mantiene anche il formato originale delle
-costanti numeriche; se sono stati usati dei valori ottali o esadecimali
+La profilazione e la stampa elegante mantengono anche il formato originale
+delle costanti numeriche; se sono stati usati dei valori ottali o esadecimali
nel codice sorgente, questi compariranno nell'output nello stesso
formato con cui sono stati inseriti.
@@ -31152,7 +31354,6 @@ in fase di esecuzione.
@node Estrazione di stringhe
@subsection Estrarre stringhe marcate
@cindex stringhe, estrazione di
address@hidden stringhe marcate, estrazione di
@cindex @option{--gen-pot}, opzione
@cindex opzione @option{--gen-pot}
@cindex opzioni sulla riga di comando, estrazione stringhe
@@ -31224,7 +31425,7 @@ in fase di esecuzione, non @`e in grado di cambiare
l'ordine degli argomenti
nella chiamata a @code{printf}.
Per risolvere questo problema, gli specificatori di formato di @code{printf}
-possono avere un elemento in address@hidden, facoltativo, detto
@dfn{specificatore
+possono avere un elemento in address@hidden, opzionale, detto
@dfn{specificatore
posizionale}. Per esempio:
@example
@@ -31472,15 +31673,36 @@ msgstr "Like, the scoop is"
@cindex Linux
@cindex GNU/Linux
address@hidden NOTA
+Le istruzione che seguono valgono per un ambiente GNU/Linux con la
+Libreria GNU C. Fate attenzione! I passi descritti possono
+variare col tempo, e la descrizione seguente address@hidden non essere accurata
+per tutte le distribuzione GNU/Linux, e la procedura address@hidden essere
+interamente differente per altri sistemi operativi.
address@hidden quotation
+
Il passo successivo @`e di creare la directory che contenga il file binario
con le traduzioni dei messaggi (file .mo [message object]) e
creare in quella directory il file @file{guide.mo}.
-Si presume che il file in questione debba essere usato nella localizzazione
address@hidden, perch@'e si deve usare un nome di localizzazione che sia
-noto alle routine del comando C @command{gettext}.
-La disposizione delle directory qui utilizzata @`e standard per il comando
-GNU @command{gettext} sui sistemi GNU/Linux. Altre versioni di
address@hidden possono usare una disposizione differente:
+La directory ha un nome del tipo @address@hidden/LC_MESSAGES}, dove
address@hidden @`e un nome di localizzazione noto alle routine C
+di @command{gettext}.
+
+Come sapere quale localizzazione usare? Le routine C di @command{gettext}
+usano quattro variabili d'ambiente. Esse sono, nell'ordine:
address@hidden, @env{$LC_ALL}, @env{$LANG}, e
address@hidden@address@hidden o meno... In effetti sembra che quando
+la variabile d'ambiente @env{$LC_ALL} @`e impostata al valore @samp{C},
+non viene effettuata alcuna traduzione. Vai a capire...}
+Quindi, noi controlliamo il valore di @env{$LANGUAGE}:
+
address@hidden
+$ @kbd{echo $LANGUAGE}
address@hidden en_US.UTF-8
address@hidden example
+
address@hidden
+Il passo succesivo @`e creare le directory:
@example
$ @kbd{mkdir en_US.UTF-8 en_US.UTF-8/LC_MESSAGES}
@@ -31496,7 +31718,7 @@ $ @kbd{mkdir en_US.UTF-8 en_US.UTF-8/LC_MESSAGES}
@cindex file, @dfn{message object} (.mo), conversione da @dfn{portable object}
file
@cindex @command{msgfmt}, programma di address@hidden
@cindex programma di address@hidden @command{msgfmt}
-Il programma di address@hidden @command{msgfmt} effettua la conversione dal
file
+Il programma di address@hidden @command{msgfmt} effettua la conversione del
file
leggibile, in formato testo, @file{.po} nel file, in formato binario,
@file{.mo}.
Per default, @command{msgfmt} crea un file di nome @file{messages}.
@@ -31601,7 +31823,6 @@ esecuzione.
@cindex debug dei programmi @command{awk}
@c The original text for this chapter was contributed by Efraim Yawitz.
address@hidden FIXME: Add more indexing.
Sarebbe bello se i programmi per il calcolatore funzionassero perfettamente la
prima volta che vengono eseguiti, ma nella vita reale questo accade raramente,
@@ -31651,6 +31872,7 @@ In quel caso, cosa ci si address@hidden aspettare da un
tale strumento? La risposta
dipende dal linguaggio su cui si effettua il debug, comunque in generale ci si
address@hidden attendere almeno questo:
address@hidden debugger, address@hidden del
@itemize @value{BULLET}
@item
La address@hidden di osservare l'esecuzione delle istruzioni di un programma
una
@@ -31684,13 +31906,18 @@ l'autore, o anche di un programma scritto da altri).
@node Terminologia nel debug
@subsection Concetti fondamentali sul debug
address@hidden debugger, terminologia
Prima di entrare nei dettagli, dobbiamo introdurre diversi
importanti concetti che valgono per tutti i debugger.
La seguente lista definisce i termini usati nel resto di
questo @value{CHAPTER}:
@table @dfn
address@hidden @dfn{stack frame}
address@hidden @dfn{stack} di chiamata (debugger)
address@hidden debugger, @dfn{stack} di chiamata
address@hidden debugger, pila di chiamata
address@hidden @dfn{stack frame} (debugger)
address@hidden debugger, @dfn{stack frame}
@item Stack frame
Durante la loro esecuzione i programmi normalmente chiamano delle funzioni.
Una funzione address@hidden a sua volta chiamarne un'altra, o address@hidden
richiamare se stessa
@@ -31715,8 +31942,10 @@ invocata. I comandi che stampano la pila delle
chiamate stampano anche le
informazioni su ogni @dfn{stack frame} (come vedremo address@hidden avanti in
dettaglio).
@item Punto d'interruzione
address@hidden breakpoint
address@hidden punto d'interruzione
address@hidden @dfn{breakpoint} (debugger)
address@hidden punto d'interruzione (debugger)
address@hidden debugger, @dfn{breakpoint}
address@hidden debugger, punto d'interruzione
Durante le operazioni di debug, spesso si preferisce lasciare che il programma
venga eseguito finch@'e non raggiunge un certo punto, e da quel punto in poi si
continua l'esecuzione un'istruzione alla volta. Il modo per farlo @`e quello
di
@@ -31727,8 +31956,10 @@ programma. Si possono aggiungere e togliere quanti
punti d'interruzione si
vogliono.
@item Punto d'osservazione
address@hidden @dfn{watchpoint}
address@hidden punto d'osservazione
address@hidden @dfn{watchpoint} (debugger)
address@hidden punto d'interruzione (debugger)
address@hidden debugger, @dfn{watchpoint}
address@hidden debugger, punto d'interruzione
Un punto d'osservazione @`e simile a un punto d'interruzione. La differenza
@`e
che i punti d'interruzione sono orientati attorno al codice; fermano il
programma quando viene raggiunto un certo punto nel codice. Un punto
@@ -31759,7 +31990,10 @@ Inoltre, poich@'e @command{awk} @`e un linguaggio
deliberatamente molto
conciso, @`e facile perdere di vista tutto address@hidden che avviene
``dentro''
ogni riga di codice @command{awk}. Il debugger address@hidden
l'address@hidden di
guardare le singole istruzioni primitive la cui esecuzione @`e innescata
-dai comandi di alto livello di @command{awk}.
+dai comandi di alto livello di @address@hidden ``istruzioni
+primitive'' sono quelle dallo stesso @command{gawk}; il debugger
+non permette di arrivare al livello delle istruzioni hardware della
+macchina.}
@node Esempio di sessione di debug
@section Esempio di sessione di debug di @command{gawk}
@@ -31767,7 +32001,8 @@ dai comandi di alto livello di @command{awk}.
@cindex debug, esempio di sessione
Per illustrare l'uso di @command{gawk} come debugger, vediamo un esempio di
-sessione di debug. Come esempio address@hidden usata l'implementazione
@command{awk}
+sessione di debug. Come esempio address@hidden usata un'implementazione
@command{awk}
+(con errori)
del comando POSIX @command{uniq} descritta in precedenza (@pxref{Programma
uniq}).
@@ -31805,6 +32040,8 @@ programma nella riga di comando al debugger piuttosto
che come parte del
comando @code{run} al prompt del debugger.)
L'opzione @option{-1} @`e un'opzione per @file{uniq.awk}.
address@hidden debugger, prompt
address@hidden prompt del debugger
Invece di eseguire direttamente il programma sul @file{file_di_input}, come
@command{gawk} farebbe normalmente, il debugger semplicemente carica
i file sorgenti del programma, li compila internamente, e poi mostra
@@ -31821,9 +32058,9 @@ stato ancora eseguito nessun codice.
@node Trovare il bug
@subsection Trovare il bug
-Poniamo di avere un problema usando (una versione difettosa di)
address@hidden nella address@hidden ``salta-campi'', perch@'e sembra che non
-catturi le righe che dovrebbero essere identiche dopo aver saltato il primo
+Poniamo di avere un problema usando una versione (difettosa) di
address@hidden in address@hidden ``salta-campi'', perch@'e sembra non
+trovare le righe che sono identiche a condizione di saltare il primo
campo, come:
@example
@@ -31854,6 +32091,13 @@ ragionevole per un punto d'interruzione in
@file{uniq.awk} @`e all'inizio della
funzione @code{se_sono_uguali()}, che confronta la riga corrente con la
precedente.
Per impostare il punto d'interruzione, usare il comando @code{b}
(@dfn{breakpoint}):
address@hidden debugger, impostare un punto d'interruzione
address@hidden @code{breakpoint}, comando del debugger
address@hidden comando del debugger, @code{breakpoint}
address@hidden @code{break}, comando del debugger
address@hidden comando del debugger, @code{break}
address@hidden @code{b}, comando del debugger
address@hidden comando del debugger, @code{b}
@example
gawk> @kbd{b se_sono_uguali}
@print{} Breakpoint 1 impostato al file `uniq.awk', riga 63
@@ -31863,6 +32107,9 @@ Il debugger mostra il file e il numero di riga dove si
trova il punto
d'interruzione. Ora bisogna immettere @samp{r} o @samp{run} e il programma
viene eseguito fino al primo punto d'interruzione:
address@hidden debugger, eseguire il programma
address@hidden comando del debugger, @code{run}
address@hidden @code{run}, comando del debugger
@example
gawk> @kbd{r}
@print{} Partenza del programma:
@@ -31879,6 +32126,11 @@ Prima di tutto, vediamo come siamo arrivati a questo
punto. Sulla riga di
comando battiamo @samp{bt} (che sta per ``backtrace''), e il debugger risponde
con un listato degli @dfn{stack frame} correnti:
address@hidden debugger, elementi pila, visualizzazione
address@hidden comando del debugger, @code{bt}
address@hidden @code{bt}, comando del debugger
address@hidden comando del debugger, @code{backtrace}
address@hidden @code{backtrace}, comando del debugger
@example
gawk> @kbd{bt}
@print{} #0 se_sono_uguali(n, m, campi_ultima, campi_corrente,
@@ -31900,6 +32152,10 @@ alcune variabili. Immaginiamo di battere @samp{p n}
@code{n}, un parametro di @code{se_sono_uguali()}. In address@hidden, il
debugger
ci address@hidden:
address@hidden comando del debugger, @code{print}
address@hidden @code{print}, comando del debugger
address@hidden comando del debugger, @code{p}
address@hidden @code{p}, comando del debugger
@example
gawk> @kbd{p n}
@print{} n = untyped variable
@@ -31951,6 +32207,10 @@ ulteriormente, iniziamo a ``scorrere una ad una'' le
righe di
@code{se_sono_uguali()}. Cominciamo col battere @samp{n} (per ``next''
[successivo]):
address@hidden comando del debugger, @code{n}
address@hidden @code{n}, comando del debugger
address@hidden comando del debugger, @code{next}
address@hidden @code{next}, comando del debugger
@example
@group
gawk> @kbd{n}
@@ -31998,6 +32258,8 @@ del vettore.
Una prima address@hidden @`e quella di usare degli indici:
address@hidden debugger, stampare singoli elementi di un vettore
address@hidden stampare singoli elementi di un vettore, nel debugger
@example
gawk> @kbd{p vettore_ultima[0]}
@print{} "0" non presente nel vettore `vettore_ultima'
@@ -32015,6 +32277,8 @@ Questo metodo sarebbe piuttosto lento per un vettore
con 100 elementi, per cui
@command{gawk} fornisce una scorciatoia (che fa venire in mente un altro
linguaggio che non nominiamo):
address@hidden debugger, stampare tutti gli elementi di un vettore
address@hidden stampare tutti gli elementi di un vettore, nel debugger
@example
gawk> @kbd{p @@vettore_ultima}
@print{} vettore_ultima["1"] = "awk,"
@@ -32096,6 +32360,8 @@ Ottenere informazioni
Comandi vari
@end itemize
address@hidden debugger, ripetere dei comandi
address@hidden ripetere dei comandi, nel debugger
Ciascuna di esse @`e trattata
@ifnotinfo
nelle seguenti
@@ -32174,9 +32440,9 @@ comando. Altrimenti, continua l'esecuzione del
programma.
@cindex comando del debugger, @code{clear}
@cindex @code{clear}, comando del debugger
address@hidden cancellare punto d'interruzione da una determinata posizione
address@hidden punto d'interruzione in una determinata posizione, come
cancellare
address@hidden breakpoint, come cancellare
address@hidden cancellare punto d'interruzione, in una determinata posizione
address@hidden punto d'interruzione, cancellare in una determinata posizione
address@hidden breakpoint in una determinata posizione, cancellare
@item @code{clear} address@hidden@code{:address@hidden | @var{funzione}]
Senza argomenti, cancella ogni eventuale punto d'interruzione all'istruzione
successiva
@@ -32218,8 +32484,9 @@ incondizionato).
@cindex comando del debugger, @code{delete}
@cindex @code{delete}, comando del debugger
@cindex @code{d}, comando del debugger (alias per @code{delete})
address@hidden cancellare punto d'interruzione per numero
address@hidden cancellare punto d'interruzione, per numero
@cindex punto d'interruzione, cancellare per numero
address@hidden breakpoint, cancellare per numero
@item @code{delete} address@hidden n2} @dots{}] address@hidden@var{m}]
@itemx @code{d} address@hidden n2} @dots{}] address@hidden@var{m}]
Cancella i punti d'interruzione specificati o un intervallo di punti
@@ -32320,6 +32587,8 @@ gawk>
@cindex comando del debugger, @code{c} (alias per @code{continue})
@cindex comando del debugger, @code{continue}
address@hidden continuare esecuzione programma, nel debugger
address@hidden debugger, continuare esecuzione programma
@cindex @code{continue}, comando del debugger
@item @code{continue} address@hidden
@itemx @code{c} address@hidden
@@ -32446,6 +32715,17 @@ Valuta @var{istruzioni awk} nel contesto del programma
in esecuzione.
Si address@hidden fare qualsiasi cosa che un programma @command{awk} farebbe:
assegnare
valori a variabili, chiamare funzioni, e address@hidden@dotless{i}} via.
address@hidden NOTA
+Non @`e possibile usare @code{eval} per valutare un'espressione che contenga
+una qualsiasi delle seguenti istruzioni:
address@hidden,
address@hidden,
address@hidden,
address@hidden,
+o
address@hidden
address@hidden quotation
+
@item @code{eval} @var{param}, @dots{}
@itemx @var{istruzioni awk}
@itemx @code{end}
@@ -32556,7 +32836,6 @@ che hanno chiamato quella in cui ci si trova. I
comandi per far questo sono:
@cindex comando del debugger, @code{where} (alias per @code{backtrace})
@cindex @code{backtrace}, comando del debugger
@cindex @code{bt}, comando del debugger (alias per @code{backtrace})
address@hidden @code{where}, comando del debugger
@cindex @code{where}, comando del debugger (alias per @code{backtrace})
@cindex chiamate, @dfn{stack} (pila) delle, mostrare nel debugger
@cindex @dfn{stack} (pila) delle chiamate, mostrare nel debugger
@@ -32729,7 +33008,7 @@ Salva la cronologia dei comandi nel file
@file{./.gawk_history}.
L'impostazione di default @`e @code{on}.
@item @code{save_options} address@hidden | @code{off}]
address@hidden salvataggio opzioni debugger
address@hidden salvataggio opzioni, nel debugger
@cindex debugger, salvataggio opzioni
Salva le opzioni correnti nel file @file{./.gawkrc} all'uscita.
L'impostazione di default @`e @code{on}.
@@ -32742,12 +33021,15 @@ Attiva o disattiva il tracciamento delle istruzioni.
L'impostazione di default
@`e @code{off}.
@end table
address@hidden debugger, salvare dei comandi su un file
address@hidden salvare dei comandi su un file, nel debugger
@item @code{save} @var{nome-file}
Salva i comandi eseguiti nella sessione corrente nel @value{FN} indicato,
in modo da poterli ripetere in seguito usando il comando @command{source}.
@item @code{source} @var{nome-file}
@cindex debugger, leggere comandi da un file
address@hidden leggere comandi da un file, nel debugger
Esegue comandi contenuti in un file; un errore in un comando non impedisce
l'esecuzione dei comandi successivi. In un file di comandi sono consentiti
i commenti (righe che iniziano con @samp{#}).
@@ -32918,9 +33200,10 @@ familiari.
@node Supporto per Readline
@section Supporto per Readline
address@hidden completamento dei comandi nel debugger
address@hidden espansione della cronologia, nel debugger
address@hidden completamento dei comandi, nel debugger
@cindex debugger, completamento dei comandi nel
address@hidden espansione della cronologia, nel debugger
address@hidden debugger, espansione della cronologia
Se @command{gawk} @`e compilato con
@uref{http://cnswww.cns.cwru.edu/php/chet/readline/readline.html, la libreria
@@ -32960,6 +33243,8 @@ e
@node Limitazioni
@section Limitazioni
address@hidden debugger, limitazioni
address@hidden limitazioni del debugger
Si spera che il lettore trovi il debugger di @command{gawk} utile e piacevole
da usare, ma come accade per ogni programma, specialmente nelle sue prime
versioni, ha ancora delle limitazioni. Quelle di cui @`e bene essere al
corrente sono:
@@ -33135,6 +33420,521 @@ ma questo address@hidden succedere occasionalmente.
@end itemize
address@hidden name-spaces Name-space Name-spaces}
address@hidden Spazi-dei-nomi
address@hidden Spazi-dei-nomi in @command{gawk}
+
+Questo @value{CHAPTER} descrive una address@hidden disponibile solo in
address@hidden
+
address@hidden ATTENZIONE
+La address@hidden descritta in questo capitolo @`e nuova. @`E certamente
+possibile, e perfino probabile, che ci siano degli angoli bui
+(se non dei bug), ancora presenti nell'implementazione.
+Chi ne trovasse, @`e pregato di notificarlo (@xref{Bug}).
address@hidden quotation
+
address@hidden
+* Spazio-dei-nomi globale:: Lo spazio-dei-nomi globale in
@command{awk}
+ standard.
+* Nomi qualificati:: Come qualificare nomi con uno
+ spazio-dei-nomi.
+* Spazio-dei-nomi di default:: Lo spazio-dei-nomi di default.
+* Cambiare lo spazio-dei-nomi:: Come cambiare lo spazio-dei-nomi.
+* Regole per i nomi:: Regole per assegnare nomi a uno
+ spazio-dei-nomi ai suoi componenti.
+* Gestione interna dei nomi:: Come i nomi sono gestiti internamente.
+* Esempio di spazio-dei-nomi:: Esempio di codice che usa uno
spazio-dei-nomi.
+* Spazio-dei-nomi e address@hidden:: Lo spazio-dei-nomi e le altre
address@hidden
+ di @command{gawk}.
+* Sommario sugli spazi-dei-nomi:: Sommario sugli spazi-dei-nomi.
address@hidden menu
+
address@hidden Spazio-dei-nomi globale
address@hidden Lo spazio-dei-nomi globale in @command{awk} standard
+
address@hidden spazio-dei-nomi, definizione
address@hidden spazio-dei-nomi, globale, in @command{awk} standard
+In @command{awk} standard, esiste un unico @dfn{spazio-dei-nomi} globale.
address@hidden significa che @emph{tutti} i nomi di funzione e i nomi di
variabili
+globali devono essere unici.
+Per esempio, due differenti file sorgenti di @command{awk},
+se usati insieme,
+non possono entrambi definire una funzione avente nome
address@hidden()}, o definire una variabile con lo stesso nome,
+usata come scalare in programma e come vettore in un altro.
+
+Questa situazione address@hidden essere accettabile se i programmi sono
+di dimensioni piccole, qualche centinaio di righe, o anche
+qualche migliaio, ma impedisce lo sviluppo di librerie riusabili
+contenenti funzioni di @command{awk}, e address@hidden far
address@hidden@dotless{i}} che file di
+librerie sviluppate in maniera indipendente fra loro possano
+incidentalmente entrare in conflitto con le variabili globali
+``private'' proprie di un'altra libreria
+(@pxref{Nomi di variabili di libreria}).
+
address@hidden pacchetto, definizione di
address@hidden modulo, definizione di
+Molti altri linguaggi di programmazione risolvono questo problema rendendo
+disponibile qualche tipo di controllo sullo spazio-dei-nomi: un modo per
+poter stabilire che ``questa funzione @`e nello spazio-dei-nomi @var{xxx},
+mentre quella funzione @`e nello spazio-dei-nomi @var{yyy}''. (Naturalmente,
+in address@hidden c'@`e ancora un unico spazio-dei-nomi, quello composto da
+tutti gli spazi-dei-nomi, ma si spera che ci siano solo pochi spazi-dei-nomi
+in uso da parte di un determinato programma e, quindi, che la address@hidden
+di conflitti sia molto minore).
+Queste address@hidden sono talore indicate col nome di
address@hidden (@dfn{packages}) o @dfn{moduli} (@dfn{modules}).
+
+A partire dalla @value{PVERSION} 5.0, @command{gawk} fornisce un
+meccanismo semplice per mettere funzioni e variabili globali in
+spazi-dei-nomi separati fra loro.
+
address@hidden Nomi qualificati
address@hidden Nomi qualificati
+
address@hidden nome qualificato, definizione di
address@hidden qualificato, nome, definizione di
address@hidden spazio-dei-nomi, nomi qualificati
address@hidden @code{::}, spazio-dei-nomi, separatore
address@hidden nome del componente
address@hidden componente, nome del
+Un @dfn{nome qualificato} @`e un identificativo composto
+dal nome di uno spazio-dei-nomi, da un separatore di spazio-dei-nomi
+(i due caratteri @code{::}), e dal nome di un @dfn{componente}.
+Per esempio, ci potrebbe
+essere una funzione di nome @code{posix::getpid()}. Qui, lo spazio-dei-nomi
address@hidden @code{posix} e il nome della funzione all'interno dello the
spazio-dei-nomi
+(il componente) @`e @code{getpid()}. Lo spazio-dei-nomi e i nomi di componente
+sono separati da due caratteri ":".
+In un nome qualificato address@hidden essere presente un unico separatore.
+
address@hidden NOTA
+A differenza di come avviene in C++, la notazione @code{::} @emph{non @`e} un
+operatore. Non @`e consentito inserire degli spazi di separazione fra il
+nome dello spazio-dei-nomi, la notazione @code{::}, e il nome del componente.
address@hidden quotation
+
address@hidden nome qualificato, uso del
address@hidden necessario usare nomi qualificati, in uno spazio-dei-nomi, per
accedere
+a variabili e funzioni in un altro spazio-dei-nomi. address@hidden @`e
particolarmente
+importante quando si usano nomi di variabile come indici del vettore
+speciale @code{SYMTAB} (@pxref{Variabili auto-assegnate}),
+e quando si effettuano chiamate di funzione indirette
+(@pxref{Chiamate indirette}).
+
address@hidden Spazio-dei-nomi di default
address@hidden Lo spazio-dei-nomi di default
+
address@hidden spazio-dei-nomi, default
address@hidden spazio-dei-nomi, @code{awk}
address@hidden @code{awk}, spazio-dei-nomi
+Lo spazio-dei-nomi di default, ovviamente, @`e @code{awk}.
+Tutte le variabili predefinite di @command{awk} e di @command{gawk}
+sono in questo spazio-dei-nomi, e quindi hanno nomi qualificati come
address@hidden::ARGC}, @code{awk::NF}, e address@hidden@dotless{i}} via.
+
address@hidden nomi in maiuscolo, spazio-dei-nomi dei
+Inoltre, anche se si sta utilizzando uno spazio-dei-nomi differente
+nel file sorgente correntemente in uso
+(@pxref{Cambiare lo spazio-dei-nomi}), @command{gawk}
+assegna tutti gli identificativi senza una qualifica che contengono
+solo lettere maiuscole allo spazio-dei-nomi @code{awk}. address@hidden rende
+possibile utilizzare facilmente le variabili globali proprie di
address@hidden da spazi-dei-nomi differenti.
address@hidden rende anche address@hidden scorrevole il codice stesso.
+
address@hidden Cambiare lo spazio-dei-nomi
address@hidden Come cambiare lo spazio-dei-nomi
+
address@hidden spazio-dei-nomi, cambiare lo
address@hidden @code{@@namespace}, direttiva
address@hidden direttiva @code{@@namespace}
+Per impostare lo spazio-dei-nomi corrente, si usi una direttiva
address@hidden@@namespace}
+al livello principale del programma interessato:
+
address@hidden
+@@namespace "passwd"
+
+BEGIN @{ @dots{} @}
address@hidden
address@hidden example
+
+Dopo questa direttiva, tutti gli identificati semplici che non siano composti
+esclusivamente da lettere maiuscole sono assegnati allo
+spazio-dei-nomi @code{passwd}.
+
address@hidden possibile cambiare lo spazio-dei-nomi address@hidden volte
all'interno di
+un singolo file sorgente, sebbene address@hidden possa essere causa di
+confusione, se lo si fa troppe volte.
+
address@hidden NOTA
+L'assegnamento degli identificativi non qualificati a uno spazio-dei-nomi
+avviene nel momento in cui @command{gawk} analizza il programma, @emph{prima}
+di cominciare a eseguirlo.
+Non c'@`e quindi il concetto di uno spazio-dei-nomi ``corrente'' al momento
+dell'esecuzione del programma.
address@hidden va compreso e messo in conto in anticipo.
address@hidden quotation
+
address@hidden spazio-dei-nomi, implicito
address@hidden implicito, spazio-dei-nomi
+Ogni file sorgente designato dalle opzioni
address@hidden e @option{-f} inizia con una direttiva implicita
address@hidden@@namespace "awk"}. Analogamente, ogni parte di codice
+immesso nella riga di comando, usando l'opzione @option{-e}
+ha la stessa implicita direttiva iniziale
+(@pxref{Opzioni}).
+
address@hidden spazio-dei-nomi corrente, cambiare e ripristinare
address@hidden corrente, spazio-dei-nomi, cambiare e ripristinare
+I file inclusi con la direttiva @code{@@include} (@pxref{Includere file})
+``cambiano'' (@dfn{push}) e ``ripristinano'' (@dfn{pop})
+lo spazio-dei-nomi corrente. Ossia, ogni @code{@@include} salva
+lo spazio-dei-nomi corrente e inizia con una direttiva implicita
address@hidden@@namespace "awk"} che resta attiva finch@'e non si incontra una
+direttiva esplicita @code{@@namespace}.
+Quando @command{gawk} termina di elaborare il file incluso,
+lo spazio-dei-nomi salvato @`e ripristinato e l'elaborazione prosegue
+da dove era stata sospesa nel file originale.
+
address@hidden @code{@@namespace}, non riguarda @address@hidden
@code{BEGINFILE}, @code{END}, ed @code{ENDFILE}
address@hidden @code{BEGIN}, regola, ordine di esecuzione non alterato da
@code{@@namespace}
address@hidden @code{BEGINFILE}, regola, ordine di esecuzione non alterato da
@code{@@namespace}
address@hidden @code{END}, regola, ordine di esecuzione non alterato da
@code{@@namespace}
address@hidden @code{ENDFILE}, regola, ordine di esecuzione non alterato da
@code{@@namespace}
+L'uso di @code{@@namespace} non ha influenza sull'ordine di esecuzione delle
+regole @code{BEGIN}, @code{BEGINFILE}, @code{END}, e @code{ENDFILE}.
+
address@hidden Regole per i nomi
address@hidden Regole per assegnare nomi a uno spazio-dei-nomi e ai suoi
componenti
+
address@hidden nomi, regole per assegnare, agli spazi-dei-nomi e ai loro
componenti
address@hidden spazio-dei-nomi, nomi, regole per assegnare
address@hidden componenti di uno spazio-dei-nomi, regole per assegnare i nomi
+Alcune regole vanno seguite nell'attribuire i nomi a uno spazio-dei-nomi
+e alle sue componenti.
+
address@hidden @bullet
address@hidden
address@hidden un errore sintattico (@dfn{syntax error})
+usare nomi qualificati
+come nomi di parametri passati a una funzione.
+
address@hidden
address@hidden un errore sintattico (@dfn{syntax error})
+usare una quasiasi parola riservata standard di @command{awk} (come
address@hidden o @code{for}), o il nome di una qualsiasi funzione predefinita
+(come @code{sin()} o @code{gsub()}) come una qualsiasi delle parti di un nome
+nome qualificato.
+Quindi, il codice seguente produce un errore sintattico:
+
address@hidden
+@@namespace "example"
+
+function gsub(str, pat, result) @{ @dots{} @}
address@hidden example
+
address@hidden
+Fuori dallo spazio-dei-nomi @code{awk}, i nomi delle ulteriori funzioni
+predefinite disponibili in @command{gawk}
+(come @code{gensub()} o @code{strftime()}) @emph{possono}
+essere usate come nomi di componente.
+Lo stesso insieme di nomi address@hidden essere usato come nome di uno
+spazio-dei-nomi, sebbene farlo possa ingenerare confusione.
+
address@hidden
+Le ulteriori funzioni predefinite disponibili in @command{gawk} possono
+essere chiamate all'esterno dello spazio-dei-nomi @code{awk} utilizzando
+nomi qualificati. Per esempio, @code{awk::systime()}.
+Ecco un esempio abbastanza banale a dimostrazione di questa regola e
+della regola precedente:
+
address@hidden
+BEGIN @{
+ print "nello spazio-dei-nomi awk, systime() =", systime()
address@hidden
+
+@@namespace "testing"
+
+function systime()
address@hidden
+ print "nello spazio-dei-nomi testing, systime() =", awk::systime()
address@hidden
+
+BEGIN @{
+ systime()
address@hidden
address@hidden example
+
address@hidden
+
+Se lo si esegue, l'output prodotto @`e di questo tipo:
+
address@hidden
+$ @kbd{gawk -f systime.awk}
address@hidden nello spazio-dei-nomi awk, systime() = 1500488503
address@hidden nello spazio-dei-nomi testing, systime() = 1500488503
address@hidden example
+
address@hidden
+I nomi delle variabili predefinite di @command{gawk} possono essere usati:
address@hidden::NR} @`e un nome valido, anche se non sembra una scelta di
+nomi molto utile.
address@hidden itemize
+
address@hidden Gestione interna dei nomi
address@hidden Come i nomi sono gestiti internamente
+
address@hidden nomi, gestione dei
address@hidden @code{awk} spazio-dei-nomi, memoria che contiene i nomi
identificativi
address@hidden @code{awk} spazio-dei-nomi, utilizzo per chiamate indirette di
funzione
+Per address@hidden all'indietro, tutti gli identificatvi nello spazio-dei-nomi
address@hidden sono memorizzati internamente come identificativi senza qualifica
+(ossia, senza il prefisso @samp{awk::}). address@hidden ha importanza
principalmente
+quando tali identificativi sono usati come indici per i vettori
address@hidden, @code{FUNCTAB}, e @code{PROCINFO["identifiers"]}
+(@pxref{Variabili auto-assegnate}), e quando sono usati per
+chiamate indirette di funzioni (@pxref{Chiamate indirette}).
+
+Nella codifica di programmi, per far riferimento a variabili e funzioni
+appartenenti allo spazio-dei-nomi @code{awk} da un altro spazio-dei-nomi
address@hidden tuttavia necessario utilizzare il prefisso @samp{awk::}.
+Per esempio:
+
address@hidden
+@@namespace "awk" @ii{Questo @`e lo spazio-dei-nomi di default}
+
+BEGIN @{
+ Titolo = "Il mio rapporto" @ii{Il nome qualificato @`e} awk::Titolo
address@hidden
+
+@@namespace "rapporto" @ii{Adesso lo spazio-dei-nomi @`e} rapporto
+
+function calcola() @ii{Il nome vero di questa funzione @`e}
rapporto::compute()
address@hidden
+ print awk::Titolo @ii{Per stampare} SYMTAB["Titolo"]
+ @dots{}
address@hidden
address@hidden example
+
address@hidden Esempio di spazio-dei-nomi
address@hidden Esempio di codice che usa uno spazio-dei-nomi
+
address@hidden spazio-dei-nomi, esempio di codice
+L'esempio seguente @`e una versione riveduta dell'insieme di
+script sviluppati in @ref{Funzioni Passwd};
address@hidden@dotless{i}} si address@hidden trovare la descrizione del
funzionamento del codice.
+
+Questa riformulazione, opera principalmente di Andrew Schorr,
address@hidden piuttosto elegante.
+Tutte le funzioni e le variabili di implementazione
+sono nello spazio-dei-nomi @code{passwd}, mentre
+le funzioni principali di interfaccia sono
+definite nello spazio-dei-nomi @code{awk}.
+
address@hidden
address@hidden file eg/lib/ns_passwd.awk
+# ns_passwd.awk --- accedere alle informazioni del file delle password
address@hidden endfile
address@hidden
address@hidden file eg/lib/ns_passwd.awk
+#
+# Arnold Robbins, arnold@@skeeve.com, Public Domain
+# May 1993
+# Revised October 2000
+# Revised December 2010
+#
+# Reworked for namespaces June 2017, with help from
+# Andrew J.@: Schorr, aschorr@@telemetry-investments.com
address@hidden endfile
address@hidden ignore
address@hidden file eg/lib/ns_passwd.awk
+
+@@namespace "passwd"
+
+BEGIN @{
+ # modificare per adattarlo al sistema in uso
+ Awklib = "/usr/local/libexec/awk/"
address@hidden
+
+function Init( oldfs, oldrs, olddol0, pwcat, using_fw, using_fpat)
address@hidden
+ if (Inizializzato)
+ return
+
+ oldfs = FS
+ oldrs = RS
+ olddol0 = $0
+ using_fw = (PROCINFO["FS"] == "FIELDWIDTHS")
+ using_fpat = (PROCINFO["FS"] == "FPAT")
+ FS = ":"
+ RS = "\n"
+
+ pwcat = Awklib "pwcat"
+ while ((pwcat | getline) > 0) @{
+ Byname[$1] = $0
+ Byuid[$3] = $0
+ Bycount[++Totale] = $0
+ @}
+ close(pwcat)
+ Contatore = 0
+ Inizializzato = 1
+ FS = oldfs
+ if (using_fw)
+ FIELDWIDTHS = FIELDWIDTHS
+ else if (using_fpat)
+ FPAT = FPAT
+ RS = oldrs
+ $0 = olddol0
address@hidden
+
+function awk::getpwnam(nome)
address@hidden
+ Init()
+ return Byname[nome]
address@hidden
+
+function awk::getpwuid(uid)
address@hidden
+ Init()
+ return Byuid[uid]
address@hidden
+
+function awk::getpwent()
address@hidden
+ Init()
+ if (Contatore < Totale)
+ return Bycount[++Contatore]
+ return ""
address@hidden
+
+function awk::endpwent()
address@hidden
+ Contatore = 0
address@hidden
address@hidden endfile
address@hidden example
+
+Come si address@hidden vedere, questa versione segue anche la convenzione
menzionata in
address@hidden di variabili di libreria}, secondo la quale i nomi di funzione e
+le variabili globali iniziano con la lettera maiuscola.
+
+Quel che segue @`e un semplice programma di test. Poich@'e @`e in un file
+separato, gli identificativi non qualificati saranno ricercati
+all'interno dello spazio-dei-nomi @code{awk}:
+
address@hidden
+BEGIN @{
+ while ((p = getpwent()) != "")
+ print p
address@hidden
address@hidden example
+
address@hidden
+
+Ecco cosa succede quando il programma viene eseguito:
+
address@hidden
+$ @kbd{gawk -f ns_passwd.awk -f testpasswd.awk}
address@hidden root:x:0:0:root:/root:/bin/bash
address@hidden daemon:x:1:1:daemon:/usr/sbin:/usr/sbin/nologin
address@hidden bin:x:2:2:bin:/bin:/usr/sbin/nologin
address@hidden sys:x:3:3:sys:/dev:/usr/sbin/nologin
address@hidden
address@hidden example
+
address@hidden Spazio-dei-nomi e address@hidden
address@hidden Lo spazio-dei-nomi e le altre address@hidden di @command{gawk}
+
address@hidden
+Questa
address@hidden ifnotinfo
address@hidden
+Questo
address@hidden ifinfo
address@hidden tratta brevemente di come la address@hidden spazio-dei-nomi
+interagisce con altre importanti address@hidden di @command{gawk}.
+
address@hidden spazio-dei-nomi, interazione con la profilazione
address@hidden spazio-dei-nomi, interazione con la stampa elegante
address@hidden profilazione, interazione con spazio-dei-nomi
address@hidden stampa elegante, interazione con spazio-dei-nomi
+La profilazione e la stampa elegante (@pxref{Profilare}) sono state
+migliorate per trattare gli spazi-dei-nomi e le regole per assegnare nomi in
+uno spazio-dei-nomi @ref{Regole per i nomi}.
+In particolare, l'output tiene insieme le funzioni che appartengono
+allo stesso spazio-dei-nomi, e contiene delle direttive @code{@@namespace}
+davanti alle regole, a seconda delle address@hidden
+In questo modo i nomi dei componenti sono degli
+identificativi semplici, senza dover usare dappertutto degli
+identificativi qualificati.
+
address@hidden spazio-dei-nomi, interazioen con il debugger
address@hidden debugger, interazione con lo spazio-dei-nomi
+L'interazione con il debugger (@pxref{Debugging}) non @`e cambiata
+(almeno fino al momento in cui questo libro @`e stato scritto).
+Alcuni campi interni sono stati modificati per tener conto
+degli spazi-dei-nomi, e il comando @code{dump} del debugger
address@hidden stato modificato per lo stesso motivo.
+
address@hidden spazio-dei-nomi, interazione con l'estensione API
address@hidden estensione API, interazione con lo spazio-dei-nomi
address@hidden API, estensione, interazione con lo spazio-dei-nomi
+L'estensione API (@pxref{Estensioni dinamiche}) ha sempre previsto
+di avere funzioni in uno spazio-dei-nomi differente, sebbene address@hidden
+non fosse stato ancora implementato. Tuttavia, le routine di
+ricerca e di aggiornamento dei simbolo non prevedevano l'utilizzo
+di un spazio-dei-nomi. Questo @`e stato corretto
+(@pxref{Tabella simboli per nome}).
address@hidden di estensione Inplace}, per un notevole esempio di
+un'estensione che sfrutta uno spazio-dei-nomi condiviso fra del
+codice scritto in C e del codice @command{awk}, che collaborano
+fra loro.
+
address@hidden Sommario dello Spazio-dei-nomi
address@hidden Sommario
+
address@hidden @value{BULLET}
address@hidden
address@hidden standard fornisce un unico spazio-dei-nomi per tutti gli
+identificativi globali (scalari, vettori e funzioni).
address@hidden address@hidden essere limitante se si vogliono sviluppare
librerie di
+funzioni riusabili, o gruppi di funzioni.
+
address@hidden
address@hidden fornisce degli spazi-dei-nomi multipli, attraverso l'uso di
+nomi qualificati: nomi che consistono nel nome di uno spazio-dei-nomi,
+seguito da un separatore di spazio-dei-nomi (@code{::}), e da un nome di
+componente. I nomi degli spazi-dei-nomi potrebbero ancora entrare in
+conflitto fra loro, ma questo capita in ogni linguaggio che fornisce
+spazi-dei-nomi, moduli, o pacchetti.
+
address@hidden
+Lo spazio-dei-nomi di default @`e @command{awk}. Le regole per gli
+spazi-dei-nomi e per i nomi dei loro componenti sono descritte in
address@hidden per i nomi}. Le regole sono state progettate
+in modo da far address@hidden@dotless{i}} che il codice che usa gli
spazi-dei-nomi resti
+semplice da leggere e funzioni in maniera intuitiva, pur rendendo
+disponibile la potenza e la address@hidden necessarie.
+
address@hidden
+Altre parti di @command{gawk} sono state estese come necessario per
+integrare gli spazi-dei-nomi nel loro funzionamento.
+Questo vale soprattutto per la profilazione / stampa elegante
+(@pxref{Profilare}) e per le address@hidden relative alle
+estensioni (@pxref{Estensioni dinamiche}).
+
address@hidden spazio-dei-nomi, address@hidden all'indietro
address@hidden
+Complessivamente, la address@hidden spazio-dei-nomi @`e stata progettata e
+implementata avendo come preoccupazione quella di mantenere la address@hidden
+all'indietro. I programmi che non usano degli spazi-dei-nomi
+non dovrebbero avere alcuna differenza di comportamento quando sono eseguiti
+su una versione di @command{gawk} che abbia la address@hidden spazio-dei-nomi.
address@hidden itemize
+
@node Calcolo con precisione arbitraria
@chapter Calcolo con precisione arbitraria con @command{gawk}
@cindex precisione arbitraria
@@ -33287,7 +34087,7 @@ variazione dei valori sono mostrati in
@ref{table-numeric-ranges} e in
@headitem Rappresentazione @tab @w{Valore positivo} @w{minimo} @w{diverso da
zero} @tab @w{Valore finito} @w{minimo} @tab @w{Valore finito} @w{massimo}
@end iftex
@ifnottex
address@hidden Rappresentazione @tab Valore positivo minimo diverso da zero
@tab Valore finito minimo @tab Valore finito massimo
address@hidden Rappresentazione @tab Valore positivo minimo diverso da zero
@tab Valore finito minimo @tab Valore finito massimo
@end ifnottex
@iftex
@item @w{Virgola mobile, singola precis.} @tab @math{1,175494 @cdot 10^{-38}}
@tab @math{-3,402823 @cdot 10^{38}} @tab @math{3,402823 @cdot 10^{38}}
@@ -34476,7 +35276,7 @@ disponibili
* Licenza delle estensioni:: Una nota riguardo al tipo di licenza.
* Panoramica sul meccanismo delle estensioni:: Una panoramica sul meccanismo
delle estensioni.
-* Descrizione dell'API delle estensioni:: Una descrizione completa dell'API.
+* Descrizione dell'estensione API:: Una descrizione completa dell'API.
* Trovare le estensioni:: Come @command{gawk} trova le estensioni
compilate.
* Esempio di estensione:: Esempio di codice C di un'estensione.
@@ -34681,10 +35481,10 @@ address@hidden utilizzate nell'estensione.
(Discrepanze tra le versioni
@xref{Versione dell'estensione} per ulteriori dettagli.
@end itemize
address@hidden Descrizione dell'API delle estensioni
address@hidden Descrizione dell'estensione API
@section Una descrizione completa dell'API
address@hidden estensioni, API delle
address@hidden API, delle estensioni
address@hidden estensione, API
address@hidden API, estensione
Il codice sorgente scritto in C o C++ per un'estensione deve includere il
file di intestazione
@@ -34699,7 +35499,7 @@ Questo
(non breve) @value{SECTION} descrive l'API in detttaglio.
@menu
-* Intro funzioni API delle estensioni:: Introduzione alle funzioni dell'API.
+* Intro funzioni estensione API:: Introduzione alle funzioni dell'API.
* Tipi di dati generali:: I tipi di dati.
* Funzioni di allocazione memoria:: Funzioni per allocare memoria.
* Funzioni di costruzione:: Funzioni per creare valori.
@@ -34720,7 +35520,7 @@ Questo
* Modifiche dalla versione API 1:: Modifiche dalla versione 1 dell'API.
@end menu
address@hidden Intro funzioni API delle estensioni
address@hidden Intro funzioni estensione API
@subsection Introduzione alle funzioni dell'API
L'accesso a address@hidden interne a @command{gawk} @`e effettuato
@@ -34808,9 +35608,12 @@ Alcune osservazioni riguardo all'uso dell'API:
I seguenti tipi di variabili, macro e/o funzioni sono resi disponibili
nel file @file{gawkapi.h}. Perch@'e siano utilizzabili, i rispettivi file di
intestazione standard indicati devono essere stati specificati @emph{prima}
-di includere @file{gawkapi.h}:
+di includere @file{gawkapi.h}.
+La lista delle macro e dei relativi file di intestazioni @`e contenuta
+in @ref{tabella-intestazioni-standard-api}.
address@hidden FIXME: Make this as a float at some point.
address@hidden Tabella,tabella-intestazioni-standard-api
address@hidden di intestazioni standard usati nell'API}
@multitable address@hidden()}, @code{memcpy()}} address@hidden<sys/types.h>}}
@headitem Elemento C @tab File d'intestazione
@item @code{EOF} @tab @code{<stdio.h>}
@@ -34822,6 +35625,7 @@ di includere @file{gawkapi.h}:
@item @code{size_t} @tab @code{<sys/types.h>}
@item @code{struct stat} @tab @code{<sys/stat.h>}
@end multitable
address@hidden float
Per ragioni di address@hidden, specialmente per sistemi
che non sono interamente aderenti agli standard, occorre assicurarsi di
@@ -34858,7 +35662,7 @@ dall'estensione come in sola lettura. Le aree di
memoria che contengono @emph{t
e sono gestite da @command{gawk} da quel punto in avanti.
@item
-L'API definisce parecchie semplici @code{struct} che mappano dei valori
+L'API definisce parecchie semplici strutture @code{struct} che mappano dei
valori
come sono visti da @command{awk}. Un valore address@hidden essere un numero
@code{double}
(in virgola mobile, in doppia precisione), una stringa o un
vettore (come @`e il caso per i vettori multidimensionali o nella creazione di
@@ -35134,7 +35938,8 @@ a
La varie macro sopra elencate facilitano l'uso degli elementi delle
@code{union} come se
-fossero campi in una @code{struct}; @`e questa una pratica comunemente adottata
+fossero campi in una struttura @code{struct}; @`e questa una pratica
+comunemente adottata
nella scrittura di programmi in C. Questo tipo di codice @`e address@hidden
semplice da
scrivere e da leggere, ma resta una address@hidden @emph{del programmatore}
assicurarsi che il campo @code{val_type} rifletta correttamente il tipo
@@ -35184,8 +35989,8 @@ di @command{gawk} e riduce il tempo richiesto per
creare il valore.
@node Funzioni di allocazione memoria
@subsection Funzioni per allocare memoria e macro di servizio
@cindex allocare memoria per estensioni
address@hidden memoria, allocare per estensioni
@cindex estensioni, allocare memoria per
address@hidden memoria, allocare per estensioni
L'API fornisce alcune funzioni per effettuare @dfn{allocazioni di memoria}
che possono essere passate a @command{gawk}, e anche un certo numero di
@@ -35424,14 +36229,14 @@ Le funzioni di estensione sono descritte dal seguente
tracciato record:
@example
@group
typedef struct awk_ext_func @{
-@ @ @ @ const char *name;
+@ @ @ @ const char *nome;
@ @ @ @ awk_value_t *(*const function)(int num_actual_args,
@ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @
awk_value_t *risultato,
@ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ struct
awk_ext_func *finfo);
@ @ @ @ const size_t max_expected_args;
@ @ @ @ const size_t min_required_args;
@ @ @ @ awk_bool_t suppress_lint;
-@ @ @ @ void *data; /* puntatore di tipo opaco
+@ @ @ @ void *data; /* puntatore di tipo opaco
@ @ @ @ a ogni informazione ulteriore */
@} awk_ext_func_t;
@end group
@@ -35440,7 +36245,7 @@ typedef struct awk_ext_func @{
I campi sono:
@table @code
address@hidden const char *name;
address@hidden const char *nome;
Il nome della nuova funzione.
Il codice sorgente a livello di @command{awk} richiama la funzione usando
questo nome.
@@ -35511,8 +36316,11 @@ estensione va registrata con @command{gawk} usando
questa funzione dell'API:
@item awk_bool_t add_ext_func(const char *name_space, awk_ext_func_t *func);
Questa funzione restituisce il valore @dfn{true} se ha successo,
oppure @dfn{false} in caso contrario.
-Il parametro @code{name_space} non @`e usato per ora; dovrebbe puntare a una
-stringa vuota (@code{""}). Il puntatore @code{func} @`e l'indirizzo di una
+Il parametro @code{name_space} indica lo spazio-dei-nomi in cui porre
+la funzione (@pxref{Spazi-dei-nomi}).
+Si usi una stringa vuota (@code{""}) o @code{"awk"} per porre la funzione
+nello spazio-dei-nomi @code{awk}, che @`e quello di default.
+Il puntatore @code{func} @`e l'indirizzo di una struttura
@code{struct} che rappresenta la funzione stessa, come descritto sopra.
@command{gawk} non modifica address@hidden che @`e puntato da @code{func}, ma
la
@@ -35657,7 +36465,7 @@ struttura @code{awk_input_parser_t}, simile a questa:
@example
@group
typedef struct awk_input_parser @{
- const char *name; /* nome dell'analizzatore */
+ const char *nome; /* nome dell'analizzatore */
awk_bool_t (*can_take_file)(const awk_input_buf_t *iobuf);
awk_bool_t (*take_control_of)(awk_input_buf_t *iobuf);
awk_const struct awk_input_parser *awk_const next; /* per uso
@@ -35669,7 +36477,7 @@ typedef struct awk_input_parser @{
I campi sono:
@table @code
address@hidden const char *name;
address@hidden const char *nome;
Il nome dell'analizzatore di input. Questa @`e una normale stringa di
caratteri
del linguaggio C.
@@ -35702,7 +36510,7 @@ La definizione di una struttura @code{awk_input_buf_t}
@`e simile a questa:
@example
typedef struct awk_input @{
- const char *name; /* nome file */
+ const char *nome; /* nome file */
int fd; /* descrittore di file */
#define INVALID_HANDLE (-1)
void *opaque; /* area dati privata
@@ -35722,7 +36530,7 @@ inizialmente) da @address@hidden()}, e quelli che sono
usati da
@`e address@hidden@dotless{i}} definito:
@table @code
address@hidden const char *name;
address@hidden const char *nome;
Il nome del file.
@item int fd;
@@ -35787,7 +36595,7 @@ Se @code{fd} @`e ancora diverso da
@code{INVALID_HANDLE} dopo la chiamata a
questa funzione, @command{gawk} invoca la normale chiamata di sistema
@code{close()}.
-Avere una funzione di ``pulizia'' @`e facoltativo. Se l'analizzatore di input
+Avere una funzione di ``pulizia'' @`e opzionale. Se l'analizzatore di input
non ne ha bisogno, basta non impostare questo campo. In questo caso,
@command{gawk} invoca la normale chiamata di sistema @code{close()} per il
descrittore di file, che, quindi, dovrebbe essere valido.
@@ -35963,7 +36771,7 @@ all'analizzatore di input:
@example
typedef struct awk_output_wrapper @{
- const char *name; /* nome del processore */
+ const char *nome; /* nome del processore */
awk_bool_t (*can_take_file)(const awk_output_buf_t *outbuf);
awk_bool_t (*take_control_of)(awk_output_buf_t *outbuf);
awk_const struct awk_output_wrapper *awk_const next; /* per gawk */
@@ -35973,7 +36781,7 @@ typedef struct awk_output_wrapper @{
I campi sono i seguenti:
@table @code
address@hidden const char *name;
address@hidden const char *nome;
Questo @`e il nome del processore di output.
@item awk_bool_t (*can_take_file)(const awk_output_buf_t *outbuf);
@@ -36001,8 +36809,8 @@ La struttura @code{awk_output_buf_t} @`e simile a
questa:
@example
typedef struct awk_output_buf @{
- const char *name; /* nome del file in output */
- const char *mode; /* argomento @dfn{mode} per fopen */
+ const char *nome; /* nome del file in output */
+ const char *modo; /* argomento @dfn{mode} per fopen */
FILE *fp; /* puntatore stdio file */
awk_bool_t redirected; /* @dfn{true} se un processore @`e attivo */
void *opaque; /* per uso del processore di output */
@@ -36020,10 +36828,10 @@ campi dati in @code{awk_output_buf_t}.
I campi dati sono i seguenti:
@table @code
address@hidden const char *name;
address@hidden const char *nome;
Il nome del file in output.
address@hidden const char *mode;
address@hidden const char *modo;
La stringa @dfn{mode} (come sarebbe usata nel secondo argomento della
chiamata di sistema @code{fopen()})
con cui il file era stato aperto.
@@ -36056,7 +36864,7 @@ appropriate per fare il lavoro richiesto.
@end table
La funzione @address@hidden()} dovrebbe decidere in base ai
-campi @code{name} e @code{mode}, e a ogni altro ulteriore indicatore di stato
+campi @code{nome} e @code{modo}, e a ogni altro ulteriore indicatore di stato
(p.es., valori di variabili @command{awk}) adatto allo scopo.
Quando @command{gawk} chiama @address@hidden()}, la funzione
@@ -36088,9 +36896,9 @@ Un processore bidirezionale @`e rappresentato dalla
struttura seguente:
@example
typedef struct awk_two_way_processor @{
- const char *name; /* nome del processore bidirezionale */
- awk_bool_t (*can_take_two_way)(const char *name);
- awk_bool_t (*take_control_of)(const char *name,
+ const char *nome; /* nome del processore bidirezionale */
+ awk_bool_t (*can_take_two_way)(const char *nome);
+ awk_bool_t (*take_control_of)(const char *nome,
awk_input_buf_t *inbuf,
awk_output_buf_t *outbuf);
awk_const struct awk_two_way_processor *awk_const next; /* per gawk */
@@ -36100,16 +36908,16 @@ typedef struct awk_two_way_processor @{
I campi sono i seguenti:
@table @code
address@hidden const char *name;
address@hidden const char *nome;
Il nome del processore bidirezionale.
address@hidden awk_bool_t (*can_take_two_way)(const char *name);
address@hidden awk_bool_t (*can_take_two_way)(const char *nome);
La funzione puntata da questo campo dovrebbe restituire @dfn{true} se
vuole gestire l'I/O bidirezionale per questo @value{FN}.
La funzione non dovrebbe modificare alcuno stato (valori di variabili, etc.)
all'interno di @command{gawk}.
address@hidden awk_bool_t (*take_control_of)(const char *name,
address@hidden awk_bool_t (*take_control_of)(const char *nome,
@itemx @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @
awk_input_buf_t *inbuf,
@itemx @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @
awk_output_buf_t *outbuf);
La funzione puntata da questo campo dovrebbe riempire le strutture
@@ -36447,11 +37255,11 @@ contiene informazioni sui simboli @`e chiamata
@dfn{Tabella dei simboli}
Le funzioni sono le seguenti:
@table @code
address@hidden awk_bool_t sym_lookup(const char *name,
address@hidden awk_bool_t sym_lookup(const char *nome,
@itemx @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ awk_valtype_t wanted,
@itemx @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ awk_value_t *risultato);
Riempie la struttura @code{awk_value_t} puntata da @code{risultato}
-con il valore della variabile il cui nome @`e nella stringa @code{name},
+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.
La funzione restituisce @dfn{true} se il tipo effettivo della variabile @`e
quello
@@ -36460,8 +37268,21 @@ In quest'ultimo caso, @code{risultato>val_type} indica
il tipo effettivo
della variabile
(@pxref{table-value-types-returned}).
address@hidden awk_bool_t sym_update(const char *name, awk_value_t *valore);
-Aggiorna la variabile il cui nome @`e contenuto nella stringa @code{name},
address@hidden awk_bool_t sym_lookup_ns(const char *nome,
address@hidden @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ const char
*name_space,
address@hidden @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ awk_valtype_t
wanted,
address@hidden @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ awk_value_t
*risultato);
+Simile a @code{sym_lookup()}, ma il parametro @code{name_space} consente di
+specificare a quale spazio-di-nomi appartiene @code{nome}.
address@hidden non address@hidden essere la stringa nulla (@code{NULL}).
+Se vale @code{""} o @code{"awk"}, allora @code{nome} @`e cercato nello
+spazio-di-nomi di default, ossia @code{awk}.
+
+Note that @code{namespace} is a C++ keyword. For interoperability with C++,
+you should avoid using that identifier in C code.
+
address@hidden awk_bool_t sym_update(const char *nome, awk_value_t *valore);
+Aggiorna la variabile il cui nome @`e contenuto nella stringa @code{nome},
che @`e una normale stringa di caratteri C.
La variabile @`e aggiunta alla Tabella dei simboli di @command{gawk},
se non @`e address@hidden presente. Restituisce @dfn{true} se tutto @`e
andato bene, e
@@ -36737,7 +37558,7 @@ la funzione @code{release_value()}.
@node Manipolazione di vettori
@subsection Manipolazione di vettori
@cindex vettori, manipolazione nelle estensioni
address@hidden estensioni, manipolazione di vettori
address@hidden estensioni, manipolazione di vettori nelle
La struttura di dati address@hidden'accordo, l'unica struttura di dati.}
in @command{awk} @`e il vettore associativo
@@ -36988,7 +37809,7 @@ dump_array_and_delete(int nargs, awk_value_t *risultato)
awk_value_t valore, valore2, valore3;
awk_flat_array_t *flat_array;
size_t count;
- char *name;
+ char *nome;
int i;
assert(risultato != NULL);
@@ -37010,13 +37831,13 @@ messaggio di errore e si ritorna al chiamante:
/* trasforma in un vettore piatto il vettore
passato come argomento e lo stampa */
if (get_argument(0, AWK_STRING, & value)) @{
- name = valore.str_value.str;
- if (sym_lookup(name, AWK_array, & value2))
+ nome = valore.str_value.str;
+ if (sym_lookup(nome, AWK_array, & value2))
printf("dump_array_and_delete: sym_lookup di %s effettuato\n",
- name);
+ nome);
else @{
printf("dump_array_and_delete: sym_lookup di %s non riuscito\n",
- name);
+ nome);
goto out;
@}
@} else @{
@@ -37085,7 +37906,7 @@ visita il vettore appiattito, ed elimina ogni elemento
in cui il relativo
@example
for (i = 0; i < flat_array->count; i++) @{
printf("\t%s[\"%.*s\"] = %s\n",
- name,
+ nome,
(int) flat_array->elements[i].index.str_value.len,
flat_array->elements[i].index.str_value.str,
valrep2str(& flat_array->elements[i].valore));
@@ -37327,13 +38148,13 @@ elemento sia a sua volta un vettore:
@example
@@load "subarray"
-function dumparray(name, vettore, i)
+function dumparray(nome, vettore, i)
@{
for (i in vettore)
if (isarray(vettore[i]))
- dumparray(name "[\"" i "\"]", vettore[i])
+ dumparray(nome "[\"" i "\"]", vettore[i])
else
- printf("%s[\"%s\"] = %s\n", name, i, vettore[i])
+ printf("%s[\"%s\"] = %s\n", nome, i, vettore[i])
@}
BEGIN @{
@@ -37361,15 +38182,15 @@ La seguente funzione consente alle estensioni di
accedere e di manipolare
delle ridirezioni.
@table @code
address@hidden awk_bool_t get_file(const char *name,
address@hidden awk_bool_t get_file(const char *nome,
@itemx @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ size_t name_len,
@itemx @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ const char *tipofile,
@itemx @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ int fd,
@itemx @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ const awk_input_buf_t **ibufp,
@itemx @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ const awk_output_buf_t **obufp);
-Ricerca il file @code{name} nella tabella interna di ridirezione di
+Ricerca il file @code{nome} nella tabella interna di ridirezione di
@command{gawk}.
-Se @code{name} @`e @code{NULL} o @code{name_len} @`e zero, restituisce
+Se @code{nome} @`e @code{NULL} o @code{name_len} @`e zero, restituisce
i dati del file in input correntemente aperto il cui nome @`e memorizzato in
@code{FILENAME}.
(Questa chiamata non usa l'argomento @code{filetype}, che, quindi,
address@hidden essere
@@ -37458,7 +38279,7 @@ insieme contiene informazioni su come @command{gawk}
@`e stato invocato.
@node Versione dell'estensione
@subsubsection Costanti e variabili della versione dell'API
address@hidden API, versione
address@hidden API, versione dell'estensione
@cindex versione dell'estensione API @command{gawk}
@cindex estensione @command{gawk}, versione API
@@ -37477,7 +38298,8 @@ condizionale, e come elencazione di costanti per
facilitare il debug:
@end float
La versione secondaria aumenta quando nuove funzioni sono aggiunte all'API.
-Tali nuove funzioni sono sempre aggiunte alla fine della @code{struct}
dell'API.
+Tali nuove funzioni sono sempre aggiunte alla fine della struttura
address@hidden dell'API.
La versione principale aumenta (e la versione secondaria torna a zero) se
qualche tipo di dati cambia dimensione o si modifica l'ordine dei campi, o se
@@ -37487,7 +38309,7 @@ address@hidden capitare che un'estensione sia stata
compilata con una versione
dell'API ma caricata da una versione di @command{gawk} che ne usa una
differente. Per questo motivo, la versione principale e quella secondaria
dell'API della versione in uso di @command{gawk} sono incluse nella
address@hidden dell'API come costanti intere in sola lettura:
+struttura @code{struct} dell'API come costanti intere in sola lettura:
@table @code
@item api->major_version
@@ -37528,7 +38350,7 @@ in
L'API include anche informazioni sulle versioni di GMP ed MPFR con cui
il comando @command{gawk} in esecuzione @`e stato compilato (se disponibile).
-Queste sono incluse nella @code{struct} dell'API come costanti intere
+Queste sono incluse nella struttura @code{struct} dell'API come costanti intere
in sola lettura:
@table @code
@@ -38179,7 +39001,7 @@ compresa una tabella per tradurre i tipi di file in
stringhe:
vettore con informazioni da stat */
static int
-fill_stat_array(const char *name, awk_array_t vettore, struct stat *sbuf)
+fill_stat_array(const char *nome, awk_array_t vettore, struct stat *sbuf)
@{
char *pmode; /* @dfn{mode} stampabile */
const char *type = "unknown";
@@ -38215,7 +39037,7 @@ i vari elementi prendendoli dai valori presenti in
@code{struct stat}:
clear_array(vettore);
/* riempie il vettore */
- array_set(vettore, "name", make_const_string(name, strlen(name),
+ array_set(vettore, "name", make_const_string(nome, strlen(nome),
& tmp));
array_set_numeric(vettore, "dev", sbuf->st_dev);
array_set_numeric(vettore, "ino", sbuf->st_ino);
@@ -38260,14 +39082,14 @@ tutto @`e andato bene:
char *buf;
ssize_t linksize;
- if ((buf = read_symlink(name, sbuf->st_size,
+ if ((buf = read_symlink(nome, sbuf->st_size,
& linksize)) != NULL)
array_set(vettore, "linkval",
make_malloced_string(buf, linksize, & tmp));
else
warning(ext_id, _("stat: non riesco a leggere il \
collegamento simbolico `%s'"),
- name);
+ nome);
@}
/* aggiunge il tipo di campo */
@@ -38286,7 +39108,7 @@ collegamento simbolico `%s'"),
@end example
Del terzo argomento passato a @code{stat()} non si era ancora parlato.
-Questo argomento @`e facoltativo. Se presente, dice a @code{do_stat()} di
+Questo argomento @`e opzionale. Se presente, dice a @code{do_stat()} di
usare la chiamata di sistema @code{stat()} invece della chiamata di sistema
@code{lstat()}. Questo avviene attraverso un puntatore a funzione:
@code{statfunc}.
@@ -38306,7 +39128,7 @@ static awk_value_t *
do_stat(int nargs, awk_value_t *risultato, struct awk_ext_func *non_usata)
@{
awk_value_t file_param, array_param;
- char *name;
+ char *nome;
awk_array_t vettore;
int ret;
struct stat sbuf;
@@ -38335,7 +39157,7 @@ Poi, ottiene le informazioni relative al file. Se la
funzione chiamata
statfunc = stat;
@}
- name = file_param.str_value.str;
+ nome = file_param.str_value.str;
vettore = array_param.array_cookie;
/* svuota sempre il vettore all'inizio */
@@ -38344,7 +39166,7 @@ Poi, ottiene le informazioni relative al file. Se la
funzione chiamata
/* chiama stat per il file;
in caso di errore,
imposta ERRNO e ritorna */
- ret = statfunc(name, & sbuf);
+ ret = statfunc(nome, & sbuf);
@group
if (ret < 0) @{
update_ERRNO_int(errno);
@@ -38359,7 +39181,7 @@ impostato da @code{fill_stat_array()}:
@example
@group
- ret = fill_stat_array(name, vettore, & sbuf);
+ ret = fill_stat_array(nome, vettore, & sbuf);
return make_number(ret, risultato);
@}
@@ -38853,7 +39675,7 @@ else
@subsection Consentire la modifica in loco dei file
@cindex @code{inplace}, estensione
address@hidden estensione @code{inplace}
address@hidden estensione @code{inplace()}
L'estensione @code{inplace} svolge un lavoro simile a quello
dell'opzione @option{-i} nel programma di address@hidden GNU @command{sed},
che svolge delle funzioni di modifica ``al volo'' su ogni file in input.
@@ -38867,22 +39689,22 @@ l'estensione in maniera corretta:
@c endfile
@ignore
@c file eg/lib/inplace.awk
-#
+#
# Copyright (C) 2013, 2017 the Free Software Foundation, Inc.
-#
+#
# This file is part of GAWK, the GNU implementation of the
# AWK Programming Language.
-#
+#
# GAWK is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation; either version 3 of the License, or
# (at your option) any later version.
-#
+#
# GAWK is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
# GNU General Public License for more details.
-#
+#
# You should have received a copy of the GNU General Public License
# along with this program; if not, write to the Free Software
# Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301,
USA
@@ -38999,12 +39821,12 @@ L'estensione @code{ordchr} aggiunge due funzioni, di
nome
Questo @`e il modo per caricare l'estensione.
@cindex @code{ord()}, estensione
address@hidden estensione @code{Ord}
address@hidden estensione @code{ord()}
@item numero = ord(stringa)
Restituisce il valore numerico del primo carattere in @code{stringa}.
@cindex @code{Chr}, estensione
address@hidden estensione @code{Chr}
address@hidden estensione @code{chr()}
@item char = chr(number)
Restituisce una stringa il cui primo carattere @`e quello rappresentato
da @code{number}.
@@ -39028,7 +39850,7 @@ per esaminare directory.
L'uso @`e il seguente:
@cindex @code{readdir}, estensione
address@hidden estensione @code{readdir}
address@hidden estensione @code{readdir()}
@example
@@load "readdir"
@end example
@@ -39090,7 +39912,7 @@ a prima vista vagamente divertente.
Ecco un esempio:
@cindex @code{revoutput}, estensione
address@hidden estensione @code{revoutput}
address@hidden estensione @code{revoutput()}
@example
@@load "revoutput"
@@ -39113,7 +39935,7 @@ sembrare un programma vagamente divertente.
Il seguente esempio mostra come usarlo:
@cindex @code{revtwoway}, estensione
address@hidden estensione @code{revtwoway}
address@hidden estensione @code{revtwoway()}
@example
@@load "revtwoway"
@@ -39275,10 +40097,10 @@ ottenere il tempo di attesa richiesto.
@node Esempio di estensione API Test
@subsection Test per la API
@cindex @code{testext}, estensione
address@hidden estensione @code{testext}
address@hidden estensione @code{testext()}
L'estensione @code{testext} controlla la address@hidden di
-parti dell'API delle estensioni che non sono utilizzate negli altri esempi.
+parti dell'estensione API che non sono utilizzate negli altri esempi.
Il file @file{extension/testext.c}
contiene sia il codice C per l'estensione che il codice @command{awk}
(tra i commenti del codice C) per eseguire i test. L'ambiente di test
@@ -39544,7 +40366,7 @@ o quello che legge dei semplici byte?
@item
(Difficile.)
-Come si potrebbero gestire degli insiemi di nomi (@dfn{namespaces})
+Come si potrebbero gestire degli insiemi di nomi (@dfn{spazi-dei-nomi})
in @command{gawk}, in modo
che i nomi di funzione presenti in estensioni differenti non siano in conflitto
tra loro?
@@ -40732,7 +41554,7 @@ sono consentite anche se @`e stata specificata
l'opzione @option{--posix} o
nello standard POSIX.
@item
-Un terzo argomento facoltativo per le funzioni @code{asort()} e @code{asorti()}
+Un terzo argomento opzionale per le funzioni @code{asort()} e @code{asorti()}
permette di specificare il tipo di ordinamento desiderato
(@pxref{Funzioni per stringhe}).
@@ -40982,7 +41804,7 @@ Il vettore @code{PROCINFO["argv"]}.
Il numero massimo di cifre esadecimali consentito nelle sequenze di
protezione @samp{\x} @`e ora limitato a due.
@xref{Sequenze di protezione}.
-
+
@item
Costanti @dfn{regexp} forti nella forma @samp{@@/@dots{}/}
(@pxref{Costanti @dfn{regexp} forti}).
@@ -40999,7 +41821,7 @@ La funzione @code{intdiv0()}.
@end ifset
@item
-La funzione @code{mktime()} ora accetta un secondo argomento facoltativo
+La funzione @code{mktime()} ora accetta un secondo argomento opzionale
(@pxref{Funzioni di tempo}).
@item
@@ -41527,7 +42349,7 @@ Lo sviluppo dell'estensione API rilasciata per la prima
volta con
Arnold Robbins e Andrew Schorr, con notevoli contributi dal
resto del team di sviluppo.
address@hidden Malmberg, John E.
address@hidden Malmberg, John
@item
John Malmberg ha apportato miglioramenti significativi alla versione
OpenVMS e alla relativa documentazione.
@@ -42588,14 +43410,14 @@ abbreviazioni CRC per simboli address@hidden lunghi
di 32 bit.
Per Alpha e Itanium:
@example
-/name=(as_is,short)
+/nome=(as_is,short)
/float=ieee/ieee_mode=denorm_results
@end example
Per VAX:
@example
-/name=(as_is,short)
+/nome=(as_is,short)
@end example
Le macro da usare al momento della compilazione devono essere definite prima di
@@ -42724,9 +43546,10 @@ per forzare un esame dei parametri in stile Unix,
piuttosto che nella address@hidden
parametri, per esempio, address@hidden @value{DF} in input) @`e presente, non
c'@`e address@hidden,
e l'opzione @option{--} address@hidden essere omessa.
address@hidden exit, codice di ritorno, in VMS
address@hidden codice di ritorno, di @command{gawk}, in VMS
address@hidden exit, codice di ritorno, di @command{gawk}, in VMS
Il valore di @code{exit} @`e un valore in stile Unix e viene trasformato in
-una condizione VMS all'uscita del programma.
+un codice di ritorno VMS all'uscita del programma.
I bit di address@hidden di VMS saranno impostati a partire dal valore
dell'istruzione
@code{exit}. Un errore grave @`e indicato da 1, e VMS imposta la condizione
@@ -43224,12 +44047,12 @@ Il progetto sembra essere stato congelato; non ci
sono state modifiche nel
codice sorgente dal 2001 circa.
@cindex Beebe, Nelson H.F.@:
address@hidden @command{pawk} (versione con profilatura di Brian Kernighan
@command{awk})
address@hidden @command{pawk} (versione con profilazione di Brian Kernighan
@command{awk})
@cindex codice sorgente, @command{pawk}
@cindex sorgente, codice, @command{pawk}
@item @command{pawk}
Nelson H.F.@: Beebe all'address@hidden dello Utah ha modificato
-BWK @command{awk} per fornire informazioni di temporizzazione e profilatura.
+BWK @command{awk} per fornire informazioni di temporizzazione e profilazione.
Questo @`e differente dall'usare @command{gawk} con l'opzione
@option{--profile}
(@pxref{Profilare})
nel senso che fornisce un profilo basato sul consumo di CPU, non sul
@@ -43281,6 +44104,7 @@ mette a disposizione questa implementazione. Si
possono vedere i singoli file i
@cindex Go, implementazione di @command{awk}
@cindex sorgente, @command{goawk}
@cindex @command{goawk}, sorgente di
address@hidden linguaggio di programmazione, Go
@item @command{goawk}
Questo @`e un interpretatore di @command{awk} scritto nel
@uref{https://golang.org/, Linguaggio di programmazion Go}.
@@ -43752,21 +44576,8 @@ sono mantenuti da terze persone e non dagli
sviluppatori di @command{gawk}.
Quindi, non si dovrebbero cambiare, se non per ragioni molto
valide; vale a dire, modifiche a questi file non sono impossibili, ma
le modifiche a questi file saranno controllate con estrema attenzione.
-I file sono
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden,
address@hidden
-e
address@hidden
+Questi file sono tutti quelli contenuti nella directory @file{support}
+presente nella distribuzione di @command{gawk}. Vedere direttamente
address@hidden
@item
Un certo numero di altri file sono prodotti dagli Autotool [comandi di
@@ -43782,7 +44593,6 @@ valide. I file sono
@file{install-sh},
@file{missing},
@file{mkinstalldirs},
address@hidden
e
@file{ylwrap}.
@@ -43965,9 +44775,10 @@ Sarebbe sicuramente d'aiuto se tutti usassero le
stesse versioni degli Autotool
GNU che lui usa, che in generale sono le ultime versioni rilasciate di
Automake,
Autoconf,
address@hidden
address@hidden,
+GNU @command{gettext}
e
-GNU @command{gettext}.
+Libtool.
@ignore
If it would help if I sent out an ``I just upgraded to version x.y
@@ -44367,7 +45178,7 @@ consente a @command{gawk} di identificare l'estensione
che lo chiama, se la
cosa dovesse risultare necessaria.
@item
-Analogamente, l'estensione passa uno ``spazio dei nomi'' a @command{gawk}
+Analogamente, l'estensione passa uno ``spazio-dei-nomi'' a @command{gawk}
in fase di registrazione di ogni funzione estesa. Questo @`e fatto in vista di
un possibile futuro meccanismo per raggruppare funzioni di estensione, e per
evitare in questo modo possibili conflitti nei nomi di funzione.
@@ -44409,9 +45220,9 @@ address@hidden richieste dal progetto @code{xgawk}, e a
fornire una
address@hidden binaria in futuro.
@item
-Il precedente meccanismo di estensione @`e ancora supportato
-nella @value{PVERSION} 4.1
-di @command{gawk}, ma address@hidden @emph{rimosso} nella prossima versione
principale.
+Il precedente meccanismo di estensione non @`e address@hidden supportato
+ed @`e stato rimosso dal codice sorgente nella
address@hidden 4.2.
@end itemize
-----------------------------------------------------------------------
Summary of changes:
ChangeLog | 8919 +---------------------------------
ChangeLog => ChangeLog.1 | 4 +
README | 21 +-
README_d/ChangeLog | 190 +-
README_d/{ChangeLog => ChangeLog.1} | 0
awklib/ChangeLog | 106 +-
awklib/{ChangeLog => ChangeLog.1} | 0
cmake/ChangeLog | 4 +
configure | 20 +-
configure.ac | 2 +-
doc/ChangeLog | 2909 +----------
doc/{ChangeLog => ChangeLog.1} | 0
doc/gawk.info | 418 +-
doc/gawk.texi | 4 +-
doc/gawktexi.in | 4 +-
doc/it/ChangeLog | 8 +
doc/it/gawktexi.in | 1389 ++++--
extension/ChangeLog | 1699 +------
extension/{ChangeLog => ChangeLog.1} | 0
extension/build-aux/ChangeLog | 4 +
extension/configure | 20 +-
extension/configure.ac | 2 +-
extension/m4/ChangeLog | 4 +
extension/po/ChangeLog | 4 +
extras/ChangeLog | 4 +
helpers/ChangeLog | 4 +
m4/ChangeLog | 196 +-
m4/{ChangeLog => ChangeLog.1} | 0
missing_d/ChangeLog | 137 +-
missing_d/{ChangeLog => ChangeLog.1} | 0
old-extension/ChangeLog | 4 +
pc/ChangeLog | 949 +---
pc/{ChangeLog => ChangeLog.1} | 0
pc/config.h | 6 +-
po/ChangeLog | 174 +-
po/{ChangeLog => ChangeLog.1} | 0
po/ca.gmo | Bin 74367 -> 74367 bytes
po/ca.po | 2 +-
po/da.gmo | Bin 46834 -> 46834 bytes
po/da.po | 2 +-
po/de.gmo | Bin 83303 -> 83303 bytes
po/de.po | 2 +-
po/es.gmo | Bin 81169 -> 81169 bytes
po/es.po | 2 +-
po/fi.gmo | Bin 80621 -> 80621 bytes
po/fi.po | 2 +-
po/fr.gmo | Bin 91724 -> 91724 bytes
po/fr.po | 2 +-
po/gawk.pot | 4 +-
po/id.gmo | Bin 67806 -> 67806 bytes
po/id.po | 2 +-
po/it.gmo | Bin 87658 -> 87658 bytes
po/it.po | 2 +-
po/ja.gmo | Bin 47557 -> 47557 bytes
po/ja.po | 2 +-
po/ko.gmo | Bin 95090 -> 95090 bytes
po/ko.po | 2 +-
po/ms.gmo | Bin 1082 -> 1082 bytes
po/ms.po | 2 +-
po/nl.gmo | Bin 72811 -> 72811 bytes
po/nl.po | 2 +-
po/pl.gmo | Bin 59447 -> 59447 bytes
po/pl.po | 2 +-
po/pt_BR.gmo | Bin 88193 -> 88193 bytes
po/pt_BR.po | 2 +-
po/sv.gmo | Bin 87838 -> 87838 bytes
po/sv.po | 2 +-
po/vi.gmo | Bin 90729 -> 90729 bytes
po/vi.po | 2 +-
po/zh_CN.gmo | Bin 82141 -> 82141 bytes
po/zh_CN.po | 2 +-
posix/ChangeLog | 98 +-
posix/{ChangeLog => ChangeLog.1} | 0
support/ChangeLog | 229 +-
support/{ChangeLog => ChangeLog.0} | 0
test/ChangeLog | 2426 +--------
test/{ChangeLog => ChangeLog.1} | 0
vms/ChangeLog | 511 +-
vms/{ChangeLog => ChangeLog.1} | 0
vms/vax/ChangeLog | 4 +
80 files changed, 1464 insertions(+), 19047 deletions(-)
mode change 100755 => 100644 ChangeLog
copy ChangeLog => ChangeLog.1 (99%)
copy README_d/{ChangeLog => ChangeLog.1} (100%)
copy awklib/{ChangeLog => ChangeLog.1} (100%)
copy doc/{ChangeLog => ChangeLog.1} (100%)
copy extension/{ChangeLog => ChangeLog.1} (100%)
copy m4/{ChangeLog => ChangeLog.1} (100%)
copy missing_d/{ChangeLog => ChangeLog.1} (100%)
copy pc/{ChangeLog => ChangeLog.1} (100%)
copy po/{ChangeLog => ChangeLog.1} (100%)
copy posix/{ChangeLog => ChangeLog.1} (100%)
copy support/{ChangeLog => ChangeLog.0} (100%)
copy test/{ChangeLog => ChangeLog.1} (100%)
copy vms/{ChangeLog => ChangeLog.1} (100%)
hooks/post-receive
--
gawk
| [Prev in Thread] |
Current Thread |
[Next in Thread] |
- [gawk-diffs] [SCM] gawk branch, master, updated. gawk-4.1.0-3701-gb4e4ba4,
Arnold Robbins <=