Skip to content

Conversation

Copy link
Contributor

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 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 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
@gewarren gewarren requested a review from adegeo June 10, 2025 19:14
@gewarren gewarren enabled auto-merge (squash) June 27, 2025 17:47
@gewarren
Copy link
Contributor

@dotnet/docs This is ready for final review.

@gewarren gewarren merged commit ac0540d into main Jul 25, 2025
10 checks passed
@gewarren gewarren deleted the copilot/fix-46465 branch July 25, 2025 18:38
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

3 participants