Document acceptable indices <M>+<N>, <M>-<N>, end-<N> that TIP #577 made available.

8 files changed, 26 insertions, 1 deletions

diff --git a/doc/entry.n b/doc/entry.n
index 23b8cab..80e8428 100644
--- a/doc/entry.n
+++ b/doc/entry.n
@@ -239,6 +239,9 @@ or
 .QW \fBsel.f\fR .
 In general, out-of-range indices are automatically rounded to the
 nearest legal value.
+Indexes support the same simple interpretation as
+for the command \fBstring index\fR, with simple integer index
+arithmetic and indexing relative to \fBend\fR.
 .SS SUBCOMMANDS
 .PP
 The following commands are possible for entry widgets:
diff --git a/doc/listbox.n b/doc/listbox.n
index aa87904..fa24ec7 100644
--- a/doc/listbox.n
+++ b/doc/listbox.n
@@ -126,6 +126,9 @@ specified by \fIx\fR and \fIy\fR (in pixel coordinates).  If no
 element covers that point, then the closest element to that
 point is used.
 .LP
+Indexes support the same simple interpretation as
+for the command \fBstring index\fR, with simple integer index
+arithmetic and indexing relative to \fBend\fR.
 In the widget command descriptions below, arguments named \fIindex\fR,
 \fIfirst\fR, and \fIlast\fR always contain text indices in one of
 the above forms.
diff --git a/doc/menu.n b/doc/menu.n
index 42d1775..109a94b 100644
--- a/doc/menu.n
+++ b/doc/menu.n
@@ -366,6 +366,9 @@ are used.
 .PP
 If the index could match more than one of the above forms, then
 the form earlier in the above list takes precedence.
+Indexes support the same simple interpretation as
+for the command \fBstring index\fR, with simple integer index
+arithmetic and indexing relative to \fBend\fR.
 .PP
 The following widget commands are possible for menu widgets:
 .TP
diff --git a/doc/spinbox.n b/doc/spinbox.n
index d33c2d2..104ef13 100644
--- a/doc/spinbox.n
+++ b/doc/spinbox.n
@@ -288,6 +288,9 @@ or
 .QW \fBsel.f\fR .
 In general, out-of-range indices are automatically rounded to the
 nearest legal value.
+Indexes support the same simple interpretation as
+for the command \fBstring index\fR, with simple integer index
+arithmetic and indexing relative to \fBend\fR.
 .SS SUBCOMMANDS
 .PP
 The following commands are possible for spinbox widgets:
diff --git a/doc/ttk_combobox.n b/doc/ttk_combobox.n
index b6eddd8..fdc51af 100644
--- a/doc/ttk_combobox.n
+++ b/doc/ttk_combobox.n
@@ -65,7 +65,9 @@ combobox widgets support the following additional commands:
 If \fInewIndex\fR is supplied, sets the combobox value
 to the element at position \fInewIndex\fR in the list of \fB\-values\fR
 (in addition to integers, the \fBend\fR index is supported and indicates
-the last element of the list).
+the last element of the list, moreover the same simple interpretation as
+for the command \fBstring index\fR is supported, with simple integer index
+arithmetic and indexing relative to \fBend\fR).
 Otherwise, returns the index of the current value in the list of
 \fB\-values\fR or \fB\-1\fR if the current value does not appear in the list.
 .TP
diff --git a/doc/ttk_entry.n b/doc/ttk_entry.n
index 816c08b..e71bd01 100644
--- a/doc/ttk_entry.n
+++ b/doc/ttk_entry.n
@@ -137,6 +137,9 @@ or
 .QW \fBsel.l\fR .
 In general, out-of-range indices are automatically rounded to the
 nearest legal value.
+Indexes support the same simple interpretation as
+for the command \fBstring index\fR, with simple integer index
+arithmetic and indexing relative to \fBend\fR.
 .SH "WIDGET COMMAND"
 .PP
 In addition to the standard
diff --git a/doc/ttk_notebook.n b/doc/ttk_notebook.n
index bc6c95a..869e4bf 100644
--- a/doc/ttk_notebook.n
+++ b/doc/ttk_notebook.n
@@ -101,6 +101,10 @@ The literal string
 which returns the number of tabs
 (only valid for
 .QW "\fIpathname \fBindex\fR" ).
+.PP
+Indexes support the same simple interpretation as
+for the command \fBstring index\fR, with simple integer index
+arithmetic and indexing relative to \fBend\fR.
 .SH "WIDGET COMMAND"
 .PP
 In addition to the standard
diff --git a/doc/ttk_treeview.n b/doc/ttk_treeview.n
index c163603..757be86 100644
--- a/doc/ttk_treeview.n
+++ b/doc/ttk_treeview.n
@@ -556,6 +556,10 @@ An integer \fIn\fR, specifying the \fIn\fRth data column.
 A string of the form \fB#\fIn\fR, where \fIn\fR is an integer,
 specifying the \fIn\fRth display column.
 .PP
+Column identifiers support the same simple interpretation as
+for the command \fBstring index\fR, with simple integer index
+arithmetic and indexing relative to \fBend\fR.
+.PP
 \fBNOTE:\fR
 Item \fB\-values\fR may be displayed in a different order than
 the order in which they are stored.