Skip to content

Conversation

@gewarren
Copy link
Contributor

@gewarren gewarren commented Dec 7, 2025

Build.Reason:Manual by Genevieve Warren
Build.Url:https://apidrop.visualstudio.com/Content%20CI/_build/results?buildId=580399&view=results
source_repo.branch:SCL
source_repo.url:https://apidrop.visualstudio.com/_git/binaries

Summary

These APIs were published under the System.CommandLine API and then never updated. The newer SCL APIs are published under the .NET (package-provided) monikers.

@gewarren gewarren requested a review from a team as a code owner December 7, 2025 22:26
Copilot AI review requested due to automatic review settings December 7, 2025 22:26
@gewarren gewarren requested a review from adamsitnik December 7, 2025 22:27
@dotnet-policy-service
Copy link
Contributor

@@gewarren - This PR edits one or more files whose 'source of truth' for documentation is not in this repo. Please make documentation updates in the /// comments in the dotnet/runtime repo (or dotnet/extensions repo) instead.

Copy link
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR removes deprecated System.CommandLine API documentation published under the "system-commandline" framework moniker. The changes clean up XML documentation files by removing old API variants and obsolete framework-specific entries, keeping only the current .NET package-provided monikers (net-10.0-pp, net-8.0-pp, net-9.0-pp, netstandard-2.0-pp).

Key Changes:

  • Removes framework-specific variants for the old "system-commandline" moniker across multiple types
  • Deletes entire documentation files for deprecated extension classes and types
  • Cleans up System.Numerics.Tensors metadata by removing unnecessary System.Runtime.InteropServices.InAttribute references
  • Removes Index attributes from Parameter elements throughout the codebase

Reviewed changes

Copilot reviewed 70 out of 70 changed files in this pull request and generated no comments.

Show a summary per file
File Description
System.Numerics.Tensors/Tensor`1.xml Removed InAttribute from InterfaceMember references
System.Numerics.Tensors/TensorSpan`1.xml Removed InAttribute from InterfaceMember references
System.Numerics.Tensors/ReadOnlyTensorSpan`1.xml Removed InAttribute from InterfaceMember references
System.CommandLine/Symbol.xml Removed system-commandline framework variants and obsolete members
System.CommandLine/RootCommand.xml Cleaned up Parameter Index attributes
System.CommandLine/Option`1.xml Removed system-commandline constructors and interface implementations
System.CommandLine/OptionExtensions.xml Entire file deleted (deprecated extensions)
System.CommandLine/Option.xml Removed system-commandline members and interface implementations
System.CommandLine/LocalizationResources.xml Entire file deleted (old localization API)
System.CommandLine/IdentifierSymbol.xml Entire file deleted (deprecated base class)
System.CommandLine/IConsole.xml Entire file deleted (deprecated interface)
System.CommandLine/Handler.xml Entire file deleted (deprecated handler methods)
System.CommandLine/DirectiveCollection.xml Entire file deleted (deprecated directive collection)
System.CommandLine/ConsoleExtensions.xml Entire file deleted (deprecated extensions)
System.CommandLine/CompletionSourceList.xml Entire file deleted (deprecated completion source list)
System.CommandLine/CompletionSourceExtensions.xml Removed system-commandline overloads and cleaned up parameters
System.CommandLine/CommandLineConfigurationException.xml Entire file deleted (deprecated exception type)
System.CommandLine/CommandLineConfiguration.xml Entire file deleted (deprecated configuration class)
System.CommandLine/CommandExtensions.xml Entire file deleted (deprecated extensions)
System.CommandLine/Argument`1.xml Removed system-commandline constructors and interface implementations
System.CommandLine/ArgumentArity.xml Cleaned up FrameworkAlternate attributes
System.CommandLine.Parsing/ValidateSymbolResult`1.xml Entire file deleted (deprecated delegate)
System.CommandLine.Parsing/TokenType.xml Removed Unparsed enum value and cleaned up Directive value
System.CommandLine.Parsing/Token.xml Removed system-commandline type signatures
System.CommandLine.Parsing/ParseError.xml Removed system-commandline type signatures
System.CommandLine.Parsing/ParseArgument`1.xml Entire file deleted (deprecated delegate)

@BillWagner
Copy link
Member

@gewarren Are the warnings expected on this one?

@gewarren
Copy link
Contributor Author

gewarren commented Dec 8, 2025

@gewarren Are the warnings expected on this one?

@BillWagner No, fixed.

@gewarren gewarren enabled auto-merge (squash) December 8, 2025 17:08
Copy link
Member

@BillWagner BillWagner left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This LGTM. Let's :shipit:

@gewarren gewarren merged commit 97baddc into main Dec 8, 2025
6 checks passed
@gewarren gewarren deleted the scl branch December 8, 2025 18:16
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.

3 participants