From fa5eafd19c3d395b4498e21b4e1b8faac2ebdb0a Mon Sep 17 00:00:00 2001 From: Serhiy Storchaka Date: Wed, 8 Jul 2026 15:00:15 +0300 Subject: [PATCH] gh-86017: Document displayof for Font.actual() and clarify Font.copy() (GH-153288) 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 1ac7ac8e98d1..c1cab7802da3 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) -- 2.47.3