From 89dea0bd5593c93b53dc16487e41ef045a32f8f4 Mon Sep 17 00:00:00 2001 From: Wulian233 <1055917385@qq.com> Date: Sun, 28 Sep 2025 20:56:01 +0800 Subject: [PATCH 1/6] gh-123299: Copyedit What's New in 3.14 --- Doc/library/zipfile.rst | 3 +++ Doc/whatsnew/3.14.rst | 11 +++++------ 2 files changed, 8 insertions(+), 6 deletions(-) diff --git a/Doc/library/zipfile.rst b/Doc/library/zipfile.rst index f6ec33640b60d2..c5b1b369b2d4ff 100644 --- a/Doc/library/zipfile.rst +++ b/Doc/library/zipfile.rst @@ -526,6 +526,9 @@ ZipFile Objects a closed ZipFile will raise a :exc:`ValueError`. Previously, a :exc:`RuntimeError` was raised. + .. versionchanged:: 3.14 + Now respects :envvar:`SOURCE_DATE_EPOCH` environment variable. + .. method:: ZipFile.mkdir(zinfo_or_directory, mode=511) Create a directory inside the archive. If *zinfo_or_directory* is a string, diff --git a/Doc/whatsnew/3.14.rst b/Doc/whatsnew/3.14.rst index caeff3a00aa049..743a5e2100cac7 100644 --- a/Doc/whatsnew/3.14.rst +++ b/Doc/whatsnew/3.14.rst @@ -943,9 +943,8 @@ For further information on how to build Python, see Clang/LLVM 19, which causes the normal interpreter to be slower. We were unaware of this bug, resulting in inaccurate results. We sincerely apologize for communicating results that were only accurate for LLVM v19.1.x and v20.1.0. In the meantime, - the bug has been fixed in LLVM v20.1.1 and for the upcoming v21.1, but it will remain - unfixed for LLVM v19.1.x and v20.1.0. Thus - any benchmarks with those versions of LLVM may produce inaccurate numbers. + the bug has been fixed in LLVM v20.1.1 and v21.1, but it will remain unfixed for LLVM v19.1.x + and v20.1.0. Thus any benchmarks with those versions of LLVM may produce inaccurate numbers. (Thanks to Nelson Elhage for bringing this to light.) (Contributed by Ken Jin in :gh:`128563`, with ideas on how to implement this @@ -2231,9 +2230,9 @@ zipfile as used by :func:`ZipFile.writestr `. (Contributed by Bénédikt Tran in :gh:`123424`.) -* :meth:`zipfile.ZipFile.writestr` now respects ``SOURCE_DATE_EPOCH`` that - distributions can set centrally and have build tools consume this in order - to produce reproducible output. +* :meth:`zipfile.ZipFile.writestr` now respects :envvar:`SOURCE_DATE_EPOCH` + environment variable that distributions can set centrally and have build + tools consume this in order to produce reproducible output. (Contributed by Jiahao Li in :gh:`91279`.) From fa92f66172fa18d9cf96e8cf53a6e74c53c8e5e6 Mon Sep 17 00:00:00 2001 From: Wulian233 <1055917385@qq.com> Date: Fri, 3 Oct 2025 22:38:58 +0800 Subject: [PATCH 2/6] Update 3.14.rst --- Doc/whatsnew/3.14.rst | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/Doc/whatsnew/3.14.rst b/Doc/whatsnew/3.14.rst index 743a5e2100cac7..7c6eaf6b893a04 100644 --- a/Doc/whatsnew/3.14.rst +++ b/Doc/whatsnew/3.14.rst @@ -2230,9 +2230,9 @@ zipfile as used by :func:`ZipFile.writestr `. (Contributed by Bénédikt Tran in :gh:`123424`.) -* :meth:`zipfile.ZipFile.writestr` now respects :envvar:`SOURCE_DATE_EPOCH` - environment variable that distributions can set centrally and have build - tools consume this in order to produce reproducible output. +* :meth:`zipfile.ZipFile.writestr` now respects ``SOURCE_DATE_EPOCH`` that + distributions can set centrally and have build tools consume this in order + to produce reproducible output. (Contributed by Jiahao Li in :gh:`91279`.) From 764aadf697d42262b7a1f31cfb53ffcd74531d1b Mon Sep 17 00:00:00 2001 From: Wulian233 <1055917385@qq.com> Date: Fri, 3 Oct 2025 22:40:52 +0800 Subject: [PATCH 3/6] Update 3.14.rst --- Doc/whatsnew/3.14.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/Doc/whatsnew/3.14.rst b/Doc/whatsnew/3.14.rst index 7c6eaf6b893a04..18a1095e04cb4e 100644 --- a/Doc/whatsnew/3.14.rst +++ b/Doc/whatsnew/3.14.rst @@ -2231,8 +2231,8 @@ zipfile (Contributed by Bénédikt Tran in :gh:`123424`.) * :meth:`zipfile.ZipFile.writestr` now respects ``SOURCE_DATE_EPOCH`` that - distributions can set centrally and have build tools consume this in order - to produce reproducible output. + distributions can set centrally and have build tools consume this in order + to produce reproducible output. (Contributed by Jiahao Li in :gh:`91279`.) From 28b6b6c239f010569ffad0fa38ec0a320b0bcf0e Mon Sep 17 00:00:00 2001 From: Wulian233 <1055917385@qq.com> Date: Fri, 3 Oct 2025 22:42:34 +0800 Subject: [PATCH 4/6] Update 3.14.rst --- Doc/whatsnew/3.14.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/Doc/whatsnew/3.14.rst b/Doc/whatsnew/3.14.rst index 18a1095e04cb4e..f908962b92dde6 100644 --- a/Doc/whatsnew/3.14.rst +++ b/Doc/whatsnew/3.14.rst @@ -2230,8 +2230,8 @@ zipfile as used by :func:`ZipFile.writestr `. (Contributed by Bénédikt Tran in :gh:`123424`.) -* :meth:`zipfile.ZipFile.writestr` now respects ``SOURCE_DATE_EPOCH`` that - distributions can set centrally and have build tools consume this in order +* :meth:`zipfile.ZipFile.writestr` now respects ``SOURCE_DATE_EPOCH`` that + distributions can set centrally and have build tools consume this in order to produce reproducible output. (Contributed by Jiahao Li in :gh:`91279`.) From feec370c13d57938741d848deb93fc36f6e85795 Mon Sep 17 00:00:00 2001 From: Wulian233 <1055917385@qq.com> Date: Fri, 3 Oct 2025 22:46:23 +0800 Subject: [PATCH 5/6] Update 3.14.rst --- Doc/whatsnew/3.14.rst | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/Doc/whatsnew/3.14.rst b/Doc/whatsnew/3.14.rst index f908962b92dde6..caeff3a00aa049 100644 --- a/Doc/whatsnew/3.14.rst +++ b/Doc/whatsnew/3.14.rst @@ -943,8 +943,9 @@ For further information on how to build Python, see Clang/LLVM 19, which causes the normal interpreter to be slower. We were unaware of this bug, resulting in inaccurate results. We sincerely apologize for communicating results that were only accurate for LLVM v19.1.x and v20.1.0. In the meantime, - the bug has been fixed in LLVM v20.1.1 and v21.1, but it will remain unfixed for LLVM v19.1.x - and v20.1.0. Thus any benchmarks with those versions of LLVM may produce inaccurate numbers. + the bug has been fixed in LLVM v20.1.1 and for the upcoming v21.1, but it will remain + unfixed for LLVM v19.1.x and v20.1.0. Thus + any benchmarks with those versions of LLVM may produce inaccurate numbers. (Thanks to Nelson Elhage for bringing this to light.) (Contributed by Ken Jin in :gh:`128563`, with ideas on how to implement this From c4ce0c608e7c80b0ac85450b3710b16483f5e3fc Mon Sep 17 00:00:00 2001 From: Wulian233 <1055917385@qq.com> Date: Tue, 7 Oct 2025 21:43:00 +0800 Subject: [PATCH 6/6] Update zipfile.rst --- Doc/library/zipfile.rst | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/Doc/library/zipfile.rst b/Doc/library/zipfile.rst index c5b1b369b2d4ff..02b4cb7bee4860 100644 --- a/Doc/library/zipfile.rst +++ b/Doc/library/zipfile.rst @@ -527,7 +527,8 @@ ZipFile Objects a :exc:`RuntimeError` was raised. .. versionchanged:: 3.14 - Now respects :envvar:`SOURCE_DATE_EPOCH` environment variable. + Now respects the :envvar:`SOURCE_DATE_EPOCH` environment variable. If set, it uses this + value as the modification timestamp for the file written into the ZIP archive. .. method:: ZipFile.mkdir(zinfo_or_directory, mode=511)