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

diff --git a/Doc/library/tarfile.rst b/Doc/library/tarfile.rst
index 29a329fdfeab15bcbc7964f78d7ce152028031e5..fc352e901f31dc784c4e5eff4f7cfa82a98a1a3d 100644 (file)
--- 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).