From da044adec2288f6894d48752f8abafaa7b923626 Mon Sep 17 00:00:00 2001 From: Serhiy Storchaka Date: Tue, 7 Jul 2026 20:50:44 +0300 Subject: [PATCH] gh-86017: Document displayof for Font.actual() and clarify Font.copy() Explain the displayof argument of tkinter.font.Font.actual() and describe what Font.copy() returns, including for a wrapped font description. Co-Authored-By: Claude Opus 4.8 --- Doc/library/tkinter.font.rst | 8 +++++++- 1 file changed, 7 insertions(+), 1 deletion(-) diff --git a/Doc/library/tkinter.font.rst b/Doc/library/tkinter.font.rst index 1ac7ac8e98d1662..c1cab7802da3889 100644 --- a/Doc/library/tkinter.font.rst +++ b/Doc/library/tkinter.font.rst @@ -74,6 +74,8 @@ The different font weights and slants are: requested ones because of platform limitations. With no *option*, return a dictionary of all the attributes; if *option* is given, return the value of that single attribute. + The attributes are resolved on the display of the *displayof* widget, + or the main application window if it is not specified. .. method:: cget(option) @@ -97,7 +99,11 @@ The different font weights and slants are: .. method:: copy() - Return new instance of the current font. + Return a distinct copy of the current font: + a new named font with the same attributes but a different name, + which can be reconfigured independently of the original. + If the current font wraps a font description, + the copy is instead a named font with its resolved attributes. .. method:: measure(text, displayof=None)