From: Miss Islington (bot) <31488909+miss-islington@users.noreply.github.com> Date: Wed, 8 Jul 2026 12:09:01 +0000 (+0200) Subject: [3.15] gh-86017: Document displayof for Font.actual() and clarify Font.copy() (GH... X-Git-Tag: v3.15.0b4~81 X-Git-Url: http://git.ipfire.org/index.cgi?a=commitdiff_plain;h=10ea39e3582124901c2a9ce3289cfebafce92a33;p=thirdparty%2FPython%2Fcpython.git [3.15] gh-86017: Document displayof for Font.actual() and clarify Font.copy() (GH-153288) (GH-153329) Explain the displayof argument of tkinter.font.Font.actual() and describe what Font.copy() returns, including for a wrapped font description. (cherry picked from commit fa5eafd19c3d395b4498e21b4e1b8faac2ebdb0a) Co-authored-by: Serhiy Storchaka Co-authored-by: Claude Opus 4.8 --- diff --git a/Doc/library/tkinter.font.rst b/Doc/library/tkinter.font.rst index 2a9563fffab1..947207724ab0 100644 --- a/Doc/library/tkinter.font.rst +++ b/Doc/library/tkinter.font.rst @@ -54,6 +54,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) @@ -71,7 +73,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)