Update XML docs for IntPtr and UIntPtr

[Neme12]

The XML docs summary for IntPtr and UIntPtr currently says:

A platform-specific type that is used to represent a pointer or a handle.

This is also shown in the IDE when hovering over nint and nuint:

Now that the C# native integer types are being unified with IntPtr and UIntPtr, I think their docs should be updated to mention that they're also used to represent native integer types in general, and it's not just for pointers and handles. Maybe something like this:

Int32 currently: "Represents a 32-bit signed integer."
IntPtr could be: "Represents a native word-sized signed integer. Often used to represent a pointer or a handle."
or "Represents a platform-specific signed integer. Often..."

UInt32 currently: "Represents a 32-bit unsigned integer."
UIntPtr could be: "Represents a native word-sized unsigned integer. Often used to represent a pointer or a handle."
or "Represents a platform-specific unsigned integer. Often..."

As opposed to "Often used", maybe it could say something like "Formerly, this has been used to represent a pointer or a handle." or somehow mention that it's especially been this way historically.

I noticed this in dotnet/roslyn#61431
@jcouv @tannergooding

[dotnet-issue-labeler]

I couldn't figure out the best area label to add to this issue. If you have write-permissions please help me learn by adding exactly one area label.

[tannergooding]

I'll be updating this alongside a PR I'm working on once the official build is finished and I can consume the new language functionality.

Based on past build times, I should have bits within the hour.

[Neme12]

This also applies to the constructors and other members like Size and probably others. Basically everywhere where it just says "pointer", it should primarily say "integer" and "pointer" maybe optionally in addition to that.

[ghost]

Tagging subscribers to this area: @dotnet/area-system-numerics
See info in area-owners.md if you want to be subscribed.

Issue Details

---

The XML docs summary for IntPtr and UIntPtr currently says:

A platform-specific type that is used to represent a pointer or a handle.

This is also shown in the IDE when hovering over nint and nuint:

Now that the C# native integer types are being unified with IntPtr and UIntPtr, I think their docs should be updated to mention that they're also used to represent native integer types in general, and it's not just for pointers and handles. Maybe something like this:

Int32 currently: "Represents a 32-bit signed integer."
IntPtr could be: "Represents a native word-sized signed integer. Often used to represent a pointer or a handle."
or "Represents a platform-specific signed integer. Often..."

UInt32 currently: "Represents a 32-bit unsigned integer."
UIntPtr could be: "Represents a native word-sized unsigned integer. Often used to represent a pointer or a handle."
or "Represents a platform-specific unsigned integer. Often..."

As opposed to "Often used", maybe it could say something like "Formerly, this has been used to represent a pointer or a handle." or somehow mention that it's especially been this way historically.

I noticed this in dotnet/roslyn#61431
@jcouv @tannergooding

Author:	Neme12
Assignees:	tannergooding
Labels:	area-System.Numerics, untriaged
Milestone:	-

[tannergooding]

This is being handled by dotnet/dotnet-api-docs#8132