Skip to content

Document breaking change: GnuTarEntry and PaxTarEntry no longer includes atime and ctime by default #46588

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 4 commits into
base: main
Choose a base branch
from

Conversation

Copilot
Copy link
Contributor

@Copilot Copilot AI commented Jun 6, 2025

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.yml under Core .NET libraries section for .NET 10

  • Updated index: Added entry to docs/core/compatibility/10.0.md in the Core .NET libraries table

Key Details

  • Breaking change type: Behavioral change
  • Version introduced: .NET 10 Preview 5
  • Affected APIs:
    • System.Formats.Tar.GnuTarEntry
    • System.Formats.Tar.PaxTarEntry
    • System.Formats.Tar.TarReader
    • System.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.


Internal previews

📄 File 🔗 Preview link
docs/core/compatibility/10.0.md Breaking changes in .NET 10
docs/core/compatibility/core-libraries/10.0/tar-atime-ctime-default.md GnuTarEntry and PaxTarEntry exclude atime and ctime by default
docs/core/compatibility/toc.yml docs/core/compatibility/toc

@Copilot Copilot AI changed the title [WIP] [Breaking change]: GnuTarEntry and PaxTarEntry no longer includes atime and ctime by default Document breaking change: GnuTarEntry and PaxTarEntry no longer includes atime and ctime by default Jun 6, 2025
@Copilot Copilot AI requested a review from gewarren June 6, 2025 02:50
Copilot finished work on behalf of gewarren June 6, 2025 02:50
@gewarren gewarren marked this pull request as ready for review June 6, 2025 03:05
@gewarren gewarren requested a review from a team as a code owner June 6, 2025 03:05
@gewarren gewarren requested a review from ericstj June 6, 2025 03:13
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

Successfully merging this pull request may close these issues.

[Breaking change]: GnuTarEntry and PaxTarEntry no longer includes atime and ctime by default
2 participants