[Python-checkins] gh-65802: IDLE - explain SaveAs and extensions (GH-95690) (GH-95692)

[ambv]

https://github.com/python/cpython/commit/4512a160d045695ee0349fd91af7aaaa6fb71410
commit: 4512a160d045695ee0349fd91af7aaaa6fb71410
branch: 3.11
author: Miss Islington (bot) <31488909+miss-islington at users.noreply.github.com>
committer: ambv <lukasz at langa.pl>
date: 2022-08-05T09:42:21+02:00
summary:

gh-65802: IDLE - explain SaveAs and extensions (GH-95690) (GH-95692)

File name extensions may or may not be shown for the current name
and are added in an OS-dependent manner if not given for the new
name.
(cherry picked from commit 9890f86ae2001d19e7a18fee5b13aa0dd6069aef)

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

files:
A Misc/NEWS.d/next/IDLE/2022-08-04-20-07-51.gh-issue-65802.xnThWe.rst
M Doc/library/idle.rst
M Lib/idlelib/NEWS.txt

diff --git a/Doc/library/idle.rst b/Doc/library/idle.rst
index e91ec40c9add..2d52e5355749 100644
--- a/Doc/library/idle.rst
+++ b/Doc/library/idle.rst
@@ -87,11 +87,14 @@ Save
 
 Save As...
    Save the current window with a Save As dialog.  The file saved becomes the
-   new associated file for the window.
+   new associated file for the window. (If your file namager is set to hide
+   extensions, the current extension will be omitted in the file name box.
+   If the new filename has no '.', '.py' and .'txt' will be added for Python
+   and text files, except that on macOS Aqua,'.py' is added for all files.)
 
 Save Copy As...
    Save the current window to different file without changing the associated
-   file.
+   file.  (See Save As note above about filename extensions.)
 
 Print Window
    Print the current window to the default printer.
diff --git a/Lib/idlelib/NEWS.txt b/Lib/idlelib/NEWS.txt
index ce95e2f9948b..7fa7facf8cf7 100644
--- a/Lib/idlelib/NEWS.txt
+++ b/Lib/idlelib/NEWS.txt
@@ -4,6 +4,8 @@ Released on 2022-10-03
 =========================
 
 
+gh-65802: Document handling of extensions in Save As dialogs.
+
 gh-95191: Include prompts when saving Shell (interactive input/output).
 
 gh-95511: Fix the Shell context menu copy-with-prompts bug of copying
diff --git a/Misc/NEWS.d/next/IDLE/2022-08-04-20-07-51.gh-issue-65802.xnThWe.rst b/Misc/NEWS.d/next/IDLE/2022-08-04-20-07-51.gh-issue-65802.xnThWe.rst
new file mode 100644
index 000000000000..a62a784b6e69
--- /dev/null
+++ b/Misc/NEWS.d/next/IDLE/2022-08-04-20-07-51.gh-issue-65802.xnThWe.rst
@@ -0,0 +1 @@
+Document handling of extensions in Save As dialogs.