From: Zain Nadeem <zainnadeemzainnadeem80@gmail.com>
Date: Thu, 2 Jul 2026 17:57:15 +0000 (+0500)
Subject: gh-152691: tarfile -- add Windows reserved name section (GH-152701)
X-Git-Url: http://git.ipfire.org/gitweb/index.cgi?a=commitdiff_plain;h=8b430d6f740541f1b9045a89dde43abee2c54bc5;p=thirdparty%2FPython%2Fcpython.git

gh-152691: tarfile -- add Windows reserved name section (GH-152701)
---

diff --git a/Doc/library/tarfile.rst b/Doc/library/tarfile.rst
index 29a329fdfeab..fc352e901f31 100644
--- a/Doc/library/tarfile.rst
+++ b/Doc/library/tarfile.rst
@@ -1195,6 +1195,8 @@ Here is an incomplete list of things to consider:
 * Check filenames against an allow-list of characters
   (to filter out control characters, confusables, foreign path separators,
   and so on).
+* Check for platform-specific filename semantics. For example, on Windows
+  some names can have reserved meanings.
 * Check that filenames have expected extensions (discouraging files that
   execute when you “click on them”, or extension-less files like Windows
   special device names).