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 39766486f64f91b..aae8c07ecefd7ea 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 aae8c07ecefd7ea..c751130f8636007 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 c751130f8636007..8b91ff52bd7dca3 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 8b91ff52bd7dca3..42df85586363a08 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::