docs
docs copied to clipboard
Document breaking change: GnuTarEntry and PaxTarEntry no longer includes atime and ctime by default
Added documentation for the breaking change introduced in .NET 10 Preview 5 where GnuTarEntry and PaxTarEntry no longer automatically set access time (atime) and change time (ctime) fields when creating new entries.
Changes Made
-
Created new breaking change document:
docs/core/compatibility/core-libraries/10.0/tar-atime-ctime-default.md- Documents the behavioral change with clear before/after descriptions
- Explains the reason: better compatibility with tar readers that don't support these fields
- Provides guidance for users who need these fields (they can set them explicitly)
- Includes proper xref links to affected APIs
-
Updated TOC: Added entry to
docs/core/compatibility/toc.ymlunder Core .NET libraries section for .NET 10 -
Updated index: Added entry to
docs/core/compatibility/10.0.mdin the Core .NET libraries table
Key Details
- Breaking change type: Behavioral change
- Version introduced: .NET 10 Preview 5
- Affected APIs:
System.Formats.Tar.GnuTarEntrySystem.Formats.Tar.PaxTarEntrySystem.Formats.Tar.TarReaderSystem.Formats.Tar.TarWriter
The documentation follows established patterns and maintains alphabetical ordering in both the TOC and index files. All changes pass markdownlint validation.
Fixes #46465.
💡 You can make Copilot smarter by setting up custom instructions, customizing its development environment and configuring Model Context Protocol (MCP) servers. Learn more Copilot coding agent tips in the docs.