ttk widget testfiles: add note/warning regarding usage of tcltest options "-match", "-skip" and "-limitconstraints 1" for the ttk test suite

1minus1is0 · 1minus1is0 · commit 143e1a0dda9b · 2025-12-03T19:39:29.000Z
diff --git a/tests/ttk/checkbutton.test b/tests/ttk/checkbutton.test
@@ -2,6 +2,19 @@
 # ttk::checkbutton widget tests.
 #
 
+# NOTES
+#
+# * The ttk test suite holds many tests that build upon a previous one. This
+#   is not incidental; it occurs systematically for groups of contiguous tests
+#   in most ttk test files.
+#
+#   A consequence of this practice is that attempts to run tests selectively/
+#   individually using the tcltest options "-match", "-skip" or "-limitconstraints 1"
+#   leads to unintended failures. Therefore, invocations using these options
+#   may be considered invalid for the ttk test suite (but not for the
+#   corresponding core Tk tests).
+#
+
 #
 # TESTFILE INITIALIZATION
 #
diff --git a/tests/ttk/combobox.test b/tests/ttk/combobox.test
@@ -2,6 +2,19 @@
 # ttk::combobox widget tests
 #
 
+# NOTES
+#
+# * The ttk test suite holds many tests that build upon a previous one. This
+#   is not incidental; it occurs systematically for groups of contiguous tests
+#   in most ttk test files.
+#
+#   A consequence of this practice is that attempts to run tests selectively/
+#   individually using the tcltest options "-match", "-skip" or "-limitconstraints 1"
+#   leads to unintended failures. Therefore, invocations using these options
+#   may be considered invalid for the ttk test suite (but not for the
+#   corresponding core Tk tests).
+#
+
 #
 # TESTFILE INITIALIZATION
 #
diff --git a/tests/ttk/entry.test b/tests/ttk/entry.test
@@ -2,6 +2,19 @@
 # ttk::entry widget tests
 #
 
+# NOTES
+#
+# * The ttk test suite holds many tests that build upon a previous one. This
+#   is not incidental; it occurs systematically for groups of contiguous tests
+#   in most ttk test files.
+#
+#   A consequence of this practice is that attempts to run tests selectively/
+#   individually using the tcltest options "-match", "-skip" or "-limitconstraints 1"
+#   leads to unintended failures. Therefore, invocations using these options
+#   may be considered invalid for the ttk test suite (but not for the
+#   corresponding core Tk tests).
+#
+
 #
 # TESTFILE INITIALIZATION
 #
diff --git a/tests/ttk/image.test b/tests/ttk/image.test
@@ -2,6 +2,19 @@
 # Tests for images in various ttk widgets
 #
 
+# NOTES
+#
+# * The ttk test suite holds many tests that build upon a previous one. This
+#   is not incidental; it occurs systematically for groups of contiguous tests
+#   in most ttk test files.
+#
+#   A consequence of this practice is that attempts to run tests selectively/
+#   individually using the tcltest options "-match", "-skip" or "-limitconstraints 1"
+#   leads to unintended failures. Therefore, invocations using these options
+#   may be considered invalid for the ttk test suite (but not for the
+#   corresponding core Tk tests).
+#
+
 #
 # TESTFILE INITIALIZATION
 #
diff --git a/tests/ttk/labelframe.test b/tests/ttk/labelframe.test
@@ -2,6 +2,19 @@
 # ttk::labelframe widget tests
 #
 
+# NOTES
+#
+# * The ttk test suite holds many tests that build upon a previous one. This
+#   is not incidental; it occurs systematically for groups of contiguous tests
+#   in most ttk test files.
+#
+#   A consequence of this practice is that attempts to run tests selectively/
+#   individually using the tcltest options "-match", "-skip" or "-limitconstraints 1"
+#   leads to unintended failures. Therefore, invocations using these options
+#   may be considered invalid for the ttk test suite (but not for the
+#   corresponding core Tk tests).
+#
+
 #
 # TESTFILE INITIALIZATION
 #
diff --git a/tests/ttk/notebook.test b/tests/ttk/notebook.test
@@ -2,6 +2,19 @@
 # ttk::notebook widget tests
 #
 
+# NOTES
+#
+# * The ttk test suite holds many tests that build upon a previous one. This
+#   is not incidental; it occurs systematically for groups of contiguous tests
+#   in most ttk test files.
+#
+#   A consequence of this practice is that attempts to run tests selectively/
+#   individually using the tcltest options "-match", "-skip" or "-limitconstraints 1"
+#   leads to unintended failures. Therefore, invocations using these options
+#   may be considered invalid for the ttk test suite (but not for the
+#   corresponding core Tk tests).
+#
+
 #
 # TESTFILE INITIALIZATION
 #
diff --git a/tests/ttk/panedwindow.test b/tests/ttk/panedwindow.test
@@ -2,6 +2,19 @@
 # ttk::panedwindow widget tests
 #
 
+# NOTES
+#
+# * The ttk test suite holds many tests that build upon a previous one. This
+#   is not incidental; it occurs systematically for groups of contiguous tests
+#   in most ttk test files.
+#
+#   A consequence of this practice is that attempts to run tests selectively/
+#   individually using the tcltest options "-match", "-skip" or "-limitconstraints 1"
+#   leads to unintended failures. Therefore, invocations using these options
+#   may be considered invalid for the ttk test suite (but not for the
+#   corresponding core Tk tests).
+#
+
 #
 # TESTFILE INITIALIZATION
 #
diff --git a/tests/ttk/progressbar.test b/tests/ttk/progressbar.test
@@ -2,6 +2,19 @@
 # ttk::progressbar widget tests
 #
 
+# NOTES
+#
+# * The ttk test suite holds many tests that build upon a previous one. This
+#   is not incidental; it occurs systematically for groups of contiguous tests
+#   in most ttk test files.
+#
+#   A consequence of this practice is that attempts to run tests selectively/
+#   individually using the tcltest options "-match", "-skip" or "-limitconstraints 1"
+#   leads to unintended failures. Therefore, invocations using these options
+#   may be considered invalid for the ttk test suite (but not for the
+#   corresponding core Tk tests).
+#
+
 #
 # TESTFILE INITIALIZATION
 #
diff --git a/tests/ttk/radiobutton.test b/tests/ttk/radiobutton.test
@@ -2,6 +2,19 @@
 # ttk::radiobutton widget tests.
 #
 
+# NOTES
+#
+# * The ttk test suite holds many tests that build upon a previous one. This
+#   is not incidental; it occurs systematically for groups of contiguous tests
+#   in most ttk test files.
+#
+#   A consequence of this practice is that attempts to run tests selectively/
+#   individually using the tcltest options "-match", "-skip" or "-limitconstraints 1"
+#   leads to unintended failures. Therefore, invocations using these options
+#   may be considered invalid for the ttk test suite (but not for the
+#   corresponding core Tk tests).
+#
+
 #
 # TESTFILE INITIALIZATION
 #
diff --git a/tests/ttk/scale.test b/tests/ttk/scale.test
@@ -2,6 +2,19 @@
 # ttk::scale widget tests
 #
 
+# NOTES
+#
+# * The ttk test suite holds many tests that build upon a previous one. This
+#   is not incidental; it occurs systematically for groups of contiguous tests
+#   in most ttk test files.
+#
+#   A consequence of this practice is that attempts to run tests selectively/
+#   individually using the tcltest options "-match", "-skip" or "-limitconstraints 1"
+#   leads to unintended failures. Therefore, invocations using these options
+#   may be considered invalid for the ttk test suite (but not for the
+#   corresponding core Tk tests).
+#
+
 #
 # TESTFILE INITIALIZATION
 #
diff --git a/tests/ttk/scrollbar.test b/tests/ttk/scrollbar.test
@@ -2,15 +2,26 @@
 # ttk::scrollbar widget tests
 #
 
-# NOTE
+# NOTES
+#
+# * The ttk test suite holds many tests that build upon a previous one. This
+#   is not incidental; it occurs systematically for groups of contiguous tests
+#   in most ttk test files.
+#
+#   A consequence of this practice is that attempts to run tests selectively/
+#   individually using the tcltest options "-match", "-skip" or "-limitconstraints 1"
+#   leads to unintended failures. Therefore, invocations using these options
+#   may be considered invalid for the ttk test suite (but not for the
+#   corresponding core Tk tests).
+#
+# * Before 2019 the code in library/ttk/scrollbar.tcl would replace the
+#   constructor of ttk::scrollbar with the constructor of tk::scrollbar
+#   unless the -class or -style options were specified..
+#   Now there is an implementation of ttk::scrollbar for macOS.  The
+#   tests are left in place, though, except that scrollbar-swapout-1
+#   test was changed to expect the class to be TScrollbar instead of
+#   Scrollbar.
 #
-# Before 2019 the code in library/ttk/scrollbar.tcl would replace the
-# constructor of ttk::scrollbar with the constructor of tk::scrollbar
-# unless the -class or -style options were specified..
-# Now there is an implementation of ttk::scrollbar for macOS.  The
-# tests are left in place, though, except that scrollbar-swapout-1
-# test was changed to expect the class to be TScrollbar instead of
-# Scrollbar.
 
 #
 # TESTFILE INITIALIZATION
diff --git a/tests/ttk/spinbox.test b/tests/ttk/spinbox.test
@@ -2,6 +2,19 @@
 # ttk::spinbox widget tests
 #
 
+# NOTES
+#
+# * The ttk test suite holds many tests that build upon a previous one. This
+#   is not incidental; it occurs systematically for groups of contiguous tests
+#   in most ttk test files.
+#
+#   A consequence of this practice is that attempts to run tests selectively/
+#   individually using the tcltest options "-match", "-skip" or "-limitconstraints 1"
+#   leads to unintended failures. Therefore, invocations using these options
+#   may be considered invalid for the ttk test suite (but not for the
+#   corresponding core Tk tests).
+#
+
 #
 # TESTFILE INITIALIZATION
 #
diff --git a/tests/ttk/toggleswitch.test b/tests/ttk/toggleswitch.test
@@ -2,6 +2,19 @@
 # ttk::toggleswitch widget tests
 #
 
+# NOTES
+#
+# * The ttk test suite holds many tests that build upon a previous one. This
+#   is not incidental; it occurs systematically for groups of contiguous tests
+#   in most ttk test files.
+#
+#   A consequence of this practice is that attempts to run tests selectively/
+#   individually using the tcltest options "-match", "-skip" or "-limitconstraints 1"
+#   leads to unintended failures. Therefore, invocations using these options
+#   may be considered invalid for the ttk test suite (but not for the
+#   corresponding core Tk tests).
+#
+
 #
 # TESTFILE INITIALIZATION
 #
diff --git a/tests/ttk/treetags.test b/tests/ttk/treetags.test
@@ -2,6 +2,19 @@
 # Tests for tags in the ttk::treeview widget
 #
 
+# NOTES
+#
+# * The ttk test suite holds many tests that build upon a previous one. This
+#   is not incidental; it occurs systematically for groups of contiguous tests
+#   in most ttk test files.
+#
+#   A consequence of this practice is that attempts to run tests selectively/
+#   individually using the tcltest options "-match", "-skip" or "-limitconstraints 1"
+#   leads to unintended failures. Therefore, invocations using these options
+#   may be considered invalid for the ttk test suite (but not for the
+#   corresponding core Tk tests).
+#
+
 #
 # TESTFILE INITIALIZATION
 #
diff --git a/tests/ttk/treeview.test b/tests/ttk/treeview.test
@@ -4,6 +4,16 @@
 
 # NOTES
 #
+# * The ttk test suite holds many tests that build upon a previous one. This
+#   is not incidental; it occurs systematically for groups of contiguous tests
+#   in most ttk test files.
+#
+#   A consequence of this practice is that attempts to run tests selectively/
+#   individually using the tcltest options "-match", "-skip" or "-limitconstraints 1"
+#   leads to unintended failures. Therefore, invocations using these options
+#   may be considered invalid for the ttk test suite (but not for the
+#   corresponding core Tk tests).
+#
 # * [7Jun2005] TO CHECK: [$tv see {}] -- shouldn't work (at least, shouldn't do
 #   what it currently does)
 #
diff --git a/tests/ttk/ttk.test b/tests/ttk/ttk.test
@@ -2,6 +2,19 @@
 # Diverse tests for ttk
 #
 
+# NOTES
+#
+# * The ttk test suite holds many tests that build upon a previous one. This
+#   is not incidental; it occurs systematically for groups of contiguous tests
+#   in most ttk test files.
+#
+#   A consequence of this practice is that attempts to run tests selectively/
+#   individually using the tcltest options "-match", "-skip" or "-limitconstraints 1"
+#   leads to unintended failures. Therefore, invocations using these options
+#   may be considered invalid for the ttk test suite (but not for the
+#   corresponding core Tk tests).
+#
+
 #
 # TESTFILE INITIALIZATION
 #
diff --git a/tests/ttk/validate.test b/tests/ttk/validate.test
@@ -3,6 +3,19 @@
 # Derived from core test suite entry-19.1 through entry-19.20
 #
 
+# NOTES
+#
+# * The ttk test suite holds many tests that build upon a previous one. This
+#   is not incidental; it occurs systematically for groups of contiguous tests
+#   in most ttk test files.
+#
+#   A consequence of this practice is that attempts to run tests selectively/
+#   individually using the tcltest options "-match", "-skip" or "-limitconstraints 1"
+#   leads to unintended failures. Therefore, invocations using these options
+#   may be considered invalid for the ttk test suite (but not for the
+#   corresponding core Tk tests).
+#
+
 #
 # TESTFILE INITIALIZATION
 #

Original file line number	Diff line number	Diff line change
`@@ -2,6 +2,19 @@`
`2`	`2`	`# ttk::checkbutton widget tests.`
`3`	`3`	`#`
`4`	`4`
	`5`	`+# NOTES`
	`6`	`+#`
	`7`	`+# * The ttk test suite holds many tests that build upon a previous one. This`
	`8`	`+# is not incidental; it occurs systematically for groups of contiguous tests`
	`9`	`+# in most ttk test files.`
	`10`	`+#`
	`11`	`+# A consequence of this practice is that attempts to run tests selectively/`
	`12`	`+# individually using the tcltest options "-match", "-skip" or "-limitconstraints 1"`
	`13`	`+# leads to unintended failures. Therefore, invocations using these options`
	`14`	`+# may be considered invalid for the ttk test suite (but not for the`
	`15`	`+# corresponding core Tk tests).`
	`16`	`+#`
	`17`	`+`
`5`	`18`	`#`
`6`	`19`	`# TESTFILE INITIALIZATION`
`7`	`20`	`#`
Original file line number	Diff line number	Diff line change
`@@ -2,6 +2,19 @@`
`2`	`2`	`# ttk::combobox widget tests`
`3`	`3`	`#`
`4`	`4`
	`5`	`+# NOTES`
	`6`	`+#`
	`7`	`+# * The ttk test suite holds many tests that build upon a previous one. This`
	`8`	`+# is not incidental; it occurs systematically for groups of contiguous tests`
	`9`	`+# in most ttk test files.`
	`10`	`+#`
	`11`	`+# A consequence of this practice is that attempts to run tests selectively/`
	`12`	`+# individually using the tcltest options "-match", "-skip" or "-limitconstraints 1"`
	`13`	`+# leads to unintended failures. Therefore, invocations using these options`
	`14`	`+# may be considered invalid for the ttk test suite (but not for the`
	`15`	`+# corresponding core Tk tests).`
	`16`	`+#`
	`17`	`+`
`5`	`18`	`#`
`6`	`19`	`# TESTFILE INITIALIZATION`
`7`	`20`	`#`
Original file line number	Diff line number	Diff line change
`@@ -2,6 +2,19 @@`
`2`	`2`	`# ttk::entry widget tests`
`3`	`3`	`#`
`4`	`4`
	`5`	`+# NOTES`
	`6`	`+#`
	`7`	`+# * The ttk test suite holds many tests that build upon a previous one. This`
	`8`	`+# is not incidental; it occurs systematically for groups of contiguous tests`
	`9`	`+# in most ttk test files.`
	`10`	`+#`
	`11`	`+# A consequence of this practice is that attempts to run tests selectively/`
	`12`	`+# individually using the tcltest options "-match", "-skip" or "-limitconstraints 1"`
	`13`	`+# leads to unintended failures. Therefore, invocations using these options`
	`14`	`+# may be considered invalid for the ttk test suite (but not for the`
	`15`	`+# corresponding core Tk tests).`
	`16`	`+#`
	`17`	`+`
`5`	`18`	`#`
`6`	`19`	`# TESTFILE INITIALIZATION`
`7`	`20`	`#`
Original file line number	Diff line number	Diff line change
`@@ -2,6 +2,19 @@`
`2`	`2`	`# Tests for images in various ttk widgets`
`3`	`3`	`#`
`4`	`4`
	`5`	`+# NOTES`
	`6`	`+#`
	`7`	`+# * The ttk test suite holds many tests that build upon a previous one. This`
	`8`	`+# is not incidental; it occurs systematically for groups of contiguous tests`
	`9`	`+# in most ttk test files.`
	`10`	`+#`
	`11`	`+# A consequence of this practice is that attempts to run tests selectively/`
	`12`	`+# individually using the tcltest options "-match", "-skip" or "-limitconstraints 1"`
	`13`	`+# leads to unintended failures. Therefore, invocations using these options`
	`14`	`+# may be considered invalid for the ttk test suite (but not for the`
	`15`	`+# corresponding core Tk tests).`
	`16`	`+#`
	`17`	`+`
`5`	`18`	`#`
`6`	`19`	`# TESTFILE INITIALIZATION`
`7`	`20`	`#`
Original file line number	Diff line number	Diff line change
`@@ -2,6 +2,19 @@`
`2`	`2`	`# ttk::labelframe widget tests`
`3`	`3`	`#`
`4`	`4`
	`5`	`+# NOTES`
	`6`	`+#`
	`7`	`+# * The ttk test suite holds many tests that build upon a previous one. This`
	`8`	`+# is not incidental; it occurs systematically for groups of contiguous tests`
	`9`	`+# in most ttk test files.`
	`10`	`+#`
	`11`	`+# A consequence of this practice is that attempts to run tests selectively/`
	`12`	`+# individually using the tcltest options "-match", "-skip" or "-limitconstraints 1"`
	`13`	`+# leads to unintended failures. Therefore, invocations using these options`
	`14`	`+# may be considered invalid for the ttk test suite (but not for the`
	`15`	`+# corresponding core Tk tests).`
	`16`	`+#`
	`17`	`+`
`5`	`18`	`#`
`6`	`19`	`# TESTFILE INITIALIZATION`
`7`	`20`	`#`
Original file line number	Diff line number	Diff line change
`@@ -2,6 +2,19 @@`
`2`	`2`	`# ttk::notebook widget tests`
`3`	`3`	`#`
`4`	`4`
	`5`	`+# NOTES`
	`6`	`+#`
	`7`	`+# * The ttk test suite holds many tests that build upon a previous one. This`
	`8`	`+# is not incidental; it occurs systematically for groups of contiguous tests`
	`9`	`+# in most ttk test files.`
	`10`	`+#`
	`11`	`+# A consequence of this practice is that attempts to run tests selectively/`
	`12`	`+# individually using the tcltest options "-match", "-skip" or "-limitconstraints 1"`
	`13`	`+# leads to unintended failures. Therefore, invocations using these options`
	`14`	`+# may be considered invalid for the ttk test suite (but not for the`
	`15`	`+# corresponding core Tk tests).`
	`16`	`+#`
	`17`	`+`
`5`	`18`	`#`
`6`	`19`	`# TESTFILE INITIALIZATION`
`7`	`20`	`#`
Original file line number	Diff line number	Diff line change
`@@ -2,6 +2,19 @@`
`2`	`2`	`# ttk::panedwindow widget tests`
`3`	`3`	`#`
`4`	`4`
	`5`	`+# NOTES`
	`6`	`+#`
	`7`	`+# * The ttk test suite holds many tests that build upon a previous one. This`
	`8`	`+# is not incidental; it occurs systematically for groups of contiguous tests`
	`9`	`+# in most ttk test files.`
	`10`	`+#`
	`11`	`+# A consequence of this practice is that attempts to run tests selectively/`
	`12`	`+# individually using the tcltest options "-match", "-skip" or "-limitconstraints 1"`
	`13`	`+# leads to unintended failures. Therefore, invocations using these options`
	`14`	`+# may be considered invalid for the ttk test suite (but not for the`
	`15`	`+# corresponding core Tk tests).`
	`16`	`+#`
	`17`	`+`
`5`	`18`	`#`
`6`	`19`	`# TESTFILE INITIALIZATION`
`7`	`20`	`#`
Original file line number	Diff line number	Diff line change
`@@ -2,6 +2,19 @@`
`2`	`2`	`# ttk::progressbar widget tests`
`3`	`3`	`#`
`4`	`4`
	`5`	`+# NOTES`
	`6`	`+#`
	`7`	`+# * The ttk test suite holds many tests that build upon a previous one. This`
	`8`	`+# is not incidental; it occurs systematically for groups of contiguous tests`
	`9`	`+# in most ttk test files.`
	`10`	`+#`
	`11`	`+# A consequence of this practice is that attempts to run tests selectively/`
	`12`	`+# individually using the tcltest options "-match", "-skip" or "-limitconstraints 1"`
	`13`	`+# leads to unintended failures. Therefore, invocations using these options`
	`14`	`+# may be considered invalid for the ttk test suite (but not for the`
	`15`	`+# corresponding core Tk tests).`
	`16`	`+#`
	`17`	`+`
`5`	`18`	`#`
`6`	`19`	`# TESTFILE INITIALIZATION`
`7`	`20`	`#`
Original file line number	Diff line number	Diff line change
`@@ -2,6 +2,19 @@`
`2`	`2`	`# ttk::radiobutton widget tests.`
`3`	`3`	`#`
`4`	`4`
	`5`	`+# NOTES`
	`6`	`+#`
	`7`	`+# * The ttk test suite holds many tests that build upon a previous one. This`
	`8`	`+# is not incidental; it occurs systematically for groups of contiguous tests`
	`9`	`+# in most ttk test files.`
	`10`	`+#`
	`11`	`+# A consequence of this practice is that attempts to run tests selectively/`
	`12`	`+# individually using the tcltest options "-match", "-skip" or "-limitconstraints 1"`
	`13`	`+# leads to unintended failures. Therefore, invocations using these options`
	`14`	`+# may be considered invalid for the ttk test suite (but not for the`
	`15`	`+# corresponding core Tk tests).`
	`16`	`+#`
	`17`	`+`
`5`	`18`	`#`
`6`	`19`	`# TESTFILE INITIALIZATION`
`7`	`20`	`#`
Original file line number	Diff line number	Diff line change
`@@ -2,6 +2,19 @@`
`2`	`2`	`# ttk::scale widget tests`
`3`	`3`	`#`
`4`	`4`
	`5`	`+# NOTES`
	`6`	`+#`
	`7`	`+# * The ttk test suite holds many tests that build upon a previous one. This`
	`8`	`+# is not incidental; it occurs systematically for groups of contiguous tests`
	`9`	`+# in most ttk test files.`
	`10`	`+#`
	`11`	`+# A consequence of this practice is that attempts to run tests selectively/`
	`12`	`+# individually using the tcltest options "-match", "-skip" or "-limitconstraints 1"`
	`13`	`+# leads to unintended failures. Therefore, invocations using these options`
	`14`	`+# may be considered invalid for the ttk test suite (but not for the`
	`15`	`+# corresponding core Tk tests).`
	`16`	`+#`
	`17`	`+`
`5`	`18`	`#`
`6`	`19`	`# TESTFILE INITIALIZATION`
`7`	`20`	`#`