aboutsummaryrefslogtreecommitdiffstats
path: root/doc
diff options
context:
space:
mode:
Diffstat (limited to 'doc')
-rw-r--r--doc/ChangeLog6
-rw-r--r--doc/gawk.15
-rw-r--r--doc/gawktexi.in8
3 files changed, 13 insertions, 6 deletions
diff --git a/doc/ChangeLog b/doc/ChangeLog
index f31aae7f..261388a2 100644
--- a/doc/ChangeLog
+++ b/doc/ChangeLog
@@ -1,3 +1,9 @@
+2018-11-29 Arnold D. Robbins <arnold@skeeve.com>
+
+ * gawktexi.in (Auto-set): Document that you can no longer use
+ arbitrary indices in SYMTAB.
+ * gawk.1: Ditto.
+
2018-11-27 Arnold D. Robbins <arnold@skeeve.com>
* gawktexi.in (Other Versions): Document GoAWK, an awk interpreter
diff --git a/doc/gawk.1 b/doc/gawk.1
index 5caff79b..4964cb3d 100644
--- a/doc/gawk.1
+++ b/doc/gawk.1
@@ -13,7 +13,7 @@
. if \w'\(rq' .ds rq "\(rq
. \}
.\}
-.TH GAWK 1 "Nov 26 2018" "Free Software Foundation" "Utility Commands"
+.TH GAWK 1 "Nov 29 2018" "Free Software Foundation" "Utility Commands"
.SH NAME
gawk \- pattern scanning and processing language
.SH SYNOPSIS
@@ -1425,7 +1425,8 @@ You may not use the
.B delete
statement with the
.B SYMTAB
-array.
+array, nor assign to elements with an index that is
+not a variable name.
.TP
.B TEXTDOMAIN
The text domain of the \*(AK program; used to find the localized
diff --git a/doc/gawktexi.in b/doc/gawktexi.in
index 9a21913b..cc667534 100644
--- a/doc/gawktexi.in
+++ b/doc/gawktexi.in
@@ -15253,7 +15253,8 @@ if an element in @code{SYMTAB} is an array.
Also, you may not use the @code{delete} statement with the
@code{SYMTAB} array.
-You may use an index for @code{SYMTAB} that is not a predefined identifier:
+Prior to @value{PVERSION} 5.0 of @command{gawk}, you could
+use an index for @code{SYMTAB} that was not a predefined identifier:
@example
SYMTAB["xxx"] = 5
@@ -15261,9 +15262,8 @@ print SYMTAB["xxx"]
@end example
@noindent
-This works as expected: in this case @code{SYMTAB} acts just like
-a regular array. The only difference is that you can't then delete
-@code{SYMTAB["xxx"]}.
+This no longer works, instead producing a fatal error, as it led
+to rampant confusion.
@cindex Schorr, Andrew
The @code{SYMTAB} array is more interesting than it looks. Andrew Schorr