[Python-checkins] bpo-24310: Document IDLE settings dialog font tab sample (GH-12007)

[Miss Islington (bot)]

https://github.com/python/cpython/commit/38aea4131f57769d2c3d136b09172760db097605
commit: 38aea4131f57769d2c3d136b09172760db097605
branch: 3.7
author: Miss Islington (bot) <31488909+miss-islington at users.noreply.github.com>
committer: GitHub <noreply at github.com>
date: 2019-02-23T20:23:08-08:00
summary:

bpo-24310: Document IDLE settings dialog font tab sample (GH-12007)

(cherry picked from commit d610116a2e48b55788b62e11f2e6956af06b3de0)

Co-authored-by: Terry Jan Reedy <tjreedy at udel.edu>

files:
A Misc/NEWS.d/next/IDLE/2019-02-23-22-31-20.bpo-24310.j_vJQl.rst
M Doc/library/idle.rst
M Lib/idlelib/NEWS.txt
M Lib/idlelib/help.html

diff --git a/Doc/library/idle.rst b/Doc/library/idle.rst
index 8290039c968b..8ef9e2eed534 100644
--- a/Doc/library/idle.rst
+++ b/Doc/library/idle.rst
@@ -852,6 +852,13 @@ 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.
 
+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 65662d9d0609..367d933ec2ed 100644
--- a/Lib/idlelib/NEWS.txt
+++ b/Lib/idlelib/NEWS.txt
@@ -3,6 +3,8 @@ Released on 2019-??-??
 ======================================
 
 
+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 374159f807e9..b654ab7f2c5f 100644
--- a/Lib/idlelib/help.html
+++ b/Lib/idlelib/help.html
@@ -788,6 +788,12 @@ <h2>Help and preferences<a class="headerlink" href="#help-and-preferences" title
 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 @@ <h3>Navigation</h3>
 <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 000000000000..12ac99022aeb
--- /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.