Skip to content

Remove .NET Framework remarks (System.InteropServices)#12670

Merged
gewarren merged 2 commits into
dotnet:mainfrom
gewarren:fw-remarks-system-runtime-interopservices
May 29, 2026
Merged

Remove .NET Framework remarks (System.InteropServices)#12670
gewarren merged 2 commits into
dotnet:mainfrom
gewarren:fw-remarks-system-runtime-interopservices

Conversation

@gewarren
Copy link
Copy Markdown
Contributor

.NET Framework API ref has moved to its own repo (https://github.com/dotnet/dotnetfw-api-docs), so we can clean up .NET Framework remarks, exceptions, and code examples out of this repo. Contributes to #12513.

Removes remarks and examples related to:

  • .NET Framework versions
  • Code-access security
  • Configuring apps via app.config file
  • App domains

Also removes all remarks from obsolete APIs.

Hide whitespace changes

Copy link
Copy Markdown
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 .NET Framework-specific remarks, examples, and exception text from System.Runtime.InteropServices API reference content as part of the broader cleanup tracked by #12513.

Changes:

  • Removes or simplifies references to .NET Framework, CAS/CER, app domains, MDAs, and legacy tooling.
  • Removes examples and remarks from obsolete or framework-specific APIs.
  • Normalizes some markdown formatting and wording in interop documentation.

Reviewed changes

Copilot reviewed 17 out of 17 changed files in this pull request and generated 9 comments.

Show a summary per file
File Description
xml/System.Runtime.InteropServices/VariantWrapper.xml Removes legacy .NET Framework variant marshaling notes.
xml/System.Runtime.InteropServices/UnmanagedType.xml Simplifies remarks and removes framework link text.
xml/System.Runtime.InteropServices/StructLayoutAttribute.xml Removes .NET Framework layout comparison.
xml/System.Runtime.InteropServices/SEHException.xml Replaces .NET Framework wording with .NET wording.
xml/System.Runtime.InteropServices/SafeHandle.xml Removes framework-specific MDA text and updates wording.
xml/System.Runtime.InteropServices/SafeBuffer.xml Removes CER wording and updates code fence language.
xml/System.Runtime.InteropServices/RuntimeInformation.xml Removes framework/native entries from framework description remarks.
xml/System.Runtime.InteropServices/RuntimeEnvironment.xml Removes obsolete API remarks/examples and simplifies PNSE text.
xml/System.Runtime.InteropServices/NativeLibrary.xml Removes .NET 5+ qualifier from native library loading behavior.
xml/System.Runtime.InteropServices/Marshal.xml Removes framework-specific allocator, HRESULT, P/Invoke, RCW, and exception guidance.
xml/System.Runtime.InteropServices/DllImportAttribute.xml Removes framework-only constructor remarks and simplifies SetLastError guidance.
xml/System.Runtime.InteropServices/CriticalHandle.xml Removes CER/ReliabilityContract guidance and updates wording.
xml/System.Runtime.InteropServices/ComUnregisterFunctionAttribute.xml Removes Regasm/.NET Framework registration wording.
xml/System.Runtime.InteropServices/ComRegisterFunctionAttribute.xml Removes Regasm/.NET Framework registration wording and normalizes bullets.
xml/System.Runtime.InteropServices/ClassInterfaceType.xml Normalizes markdown whitespace and removes version qualifier.
xml/System.Runtime.InteropServices.ComTypes/IPersistFile.xml Normalizes markdown whitespace and updates one COM API reference.
xml/System.Runtime.InteropServices.ComTypes/CALLCONV.xml Normalizes bullet spacing and replaces framework wording.

Comment thread xml/System.Runtime.InteropServices/DllImportAttribute.xml Outdated
Comment thread xml/System.Runtime.InteropServices/NativeLibrary.xml Outdated
Comment thread xml/System.Runtime.InteropServices/RuntimeEnvironment.xml Outdated
Comment thread xml/System.Runtime.InteropServices/SafeBuffer.xml Outdated
Comment thread xml/System.Runtime.InteropServices/Marshal.xml Outdated
Comment thread xml/System.Runtime.InteropServices/Marshal.xml Outdated
Comment thread xml/System.Runtime.InteropServices/Marshal.xml Outdated
Comment thread xml/System.Runtime.InteropServices/Marshal.xml Outdated
Comment thread xml/System.Runtime.InteropServices/Marshal.xml Outdated
Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
Co-authored-by: Genevieve Warren <24882762+gewarren@users.noreply.github.com>
@gewarren gewarren requested a review from a team May 28, 2026 15:18
Copy link
Copy Markdown
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 b1462f8 into dotnet:main May 29, 2026
6 checks passed
@gewarren gewarren deleted the fw-remarks-system-runtime-interopservices branch May 29, 2026 20:45
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