bpo-24310: Document IDLE settings dialog font tab sample (GH-12007)
diff --git a/Doc/library/idle.rst b/Doc/library/idle.rst
index 8290039..8ef9e2e 100644
--- a/Doc/library/idle.rst
+++ b/Doc/library/idle.rst
@@ -852,6 +852,13 @@
home directory. Problems caused by bad user configuration files are solved
by editing or deleting one or more of the files in .idlerc.
+On the Font tab, see the text sample for the effect of font face and size
+on multiple characters in multiple languages. Edit the sample to add
+other characters of personal interest. Use the sample to select
+monospaced fonts. If particular characters have problems in Shell or an
+editor, add them to the top of the sample and try changing first size
+and then font.
+
On the Highlights and Keys tab, select a built-in or custom color theme
and key set. To use a newer built-in color theme or key set with older
IDLEs, save it as a new custom theme or key set and it well be accessible
diff --git a/Lib/idlelib/NEWS.txt b/Lib/idlelib/NEWS.txt
index 5d30fb3..715b013 100644
--- a/Lib/idlelib/NEWS.txt
+++ b/Lib/idlelib/NEWS.txt
@@ -3,6 +3,8 @@
======================================
+bpo-24310: Document settings dialog font tab sample.
+
bpo-35689: Add docstrings and tests for colorizer.
bpo-35833: Revise IDLE doc for control codes sent to Shell.
diff --git a/Lib/idlelib/help.html b/Lib/idlelib/help.html
index 374159f..b654ab7 100644
--- a/Lib/idlelib/help.html
+++ b/Lib/idlelib/help.html
@@ -788,6 +788,12 @@
Non-default user settings are saved in a .idlerc directory in the user’s
home directory. Problems caused by bad user configuration files are solved
by editing or deleting one or more of the files in .idlerc.</p>
+<p>On the Font tab, see the text sample for the effect of font face and size
+on multiple characters in multiple languages. Edit the sample to add
+other characters of personal interest. Use the sample to select
+monospaced fonts. If particular characters have problems in Shell or an
+editor, add them to the top of the sample and try changing first size
+and then font.</p>
<p>On the Highlights and Keys tab, select a built-in or custom color theme
and key set. To use a newer built-in color theme or key set with older
IDLEs, save it as a new custom theme or key set and it well be accessible
@@ -937,7 +943,7 @@
<br />
<br />
- Last updated on Feb 08, 2019.
+ Last updated on Feb 23, 2019.
<a href="https://docs.python.org/3/bugs.html">Found a bug</a>?
<br />
diff --git a/Misc/NEWS.d/next/IDLE/2019-02-23-22-31-20.bpo-24310.j_vJQl.rst b/Misc/NEWS.d/next/IDLE/2019-02-23-22-31-20.bpo-24310.j_vJQl.rst
new file mode 100644
index 0000000..12ac990
--- /dev/null
+++ b/Misc/NEWS.d/next/IDLE/2019-02-23-22-31-20.bpo-24310.j_vJQl.rst
@@ -0,0 +1 @@
+IDLE -- Document settings dialog font tab sample.