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

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@udel.edu>

diff --git a/Doc/library/idle.rst b/Doc/library/idle.rst
index e91ec40c9add0d74de6230cd2c67ade727f25440..2d52e5355749fc8e5415dffbf2b085eb9f93a7f1 100644 (file)
--- 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 999b67181319cfa9a95e1dab16333382653b61df..277fd9429a4c5b781dfa4c1da9f8eea782153032 100644 (file)
--- a/Lib/idlelib/NEWS.txt
+++ b/Lib/idlelib/NEWS.txt
@@ -4,6 +4,8 @@ Released 2023-04-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 (file)
index 0000000..a62a784
--- /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.