summaryrefslogtreecommitdiffstats
path: root/Doc
diff options
context:
space:
mode:
authorMartin v. Löwis <martin@v.loewis.de>2010-11-01 21:39:13 (GMT)
committerMartin v. Löwis <martin@v.loewis.de>2010-11-01 21:39:13 (GMT)
commit16f344df36a8a7d7c609eb7036bb52b8a9a47a23 (patch)
tree31a0a830b06d94a759541064c58080c768d9c4c7 /Doc
parentbbea35f194c6a2a64ce96526bd5eee37a75e8c0a (diff)
downloadcpython-16f344df36a8a7d7c609eb7036bb52b8a9a47a23.zip
cpython-16f344df36a8a7d7c609eb7036bb52b8a9a47a23.tar.gz
cpython-16f344df36a8a7d7c609eb7036bb52b8a9a47a23.tar.bz2
Issue #10184: Touch directories only once when extracting a tarfile.
Diffstat (limited to 'Doc')
-rw-r--r--Doc/library/tarfile.rst7
1 files changed, 5 insertions, 2 deletions
diff --git a/Doc/library/tarfile.rst b/Doc/library/tarfile.rst
index 0dfb065..d7fbf39 100644
--- a/Doc/library/tarfile.rst
+++ b/Doc/library/tarfile.rst
@@ -336,12 +336,13 @@ be finalized; only the internally used file object will be closed. See the
dots ``".."``.
-.. method:: TarFile.extract(member, path="")
+.. method:: TarFile.extract(member, path="", set_attrs=True)
Extract a member from the archive to the current working directory, using its
full name. Its file information is extracted as accurately as possible. *member*
may be a filename or a :class:`TarInfo` object. You can specify a different
- directory using *path*.
+ directory using *path*. File attributes (owner, mtime, mode) are set unless
+ *set_attrs* is False.
.. note::
@@ -352,6 +353,8 @@ be finalized; only the internally used file object will be closed. See the
See the warning for :meth:`extractall`.
+ .. versionchanged:: 3.2
+ Added the *set_attrs* parameter.
.. method:: TarFile.extractfile(member)