Skip to content

gh-152691: Document Windows ADS filename considerations for tarfile#152701

Open
zainnadeem786 wants to merge 1 commit into
python:mainfrom
zainnadeem786:docs/tarfile-windows-ads-guidance
Open

gh-152691: Document Windows ADS filename considerations for tarfile#152701
zainnadeem786 wants to merge 1 commit into
python:mainfrom
zainnadeem786:docs/tarfile-windows-ads-guidance

Conversation

@zainnadeem786

Copy link
Copy Markdown
Contributor

Summary

This documentation-only change updates the tarfile extraction guidance to mention platform-specific filename semantics.

It adds a note to the "Hints for further verification" section explaining that Windows pathnames may have reserved meanings, including NTFS Alternate Data Streams (ADS), and points users to os.path.isreserved() where appropriate.

No tarfile behavior, extraction filters, or runtime code are changed.

Validation

  • git diff --check

Closes gh-152691

@read-the-docs-community

read-the-docs-community Bot commented Jun 30, 2026

Copy link
Copy Markdown

Documentation build overview

📚 cpython-previews | 🛠️ Build #33377903 | 📁 Comparing 95038cc against main (f1c5363)

  🔍 Preview build  

3 files changed
± library/dis.html
± library/tarfile.html
± whatsnew/changelog.html

Comment thread Doc/library/tarfile.rst Outdated
@zainnadeem786 zainnadeem786 force-pushed the docs/tarfile-windows-ads-guidance branch from 8a7e4e7 to 95038cc Compare June 30, 2026 16:41
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

awaiting merge docs Documentation in the Doc dir skip news

Projects

Status: Todo

Development

Successfully merging this pull request may close these issues.

Document Windows NTFS Alternate Data Stream (ADS) filenames in tarfile extraction guidance

3 participants