commit 8351df6e3652a41ffc720066a68b666bbef1df67
author Miss Islington (bot) <31488909+miss-islington@users.noreply.github.com> Mon Aug 23 12:22:29 2021 -0700
committer GitHub <noreply@github.com> Mon Aug 23 12:22:29 2021 -0700
tree 321dbe9f09f3b85ee9dd4f83484c8c8d4160c7c8
parent 10955353ce25a52741e8f72fdbb6f4b150ee4dc7

bpo-42560: add warning to Tkinter docs about outdated pre-8.5 documentation online (GH-27836)


Co-authored-by: Łukasz Langa <lukasz@langa.pl>
Co-authored-by: E-Paine <63801254+E-Paine@users.noreply.github.com>
(cherry picked from commit 1eb451031a64b4f28d737ee7f394252ae9a76118)

Co-authored-by: Mark Roseman <mark@markroseman.com>

Doc/library/tkinter.rst

diff --git a/Doc/library/tkinter.rst b/Doc/library/tkinter.rst
index 34238f4..3218653 100644
--- a/Doc/library/tkinter.rst
+++ b/Doc/library/tkinter.rst
@@ -29,6 +29,13 @@
 additions and changes, and refer to the official Tcl/Tk documentation for
 details that are unchanged.
 
+.. note::
+
+   Tcl/Tk 8.5 (2007) introduced a modern set of themed user interface components
+   along with a new API to use them. Both old and new APIs are still available.
+   Most documentation you will find online still uses the old API and
+   can be woefully outdated.
+
 .. seealso::
 
    * `TkDocs <http://tkdocs.com/>`_