From 54c49d4435e05650f53ac76dd38080a3897b36f4 Mon Sep 17 00:00:00 2001 From: Mark Roseman Date: Thu, 19 Aug 2021 07:35:30 -0700 Subject: [PATCH 1/4] add warning about outdated documentation online --- Doc/library/tkinter.rst | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/Doc/library/tkinter.rst b/Doc/library/tkinter.rst index 39766486f64f91..aae8c07ecefd7e 100644 --- a/Doc/library/tkinter.rst +++ b/Doc/library/tkinter.rst @@ -30,6 +30,13 @@ make the experience more pythonic. This documentation will concentrate on these additions and changes, and refer to the official Tcl/Tk documentation for details that are unchanged. +.. warning:: + + 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 API's are still available. + Unfortunately, most documentation you will find online uses the old API and + is woefully outdated. + .. seealso:: Tkinter documentation: From b72cbf627884c17a52ad71e33b7988b6ea2a34ea Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=C5=81ukasz=20Langa?= Date: Mon, 23 Aug 2021 20:40:45 +0200 Subject: [PATCH 2/4] Fix typo Co-authored-by: E-Paine <63801254+E-Paine@users.noreply.github.com> --- Doc/library/tkinter.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Doc/library/tkinter.rst b/Doc/library/tkinter.rst index aae8c07ecefd7e..c751130f863600 100644 --- a/Doc/library/tkinter.rst +++ b/Doc/library/tkinter.rst @@ -33,7 +33,7 @@ details that are unchanged. .. warning:: 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 API's are still available. + along with a new API to use them. Both old and new APIs are still available. Unfortunately, most documentation you will find online uses the old API and is woefully outdated. From 8ba9f932d6ea64b20e0fba55eaec6f02f66e526a Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=C5=81ukasz=20Langa?= Date: Mon, 23 Aug 2021 20:40:57 +0200 Subject: [PATCH 3/4] Downgrade warning to note --- Doc/library/tkinter.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Doc/library/tkinter.rst b/Doc/library/tkinter.rst index c751130f863600..8b91ff52bd7dca 100644 --- a/Doc/library/tkinter.rst +++ b/Doc/library/tkinter.rst @@ -30,7 +30,7 @@ make the experience more pythonic. This documentation will concentrate on these additions and changes, and refer to the official Tcl/Tk documentation for details that are unchanged. -.. warning:: +.. 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. From 0ec6bfc8460234b13d6c82bcb9c966c543f3c784 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=C5=81ukasz=20Langa?= Date: Mon, 23 Aug 2021 20:41:11 +0200 Subject: [PATCH 4/4] Tone down language --- Doc/library/tkinter.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/Doc/library/tkinter.rst b/Doc/library/tkinter.rst index 8b91ff52bd7dca..42df85586363a0 100644 --- a/Doc/library/tkinter.rst +++ b/Doc/library/tkinter.rst @@ -34,8 +34,8 @@ details that are unchanged. 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. - Unfortunately, most documentation you will find online uses the old API and - is woefully outdated. + Most documentation you will find online still uses the old API and + can be woefully outdated. .. seealso::