From 95038ccddf8afe2925539f8219037406acb30d6c Mon Sep 17 00:00:00 2001
From: "zainnadeem(RedOpsCell)" <zainnadeemzainnadeem80@gmail.com>
Date: Tue, 30 Jun 2026 20:30:05 +0500
Subject: [PATCH] gh-152691: Document Windows reserved names in tarfile
 guidance

---
 Doc/library/tarfile.rst | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/Doc/library/tarfile.rst b/Doc/library/tarfile.rst
index 29a329fdfeab15b..fc352e901f31dc7 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).