Skip to content

Commit b30dbcc

Browse files
committed
Major rephrasing of actual docs
1 parent b8ca758 commit b30dbcc

1 file changed

Lines changed: 9 additions & 14 deletions

File tree

Doc/library/tkinter.font.rst

Lines changed: 9 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -47,18 +47,19 @@ The different font weights and slants are:
4747
4848
.. method:: actual(option=None, displayof=None)
4949

50-
Returns information about the actual attributes that are obtained when
51-
the font is used on *displayof*; the values obtained may differ from
52-
those given as kwargs or similar method (and retrieved by
53-
:meth:`Font.cget`) due to platform-dependent limitations (such as the
54-
availability of font families and pointsizes).
50+
Returns the actual value for attributes when the given font is used on
51+
*displayof*. Due to some differences between operating systems (such as
52+
pointsizes and the availability of font families), some values returned
53+
by this method may vary from those given as kwargs or similar method
54+
(and retrieved by :meth:`Font.cget`).
5555

5656
*displayof* accepts any tkinter widget and, if omitted, will default to
5757
the main window.
5858

59-
If *option* is specified, the value of just that attribute is returned;
60-
if it is omitted, the return value is a dictionary of all the attributes
61-
and their values. See above for a list of the possible attributes. [1]_
59+
If *option* is specified, the value of just that attribute is returned.
60+
If it is omitted or ``None``, the returned value is a dictionary of all
61+
the attributes and their values. See above for a list of acceptable
62+
attributes.
6263

6364
.. method:: cget(option)
6465

@@ -105,9 +106,3 @@ The different font weights and slants are:
105106
.. function:: nametofont(name)
106107

107108
Return a :class:`Font` representation of a tk named font.
108-
109-
References
110-
----------
111-
112-
.. [1] The :meth:`Font.actual` docs are based heavily on those found on the Tk
113-
8.6 font man page (https://www.tcl.tk/man/tcl8.6/TkCmd/font.htm#M5)

0 commit comments

Comments
 (0)