Skip to content

Commit

Permalink
Add Doc comments for IntrinsicIds (dotnet/linker#3063)
Browse files Browse the repository at this point in the history 
Commit migrated from dotnet/linker@3ebf013
  • Loading branch information
@jtschuster
jtschuster authored Oct 14, 2022
1 parent ff7fc92 commit 6f9ed1a
Showing 1 changed file with 222 additions and 3 deletions.
225 changes: 222 additions & 3 deletions src/tools/illink/src/ILLink.Shared/TrimAnalysis/IntrinsicId.cs
View file
Original file line number Diff line number Diff line change
Expand Up @@ -23,7 +23,7 @@ enum IntrinsicId
/// </summary>
Type_get_TypeHandle,
/// <summary>
/// <see cref="System.Object.GetType()"/>
/// <see cref="object.GetType()"/>
/// </summary>
Object_GetType,
/// <summary>
Expand All @@ -39,8 +39,10 @@ enum IntrinsicId
/// </summary>
TypeInfo_AsType,
/// <summary>
/// <see cref="System.Reflection.MethodBase.GetMethodFromHandle(System.RuntimeMethodHandle)"/> or
/// <see cref="System.Reflection.MethodBase.GetMethodFromHandle(System.RuntimeMethodHandle, System.RuntimeTypeHandle)"/>
/// <list type="table">
/// <item><see cref="System.Reflection.MethodBase.GetMethodFromHandle(System.RuntimeMethodHandle)"/></item>
/// <item><see cref="System.Reflection.MethodBase.GetMethodFromHandle(System.RuntimeMethodHandle, System.RuntimeTypeHandle)"/></item>
/// </list>
/// </summary>
MethodBase_GetMethodFromHandle,
/// <summary>
Expand All @@ -51,50 +53,267 @@ enum IntrinsicId
// Anything above this marker will require the method to be run through
// the reflection body scanner.
RequiresReflectionBodyScanner_Sentinel = 1000,
/// <summary>
/// <see cref="System.Type.MakeGenericType(System.Type[])"/>
/// </summary>
Type_MakeGenericType,
/// <summary>
/// <list type="table">
/// <item><see cref="System.Type.GetType(string)"/></item>
/// <item><see cref= "System.Type.GetType(string, bool)" /></item>
/// <item><see cref="System.Type.GetType(string, bool, bool)"/></item>
/// <item><see cref="System.Type.GetType(string, System.Func{System.Reflection.AssemblyName, System.Reflection.Assembly?}?, System.Func{System.Reflection.Assembly?, string, bool, System.Type?}?)"/></item>
/// <item><see cref="System.Type.GetType(string, System.Func{System.Reflection.AssemblyName, System.Reflection.Assembly?}?, System.Func{System.Reflection.Assembly?, string, bool, System.Type?}?, bool)"/></item>
/// <item><see cref="System.Type.GetType(string, System.Func{System.Reflection.AssemblyName, System.Reflection.Assembly?}?, System.Func{System.Reflection.Assembly?, string, bool, System.Type?}?, bool, bool)"/></item>
/// </list>
/// </summary>
Type_GetType,
/// <summary>
/// <item><see cref="System.Type.GetConstructor(System.Type[])"/></item>
/// <item><see cref="System.Type.GetConstructor(System.Reflection.BindingFlags, System.Type[])"/></item>
/// <item><see cref="System.Type.GetConstructor(System.Reflection.BindingFlags, System.Reflection.Binder?, System.Type[], System.Reflection.ParameterModifier[]?)"/></item>
/// <item><see cref="System.Type.GetConstructor(System.Reflection.BindingFlags, System.Reflection.Binder?, System.Reflection.CallingConventions, System.Type[], System.Reflection.ParameterModifier[]?)"/></item>
/// </list>
/// </summary>
Type_GetConstructor,
/// <summary>
/// <see cref="System.Type.GetConstructors(System.Reflection.BindingFlags)"/>
/// </summary>
Type_GetConstructors__BindingFlags,
/// <summary>
/// <item><see cref="System.Type.GetMethod(string)"/></item>
/// <item><see cref="System.Type.GetMethod(string, System.Reflection.BindingFlags)"/></item>
/// <item><see cref="System.Type.GetMethod(string, System.Type[])"/></item>
/// <item><see cref="System.Type.GetMethod(string, System.Type[], System.Reflection.ParameterModifier[]?)"/></item>
/// <item><see cref="System.Type.GetMethod(string, System.Reflection.BindingFlags, System.Type[])"/></item>
/// <item><see cref="System.Type.GetMethod(string, System.Reflection.BindingFlags, System.Reflection.Binder, System.Type[], System.Reflection.ParameterModifier[]?)"/></item>
/// <item><see cref="System.Type.GetMethod(string, System.Reflection.BindingFlags, System.Reflection.Binder, System.Reflection.CallingConventions, System.Type[], System.Reflection.ParameterModifier[]?)"/></item>
/// <item><see cref="System.Type.GetMethod(string, int, System.Type[])"/></item>
/// <item><see cref="System.Type.GetMethod(string, int, System.Type[], System.Reflection.ParameterModifier[]?)"/></item>
/// <item><see cref="System.Type.GetMethod(string, int, System.Reflection.BindingFlags, System.Reflection.Binder?, System.Type[], System.Reflection.ParameterModifier[]?)"/></item>
/// <item><see cref="System.Type.GetMethod(string, int, System.Reflection.BindingFlags, System.Reflection.Binder?, System.Reflection.CallingConventions, System.Type[], System.Reflection.ParameterModifier[]?)"/></item>
/// </list>
/// </summary>
Type_GetMethod,
/// <summary>
/// <see cref="System.Type.GetMethod(System.Reflection.BindingFlags)"/>
/// </summary>
Type_GetMethods__BindingFlags,
/// <summary>
/// <list type="table">
/// <item><see cref="System.Type.GetField(string)"/></item>
/// <item><see cref="System.Type.GetField(string, System.Reflection.BindingFlags)"/></item>
/// </list>
/// </summary>
Type_GetField,
/// <summary>
/// <see cref="System.Type.GetFields(System.Reflection.BindingFlags)"/>
/// </summary>
Type_GetFields__BindingFlags,
/// <summary>
/// <list type="table">
/// <item><see cref="System.Type.GetProperty(string)"/></item>
/// <item><see cref="System.Type.GetProperty(string, System.Reflection.BindingFlags)"/></item>
/// <item><see cref="System.Type.GetProperty(string, System.Type?)"/></item>
/// <item><see cref="System.Type.GetProperty(string, System.Type[])"/></item>
/// <item><see cref="System.Type.GetProperty(string, System.Type?, System.Type[])"/></item>
/// <item><see cref="System.Type.GetProperty(string, System.Type?, System.Type[], System.Reflection.ParameterModifier[])"/></item>
/// <item><see cref="System.Type.GetProperty(string, System.Reflection.BindingFlags, System.Reflection.Binder?, System.Type?, System.Type[], System.Reflection.ParameterModifier[]?)"/></item>
/// </list>
/// </summary>
Type_GetProperty,
/// <summary>
/// <see cref="System.Type.GetProperties(System.Reflection.BindingFlags)"/>
/// </summary>
Type_GetProperties__BindingFlags,
/// <summary>
/// <list type="table">
/// <item><see cref="System.Type.GetEvent(string)"/></item>
/// <item><see cref="System.Type.GetEvent(string, System.Reflection.BindingFlags)"/></item>
/// </list>
/// </summary>
Type_GetEvent,
/// <summary>
/// <see cref="System.Type.GetEvents(System.Reflection.BindingFlags)"/>
/// </summary>
Type_GetEvents__BindingFlags,
/// <summary>
/// <list type="table">
/// <item><see cref="System.Type.GetNestedType(string)"/></item>
/// <item><see cref="System.Type.GetNestedType(string, System.Reflection.BindingFlags)"/></item>
/// </list>
/// </summary>
Type_GetNestedType,
/// <summary>
/// <see cref="System.Type.GetNestedTypes(System.Reflection.BindingFlags)"/>
/// </summary>
Type_GetNestedTypes__BindingFlags,
/// <summary>
/// <list type="table">
/// <item><see cref="System.Type.GetMember(string)"/></item>
/// <item><see cref="System.Type.GetMember(string, System.Reflection.BindingFlags)"/></item>
/// <item><see cref="System.Type.GetMember(string, System.Reflection.MemberTypes, System.Reflection.BindingFlags)"/></item>
/// </list>
/// </summary>
Type_GetMember,
/// <summary>
/// <see cref="System.Type.GetMembers(System.Reflection.BindingFlags)"/>
/// </summary>
Type_GetMembers__BindingFlags,
/// <summary>
/// <list type="table">
/// <item><see cref="System.Type.GetInterface(string)"/></item>
/// <item><see cref="System.Type.GetInterface(string, bool)"/></item>
/// </list>
/// </summary>
Type_GetInterface,
/// <summary>
/// <see cref="System.Type.AssemblyQualifiedName"/>
/// </summary>
Type_get_AssemblyQualifiedName,
/// <summary>
/// <see cref="System.Type.UnderlyingSystemType"/>
/// </summary>
Type_get_UnderlyingSystemType,
/// <summary>
/// <see cref="System.Type.BaseType"/>
/// </summary>
Type_get_BaseType,
/// <summary>
/// <see cref="System.Linq.Expressions.Expression.Call(System.Type, string, System.Type[]?, System.Linq.Expressions.Expression[]?))"/>
/// </summary>
Expression_Call,
/// <summary>
/// <see cref="System.Linq.Expressions.Expression.Field(System.Linq.Expressions.Expression?, System.Type, string)"/>
/// </summary>
Expression_Field,
/// <summary>
/// <list type="table">
/// <item><see cref="System.Linq.Expressions.Expression.Property(System.Linq.Expressions.Expression?, System.Reflection.MethodInfo)"/></item>
/// <item><see cref="System.Linq.Expressions.Expression.Property(System.Linq.Expressions.Expression?, System.Type, string)"/></item>
/// </list>
/// </summary>
Expression_Property,
/// <summary>
/// <see cref="System.Linq.Expressions.Expression.New(System.Type)"/>
/// </summary>
Expression_New,
/// <summary>
/// <see cref="System.Enum.GetValues(System.Type)"/>
/// </summary>
Enum_GetValues,
/// <summary>
/// <see cref="System.Runtime.InteropServices.Marshal.SizeOf(System.Type)"/>
/// </summary>
Marshal_SizeOf,
/// <summary>
/// <see cref="System.Runtime.InteropServices.Marshal.OffsetOf(System.Type, string)"/>
/// </summary>
Marshal_OffsetOf,
/// <summary>
/// <see cref="System.Runtime.InteropServices.Marshal.PtrToStructure(nint, System.Type)"/>
/// </summary>
Marshal_PtrToStructure,
/// <summary>
/// <see cref="System.Runtime.InteropServices.Marshal.DestroyStructure(nint, System.Type)"/>
/// </summary>
Marshal_DestroyStructure,
/// <summary>
/// <see cref="System.Runtime.InteropServices.Marshal.GetDelegateForFunctionPointer(nint, System.Type)"/>
/// </summary>
Marshal_GetDelegateForFunctionPointer,
/// <list type="table">
/// <item><see cref="System.Activator.CreateInstance(System.Type)"/></item>
/// <item><see cref="System.Activator.CreateInstance(System.Type, bool)"/></item>
/// <item><see cref="System.Activator.CreateInstance(System.Type, object[])"/></item>
/// <item><see cref="System.Activator.CreateInstance(System.Type, object[], object[])"/></item>
/// <item><see cref="System.Activator.CreateInstance(System.Type, System.Reflection.BindingFlags, System.Reflection.Binder, object[], System.Globalization.CultureInfo)"/></item>
/// <item><see cref="System.Activator.CreateInstance(System.Type, System.Reflection.BindingFlags, System.Reflection.Binder, object[], System.Globalization.CultureInfo, object[])"/></item>
/// </list>
Activator_CreateInstance__Type,
/// <summary>
/// <list type="table">
/// <item><see cref="System.Activator.CreateInstance(string, string)"/></item>
/// <item><see cref="System.Activator.CreateInstance(string, string, bool, System.Reflection.BindingFlags, System.Reflection.Binder, object[], System.Globalization.CultureInfo, object[])"/></item>
/// <item><see cref="System.Activator.CreateInstance(string, string, object[])"/></item>
/// </list>
/// </summary>
Activator_CreateInstance__AssemblyName_TypeName,
/// <summary>
/// <list type="table">
/// <item><see cref="System.Activator.CreateInstanceFrom(string, string)"/></item>
/// <item><see cref="System.Activator.CreateInstanceFrom(string, string, bool, System.Reflection.BindingFlags, System.Reflection.Binder, object[], System.Globalization.CultureInfo, object[])"/></item>
/// <item><see cref="System.Activator.CreateInstanceFrom(string, string, object[])"/></item>
/// </list>
/// </summary>
Activator_CreateInstanceFrom,
/// <summary>
/// <list type="table">
/// <item><see cref="System.AppDomain.CreateInstance(string, string)"/></item>
/// <item><see cref="System.AppDomain.CreateInstance(string, string, bool, System.Reflection.BindingFlags, System.Reflection.Binder, object[], System.Globalization.CultureInfo, object[])"/></item>
/// <item><see cref="System.AppDomain.CreateInstance(string, string, object[])"/></item>
/// </list>
/// </summary>
AppDomain_CreateInstance,
/// <summary>
/// <list type="table">
/// <item><see cref="System.AppDomain.CreateInstanceAndUnwrap(string, string)"/></item>
/// <item><see cref="System.AppDomain.CreateInstanceAndUnwrap(string, string, bool, System.Reflection.BindingFlags, System.Reflection.Binder, object[], System.Globalization.CultureInfo, object[])"/></item>
/// <item><see cref="System.AppDomain.CreateInstanceAndUnwrap(string, string, object[])"/></item>
/// </list>
/// </summary>
AppDomain_CreateInstanceAndUnwrap,
/// <summary>
/// <list type="table">
/// <item><see cref="System.AppDomain.CreateInstanceFrom(string, string)"/></item>
/// <item><see cref="System.AppDomain.CreateInstanceFrom(string, string, bool, System.Reflection.BindingFlags, System.Reflection.Binder, object[], System.Globalization.CultureInfo, object[])"/></item>
/// <item><see cref="System.AppDomain.CreateInstanceFrom(string, string, object[])"/></item>
/// </list>
/// </summary>
AppDomain_CreateInstanceFrom,
/// <summary>
/// <list type="table">
/// <item><see cref="System.AppDomain.CreateInstanceFromAndUnwrap(string, string)"/></item>
/// <item><see cref="System.AppDomain.CreateInstanceFromAndUnwrap(string, string, bool, System.Reflection.BindingFlags, System.Reflection.Binder, object[], System.Globalization.CultureInfo, object[])"/></item>
/// <item><see cref="System.AppDomain.CreateInstanceFromAndUnwrap(string, string, object[])"/></item>
/// </list>
/// </summary>
AppDomain_CreateInstanceFromAndUnwrap,
/// <summary>
/// <list type="table">
/// <item><see cref="System.Reflection.Assembly.CreateInstance(string)"/></item>
/// <item><see cref="System.Reflection.Assembly.CreateInstance(string, bool)"/></item>
/// <item><see cref="System.Reflection.Assembly.CreateInstance(string, bool, System.Reflection.BindingFlags, System.Reflection.Binder, object[], System.Globalization.CultureInfo, object[])"/></item>
/// </list>
/// </summary>
Assembly_CreateInstance,
/// <summary>
/// <see cref="System.Reflection.RuntimeReflectionExtensions.GetRuntimeEvent(System.Type, string)"/>
/// </summary>
RuntimeReflectionExtensions_GetRuntimeEvent,
/// <summary>
/// <see cref="System.Reflection.RuntimeReflectionExtensions.GetRuntimeField(System.Type, string)"/>
/// </summary>
RuntimeReflectionExtensions_GetRuntimeField,
/// <summary>
/// <see cref="System.Reflection.RuntimeReflectionExtensions.GetRuntimeMethod(System.Type, string, System.Type[])"/>
/// </summary>
RuntimeReflectionExtensions_GetRuntimeMethod,
/// <summary>
/// <see cref="System.Reflection.RuntimeReflectionExtensions.GetRuntimeProperty(System.Type, string)"/>
/// </summary>
RuntimeReflectionExtensions_GetRuntimeProperty,
/// <summary>
/// <see cref="System.Runtime.CompilerServices.RuntimeHelpers.RunClassConstructor(System.RuntimeTypeHandle)"/>
/// </summary>
RuntimeHelpers_RunClassConstructor,
/// <summary>
/// <see cref="System.Reflection.MethodInfo.MakeGenericMethod(System.Type[])"/>
/// </summary>
MethodInfo_MakeGenericMethod,
/// <summary>
/// <see cref="System.Nullable.GetUnderlyingType(System.Type)"/>
/// </summary>
Nullable_GetUnderlyingType
}
}

0 comments on commit 6f9ed1a

Please sign in to comment.