From: Omkar Kabde <omkarkabde@gmail.com>
Date: Fri, 22 May 2026 21:02:56 +0000 (+0530)
Subject: gh-82907: Document mtime=0 for reproducible tarfile gzip output (GH-150269)
X-Git-Url: http://git.ipfire.org/gitweb/index.cgi?a=commitdiff_plain;h=9df2b6ccc719b0bc0167da65b72b57f9da39398b;p=thirdparty%2FPython%2Fcpython.git

gh-82907: Document mtime=0 for reproducible tarfile gzip output (GH-150269)
---

diff --git a/Doc/library/tarfile.rst b/Doc/library/tarfile.rst
index 6f1e01cf5aa6..9b9783d8e580 100644
--- a/Doc/library/tarfile.rst
+++ b/Doc/library/tarfile.rst
@@ -144,7 +144,9 @@ Some facts and figures:
 
    For modes ``'w:gz'`` and ``'w|gz'``, :func:`tarfile.open` accepts the
    keyword argument *mtime* to create a gzip archive header with that mtime. By
-   default, the mtime is set to the time of creation of the archive.
+   default, the mtime is set to the time of creation of the archive. Use
+   *mtime* ``0`` to generate a compressed stream that does not depend on
+   creation time, for reproducible output.
 
    For special purposes, there is a second format for *mode*:
    ``'filemode|[compression]'``.  :func:`tarfile.open` will return a :class:`TarFile`