From 1b3dc3356cb6acd7025d50202b7003f0244fb7ed Mon Sep 17 00:00:00 2001 From: Stephen Toub Date: Tue, 4 Dec 2018 10:47:21 -0500 Subject: [PATCH] Fix lots of malformed XML comments These are causing errors in the source.dot.net build. Turning on DocumentationFile and suppressing 1591, 1573, and 0419, Corelib builds clean after these changes. --- .../shared/System/Buffers/StandardFormat.cs | 4 +- .../System/Collections/Generic/IEnumerable.cs | 1 - .../System/Collections/Generic/IEnumerator.cs | 2 - .../shared/System/Convert.Base64.cs | 4 +- .../shared/System/Decimal.DecCalc.cs | 2 +- .../Tracing/TraceLogging/InvokeTypeInfo.cs | 3 - src/System.Private.CoreLib/shared/System/Lazy.cs | 4 +- .../shared/System/Progress.cs | 2 +- .../shared/System/ReadOnlySpan.Fast.cs | 3 +- .../CompilerServices/AsyncIteratorMethodBuilder.cs | 2 +- .../System/Runtime/CompilerServices/TaskAwaiter.cs | 6 +- .../Arm/Arm64/Aes.PlatformNotSupported.cs | 8 +- .../Arm/Arm64/Sha1.PlatformNotSupported.cs | 12 +- .../Arm/Arm64/Sha256.PlatformNotSupported.cs | 8 +- .../Arm/Arm64/Simd.PlatformNotSupported.cs | 38 ++-- .../shared/System/Runtime/Intrinsics/Vector128.cs | 200 ++++++++++----------- .../System/Runtime/Intrinsics/Vector128_1.cs | 40 ++--- .../shared/System/Runtime/Intrinsics/Vector256.cs | 200 ++++++++++----------- .../System/Runtime/Intrinsics/Vector256_1.cs | 40 ++--- .../shared/System/Runtime/Intrinsics/Vector64.cs | 124 ++++++------- .../shared/System/Runtime/Intrinsics/Vector64_1.cs | 40 ++--- .../shared/System/Runtime/Intrinsics/X86/Avx2.cs | 3 +- .../shared/System/Runtime/Intrinsics/X86/Sse2.cs | 2 +- .../shared/System/Span.Fast.cs | 3 +- .../shared/System/Text/Rune.cs | 4 +- .../shared/System/Text/StringBuilder.cs | 10 +- .../shared/System/Text/UnicodeUtility.cs | 4 +- .../shared/System/Threading/LazyInitializer.cs | 2 +- .../shared/System/Threading/SemaphoreSlim.cs | 7 +- .../shared/System/Threading/SpinWait.cs | 18 +- .../System/Threading/Tasks/TaskExtensions.cs | 6 +- .../shared/System/TimeZoneInfo.Win32.cs | 6 +- .../shared/System/TimeZoneInfo.cs | 4 +- .../src/Microsoft/Win32/Win32Native.cs | 6 +- .../src/System/Diagnostics/Contracts/Contracts.cs | 4 +- .../System/Diagnostics/Contracts/ContractsBCL.cs | 4 +- src/System.Private.CoreLib/src/System/RtType.cs | 2 +- .../Runtime/CompilerServices/AsyncMethodBuilder.cs | 9 +- .../src/System/Runtime/InteropServices/Marshal.cs | 8 +- .../System/Threading/CancellationTokenSource.cs | 4 +- .../System/Threading/ClrThreadPoolBoundHandle.cs | 2 +- .../src/System/Threading/Tasks/FutureFactory.cs | 6 +- .../Threading/Tasks/ProducerConsumerQueues.cs | 2 +- .../src/System/Threading/Tasks/TPLETWProvider.cs | 12 +- .../src/System/Threading/Tasks/Task.cs | 5 +- .../src/System/Threading/Tasks/TaskContinuation.cs | 7 +- .../src/System/Threading/Tasks/future.cs | 2 +- 47 files changed, 433 insertions(+), 452 deletions(-) diff --git a/src/System.Private.CoreLib/shared/System/Buffers/StandardFormat.cs b/src/System.Private.CoreLib/shared/System/Buffers/StandardFormat.cs index 8260325..62ab2f3 100644 --- a/src/System.Private.CoreLib/shared/System/Buffers/StandardFormat.cs +++ b/src/System.Private.CoreLib/shared/System/Buffers/StandardFormat.cs @@ -67,7 +67,7 @@ namespace System.Buffers public static implicit operator StandardFormat(char symbol) => new StandardFormat(symbol); /// - /// Converts a ReadOnlySpan into a StandardFormat + /// Converts a into a StandardFormat /// public static StandardFormat Parse(ReadOnlySpan format) { @@ -82,7 +82,7 @@ namespace System.Buffers public static StandardFormat Parse(string format) => format == null ? default : Parse(format.AsSpan()); /// - /// Tries to convert a ReadOnlySpan into a StandardFormat. A return value indicates whether the conversion succeeded or failed. + /// Tries to convert a into a StandardFormat. A return value indicates whether the conversion succeeded or failed. /// public static bool TryParse(ReadOnlySpan format, out StandardFormat result) { diff --git a/src/System.Private.CoreLib/shared/System/Collections/Generic/IEnumerable.cs b/src/System.Private.CoreLib/shared/System/Collections/Generic/IEnumerable.cs index ddb798e..46d30cb 100644 --- a/src/System.Private.CoreLib/shared/System/Collections/Generic/IEnumerable.cs +++ b/src/System.Private.CoreLib/shared/System/Collections/Generic/IEnumerable.cs @@ -14,7 +14,6 @@ namespace System.Collections.Generic { // Returns an IEnumerator for this enumerable Object. The enumerator provides // a simple way to access all the contents of a collection. - /// new IEnumerator GetEnumerator(); } } diff --git a/src/System.Private.CoreLib/shared/System/Collections/Generic/IEnumerator.cs b/src/System.Private.CoreLib/shared/System/Collections/Generic/IEnumerator.cs index 6360576..ec05eaf 100644 --- a/src/System.Private.CoreLib/shared/System/Collections/Generic/IEnumerator.cs +++ b/src/System.Private.CoreLib/shared/System/Collections/Generic/IEnumerator.cs @@ -16,8 +16,6 @@ namespace System.Collections.Generic // call to MoveNext that returned false. Multiple calls to // GetCurrent with no intervening calls to MoveNext // will return the same object. - // - /// new T Current { get; diff --git a/src/System.Private.CoreLib/shared/System/Convert.Base64.cs b/src/System.Private.CoreLib/shared/System/Convert.Base64.cs index 7e2aee3..332f3b9 100644 --- a/src/System.Private.CoreLib/shared/System/Convert.Base64.cs +++ b/src/System.Private.CoreLib/shared/System/Convert.Base64.cs @@ -20,6 +20,7 @@ namespace System /// The output span which contains the result of the operation, i.e. the decoded binary data. /// The number of input bytes consumed during the operation. This can be used to slice the input for subsequent calls, if necessary. /// The number of bytes written into the output span. This can be used to slice the output for subsequent calls, if necessary. + /// /// Returns: /// - true - The entire input span was successfully parsed. /// - false - Only a part of the input span was successfully parsed. Failure causes may include embedded or trailing whitespace, @@ -29,8 +30,7 @@ namespace System /// /// Note: This is a cut down version of the implementation of Base64.DecodeFromUtf8(), modified the accept UTF16 chars and act as a fast-path /// helper for the Convert routines when the input string contains no whitespace. - /// - /// + /// private static bool TryDecodeFromUtf16(ReadOnlySpan utf16, Span bytes, out int consumed, out int written) { ref char srcChars = ref MemoryMarshal.GetReference(utf16); diff --git a/src/System.Private.CoreLib/shared/System/Decimal.DecCalc.cs b/src/System.Private.CoreLib/shared/System/Decimal.DecCalc.cs index 8b6eb54..ee27231 100644 --- a/src/System.Private.CoreLib/shared/System/Decimal.DecCalc.cs +++ b/src/System.Private.CoreLib/shared/System/Decimal.DecCalc.cs @@ -528,7 +528,7 @@ PosRem: /// Perform needed scaling. Adjust scale factor accordingly. /// /// Array of uints with value, least-significant first - /// Index of last non-zero value in bufRes + /// Index of last non-zero value in bufRes /// Scale factor for this value, range 0 - 2 * DEC_SCALE_MAX /// Returns new scale factor. bufRes updated in place, always 3 uints. private static unsafe int ScaleResult(Buf24* bufRes, uint hiRes, int scale) diff --git a/src/System.Private.CoreLib/shared/System/Diagnostics/Tracing/TraceLogging/InvokeTypeInfo.cs b/src/System.Private.CoreLib/shared/System/Diagnostics/Tracing/TraceLogging/InvokeTypeInfo.cs index 2a7113e..23339f1 100644 --- a/src/System.Private.CoreLib/shared/System/Diagnostics/Tracing/TraceLogging/InvokeTypeInfo.cs +++ b/src/System.Private.CoreLib/shared/System/Diagnostics/Tracing/TraceLogging/InvokeTypeInfo.cs @@ -16,9 +16,6 @@ namespace System.Diagnostics.Tracing /// for arbitrary types. It writes all public instance properties of /// the type. /// - /// - /// Type from which to read values. - /// internal sealed class InvokeTypeInfo : TraceLoggingTypeInfo { internal readonly PropertyAnalysis[] properties; diff --git a/src/System.Private.CoreLib/shared/System/Lazy.cs b/src/System.Private.CoreLib/shared/System/Lazy.cs index 02122ca..78d5c40 100644 --- a/src/System.Private.CoreLib/shared/System/Lazy.cs +++ b/src/System.Private.CoreLib/shared/System/Lazy.cs @@ -218,7 +218,7 @@ namespace System /// /// /// An instance created with this constructor should be usable by multiple threads - // concurrently. + /// concurrently. /// public Lazy(T value) { @@ -499,7 +499,7 @@ namespace System /// /// /// If is false, accessing will force initialization. - /// Please for more information on how will behave if an exception is thrown + /// Please for more information on how will behave if an exception is thrown /// from initialization delegate. /// [DebuggerBrowsable(DebuggerBrowsableState.Never)] diff --git a/src/System.Private.CoreLib/shared/System/Progress.cs b/src/System.Private.CoreLib/shared/System/Progress.cs index 755e771..6ddfc18 100644 --- a/src/System.Private.CoreLib/shared/System/Progress.cs +++ b/src/System.Private.CoreLib/shared/System/Progress.cs @@ -43,7 +43,7 @@ namespace System /// A handler to invoke for each reported progress value. This handler will be invoked /// in addition to any delegates registered with the event. /// Depending on the instance captured by - /// the at construction, it's possible that this handler instance + /// the at construction, it's possible that this handler instance /// could be invoked concurrently with itself. /// /// The is null (Nothing in Visual Basic). diff --git a/src/System.Private.CoreLib/shared/System/ReadOnlySpan.Fast.cs b/src/System.Private.CoreLib/shared/System/ReadOnlySpan.Fast.cs index a24aaa9..b2ce53b 100644 --- a/src/System.Private.CoreLib/shared/System/ReadOnlySpan.Fast.cs +++ b/src/System.Private.CoreLib/shared/System/ReadOnlySpan.Fast.cs @@ -39,7 +39,6 @@ namespace System /// /// The target array. /// Returns default when is null. - /// reference (Nothing in Visual Basic). [MethodImpl(MethodImplOptions.AggressiveInlining)] public ReadOnlySpan(T[] array) { @@ -61,7 +60,6 @@ namespace System /// The index at which to begin the read-only span. /// The number of items in the read-only span. /// Returns default when is null. - /// reference (Nothing in Visual Basic). /// /// Thrown when the specified or end index is not in the range (<0 or >=Length). /// @@ -214,6 +212,7 @@ namespace System } } + /// /// Copies the contents of this read-only span into destination span. If the source /// and destinations overlap, this method behaves as if the original values in /// a temporary location before the destination is overwritten. diff --git a/src/System.Private.CoreLib/shared/System/Runtime/CompilerServices/AsyncIteratorMethodBuilder.cs b/src/System.Private.CoreLib/shared/System/Runtime/CompilerServices/AsyncIteratorMethodBuilder.cs index 7a44155..9b17dfa 100644 --- a/src/System.Private.CoreLib/shared/System/Runtime/CompilerServices/AsyncIteratorMethodBuilder.cs +++ b/src/System.Private.CoreLib/shared/System/Runtime/CompilerServices/AsyncIteratorMethodBuilder.cs @@ -35,7 +35,7 @@ namespace System.Runtime.CompilerServices default; // coreclr's AsyncTaskMethodBuilder.Create just returns default as well #endif - /// Invokes on the state machine while guarding the + /// Invokes on the state machine while guarding the . /// The type of the state machine. /// The state machine instance, passed by reference. [MethodImpl(MethodImplOptions.AggressiveInlining)] diff --git a/src/System.Private.CoreLib/shared/System/Runtime/CompilerServices/TaskAwaiter.cs b/src/System.Private.CoreLib/shared/System/Runtime/CompilerServices/TaskAwaiter.cs index 030278d..ac280b6 100644 --- a/src/System.Private.CoreLib/shared/System/Runtime/CompilerServices/TaskAwaiter.cs +++ b/src/System.Private.CoreLib/shared/System/Runtime/CompilerServices/TaskAwaiter.cs @@ -227,12 +227,8 @@ namespace System.Runtime.CompilerServices #if CORECLR /// Schedules the continuation onto the associated with this . /// The task being awaited. - /// The action to invoke when the await operation completes. + /// The box to invoke when the await operation completes. /// Whether to capture and marshal back to the current context. - /// Whether to flow ExecutionContext across the await. - /// The argument is null (Nothing in Visual Basic). - /// The awaiter was not properly initialized. - /// This method is intended for compiler user rather than use directly in code. internal static void UnsafeOnCompletedInternal(Task task, IAsyncStateMachineBox stateMachineBox, bool continueOnCapturedContext) { Debug.Assert(stateMachineBox != null); diff --git a/src/System.Private.CoreLib/shared/System/Runtime/Intrinsics/Arm/Arm64/Aes.PlatformNotSupported.cs b/src/System.Private.CoreLib/shared/System/Runtime/Intrinsics/Arm/Arm64/Aes.PlatformNotSupported.cs index 0ad9634..ed73e7e 100644 --- a/src/System.Private.CoreLib/shared/System/Runtime/Intrinsics/Arm/Arm64/Aes.PlatformNotSupported.cs +++ b/src/System.Private.CoreLib/shared/System/Runtime/Intrinsics/Arm/Arm64/Aes.PlatformNotSupported.cs @@ -13,25 +13,25 @@ namespace System.Runtime.Intrinsics.Arm.Arm64 public static class Aes { public static bool IsSupported { get { return false; } } - // + /// /// Performs AES single round decryption /// vaesdq_u8 (uint8x16_t data, uint8x16_t key) /// public static Vector128 Decrypt(Vector128 value, Vector128 roundKey) { throw new PlatformNotSupportedException(); } - // + /// /// Performs AES single round encryption /// vaeseq_u8 (uint8x16_t data, uint8x16_t key) /// public static Vector128 Encrypt(Vector128 value, Vector128 roundKey) { throw new PlatformNotSupportedException(); } - // + /// /// Performs AES Mix Columns /// vaesmcq_u8 (uint8x16_t data) /// public static Vector128 MixColumns(Vector128 value) { throw new PlatformNotSupportedException(); } - // + /// /// Performs AES inverse mix columns /// vaesimcq_u8 (uint8x16_t data) /// diff --git a/src/System.Private.CoreLib/shared/System/Runtime/Intrinsics/Arm/Arm64/Sha1.PlatformNotSupported.cs b/src/System.Private.CoreLib/shared/System/Runtime/Intrinsics/Arm/Arm64/Sha1.PlatformNotSupported.cs index 9b6c5aa..f44d281 100644 --- a/src/System.Private.CoreLib/shared/System/Runtime/Intrinsics/Arm/Arm64/Sha1.PlatformNotSupported.cs +++ b/src/System.Private.CoreLib/shared/System/Runtime/Intrinsics/Arm/Arm64/Sha1.PlatformNotSupported.cs @@ -15,37 +15,37 @@ namespace System.Runtime.Intrinsics.Arm.Arm64 public static bool IsSupported { get { return false; } } - // + /// /// Performs SHA1 hash update choose form. /// vsha1cq_u32 (uint32x4_t hash_abcd, uint32_t hash_e, uint32x4_t wk) /// public static Vector128 HashChoose(Vector128 hash_abcd, uint hash_e, Vector128wk) { throw new PlatformNotSupportedException(); } - // + /// /// Performs SHA1 hash update majority form. /// vsha1mq_u32 (uint32x4_t hash_abcd, uint32_t hash_e, uint32x4_t wk) /// public static Vector128 HashMajority(Vector128 hash_abcd, uint hash_e, Vector128wk) { throw new PlatformNotSupportedException(); } - // + /// /// Performs SHA1 hash update parity form. /// vsha1pq_u32 (uint32x4_t hash_abcd, uint32_t hash_e, uint32x4_t wk) /// public static Vector128 HashParity(Vector128 hash_abcd, uint hash_e, Vector128wk) { throw new PlatformNotSupportedException(); } - // + /// /// Performs SHA1 fixed rotate /// vsha1h_u32 (uint32_t hash_e) /// public static uint FixedRotate(uint hash_e) { throw new PlatformNotSupportedException(); } - // + /// /// Performs SHA1 schedule update 0 /// vsha1su0q_u32 (uint32x4_t w0_3, uint32x4_t w4_7, uint32x4_t w8_11) /// public static Vector128 SchedulePart1(Vector128 w0_3, Vector128 w4_7, Vector128 w8_11) { throw new PlatformNotSupportedException(); } - // + /// /// Performs SHA1 schedule update 1 /// vsha1su1q_u32 (uint32x4_t tw0_3, uint32x4_t w12_15) /// diff --git a/src/System.Private.CoreLib/shared/System/Runtime/Intrinsics/Arm/Arm64/Sha256.PlatformNotSupported.cs b/src/System.Private.CoreLib/shared/System/Runtime/Intrinsics/Arm/Arm64/Sha256.PlatformNotSupported.cs index 052a1d2..5aee77e 100644 --- a/src/System.Private.CoreLib/shared/System/Runtime/Intrinsics/Arm/Arm64/Sha256.PlatformNotSupported.cs +++ b/src/System.Private.CoreLib/shared/System/Runtime/Intrinsics/Arm/Arm64/Sha256.PlatformNotSupported.cs @@ -14,25 +14,25 @@ namespace System.Runtime.Intrinsics.Arm.Arm64 { public static bool IsSupported { get { return false; } } - // + /// /// Performs SHA256 hash update (part 1). /// vsha256hq_u32 (uint32x4_t hash_abcd, uint32x4_t hash_efgh, uint32x4_t wk) /// public static Vector128 HashLower(Vector128 hash_abcd, Vector128 hash_efgh, Vector128 wk) { throw new PlatformNotSupportedException(); } - // + /// /// Performs SHA256 hash update (part 2). /// vsha256h2q_u32 (uint32x4_t hash_efgh, uint32x4_t hash_abcd, uint32x4_t wk) /// public static Vector128 HashUpper(Vector128 hash_efgh, Vector128 hash_abcd, Vector128 wk) { throw new PlatformNotSupportedException(); } - // + /// /// Performs SHA256 schedule update 0 /// vsha256su0q_u32 (uint32x4_t w0_3, uint32x4_t w4_7) /// public static Vector128 SchedulePart1(Vector128 w0_3, Vector128 w4_7) { throw new PlatformNotSupportedException(); } - // + /// /// Performs SHA256 schedule update 1 /// vsha256su1q_u32 (uint32x4_t w0_3, uint32x4_t w8_11, uint32x4_t w12_15) /// diff --git a/src/System.Private.CoreLib/shared/System/Runtime/Intrinsics/Arm/Arm64/Simd.PlatformNotSupported.cs b/src/System.Private.CoreLib/shared/System/Runtime/Intrinsics/Arm/Arm64/Simd.PlatformNotSupported.cs index 4b37790..35d1fb5 100644 --- a/src/System.Private.CoreLib/shared/System/Runtime/Intrinsics/Arm/Arm64/Simd.PlatformNotSupported.cs +++ b/src/System.Private.CoreLib/shared/System/Runtime/Intrinsics/Arm/Arm64/Simd.PlatformNotSupported.cs @@ -21,7 +21,7 @@ namespace System.Runtime.Intrinsics.Arm.Arm64 /// /// Vector abs - /// Corresponds to vector forms of ARM64 ABS & FABS + /// Corresponds to vector forms of ARM64 ABS & FABS /// public static Vector64 Abs(Vector64 value) { throw new PlatformNotSupportedException(); } public static Vector64 Abs(Vector64 value) { throw new PlatformNotSupportedException(); } @@ -36,7 +36,7 @@ namespace System.Runtime.Intrinsics.Arm.Arm64 /// /// Vector add - /// Corresponds to vector forms of ARM64 ADD & FADD + /// Corresponds to vector forms of ARM64 ADD & FADD /// public static Vector64 Add(Vector64 left, Vector64 right) where T : struct { throw new PlatformNotSupportedException(); } public static Vector128 Add(Vector128 left, Vector128 right) where T : struct { throw new PlatformNotSupportedException(); } @@ -58,7 +58,7 @@ namespace System.Runtime.Intrinsics.Arm.Arm64 /// /// Vector BitwiseSelect /// For each bit in the vector result[bit] = sel[bit] ? left[bit] : right[bit] - /// Corresponds to vector forms of ARM64 BSL (Also BIF & BIT) + /// Corresponds to vector forms of ARM64 BSL (Also BIF & BIT) /// public static Vector64 BitwiseSelect(Vector64 sel, Vector64 left, Vector64 right) where T : struct { throw new PlatformNotSupportedException(); } public static Vector128 BitwiseSelect(Vector128 sel, Vector128 left, Vector128 right) where T : struct { throw new PlatformNotSupportedException(); } @@ -66,7 +66,7 @@ namespace System.Runtime.Intrinsics.Arm.Arm64 /// /// Vector CompareEqual /// For each element result[elem] = (left[elem] == right[elem]) ? ~0 : 0 - /// Corresponds to vector forms of ARM64 CMEQ & FCMEQ + /// Corresponds to vector forms of ARM64 CMEQ & FCMEQ /// public static Vector64 CompareEqual(Vector64 left, Vector64 right) where T : struct { throw new PlatformNotSupportedException(); } public static Vector128 CompareEqual(Vector128 left, Vector128 right) where T : struct { throw new PlatformNotSupportedException(); } @@ -74,7 +74,7 @@ namespace System.Runtime.Intrinsics.Arm.Arm64 /// /// Vector CompareEqualZero /// For each element result[elem] = (left[elem] == 0) ? ~0 : 0 - /// Corresponds to vector forms of ARM64 CMEQ & FCMEQ + /// Corresponds to vector forms of ARM64 CMEQ & FCMEQ /// public static Vector64 CompareEqualZero(Vector64 value) where T : struct { throw new PlatformNotSupportedException(); } public static Vector128 CompareEqualZero(Vector128 value) where T : struct { throw new PlatformNotSupportedException(); } @@ -82,7 +82,7 @@ namespace System.Runtime.Intrinsics.Arm.Arm64 /// /// Vector CompareGreaterThan /// For each element result[elem] = (left[elem] > right[elem]) ? ~0 : 0 - /// Corresponds to vector forms of ARM64 CMGT/CMHI & FCMGT + /// Corresponds to vector forms of ARM64 CMGT/CMHI & FCMGT /// public static Vector64 CompareGreaterThan(Vector64 left, Vector64 right) where T : struct { throw new PlatformNotSupportedException(); } public static Vector128 CompareGreaterThan(Vector128 left, Vector128 right) where T : struct { throw new PlatformNotSupportedException(); } @@ -90,7 +90,7 @@ namespace System.Runtime.Intrinsics.Arm.Arm64 /// /// Vector CompareGreaterThanZero /// For each element result[elem] = (left[elem] > 0) ? ~0 : 0 - /// Corresponds to vector forms of ARM64 CMGT & FCMGT + /// Corresponds to vector forms of ARM64 CMGT & FCMGT /// public static Vector64 CompareGreaterThanZero(Vector64 value) where T : struct { throw new PlatformNotSupportedException(); } public static Vector128 CompareGreaterThanZero(Vector128 value) where T : struct { throw new PlatformNotSupportedException(); } @@ -98,7 +98,7 @@ namespace System.Runtime.Intrinsics.Arm.Arm64 /// /// Vector CompareGreaterThanOrEqual /// For each element result[elem] = (left[elem] >= right[elem]) ? ~0 : 0 - /// Corresponds to vector forms of ARM64 CMGE/CMHS & FCMGE + /// Corresponds to vector forms of ARM64 CMGE/CMHS & FCMGE /// public static Vector64 CompareGreaterThanOrEqual(Vector64 left, Vector64 right) where T : struct { throw new PlatformNotSupportedException(); } public static Vector128 CompareGreaterThanOrEqual(Vector128 left, Vector128 right) where T : struct { throw new PlatformNotSupportedException(); } @@ -106,30 +106,30 @@ namespace System.Runtime.Intrinsics.Arm.Arm64 /// /// Vector CompareGreaterThanOrEqualZero /// For each element result[elem] = (left[elem] >= 0) ? ~0 : 0 - /// Corresponds to vector forms of ARM64 CMGE & FCMGE + /// Corresponds to vector forms of ARM64 CMGE & FCMGE /// public static Vector64 CompareGreaterThanOrEqualZero(Vector64 value) where T : struct { throw new PlatformNotSupportedException(); } public static Vector128 CompareGreaterThanOrEqualZero(Vector128 value) where T : struct { throw new PlatformNotSupportedException(); } /// /// Vector CompareLessThanZero - /// For each element result[elem] = (left[elem] < 0) ? ~0 : 0 - /// Corresponds to vector forms of ARM64 CMGT & FCMGT + /// For each element result[elem] = (left[elem] < 0) ? ~0 : 0 + /// Corresponds to vector forms of ARM64 CMGT & FCMGT /// public static Vector64 CompareLessThanZero(Vector64 value) where T : struct { throw new PlatformNotSupportedException(); } public static Vector128 CompareLessThanZero(Vector128 value) where T : struct { throw new PlatformNotSupportedException(); } /// /// Vector CompareLessThanOrEqualZero - /// For each element result[elem] = (left[elem] < 0) ? ~0 : 0 - /// Corresponds to vector forms of ARM64 CMGT & FCMGT + /// For each element result[elem] = (left[elem] < 0) ? ~0 : 0 + /// Corresponds to vector forms of ARM64 CMGT & FCMGT /// public static Vector64 CompareLessThanOrEqualZero(Vector64 value) where T : struct { throw new PlatformNotSupportedException(); } public static Vector128 CompareLessThanOrEqualZero(Vector128 value) where T : struct { throw new PlatformNotSupportedException(); } /// /// Vector CompareTest - /// For each element result[elem] = (left[elem] & right[elem]) ? ~0 : 0 + /// For each element result[elem] = (left[elem] & right[elem]) ? ~0 : 0 /// Corresponds to vector forms of ARM64 CMTST /// public static Vector64 CompareTest(Vector64 left, Vector64 right) where T : struct { throw new PlatformNotSupportedException(); } @@ -202,7 +202,7 @@ namespace System.Runtime.Intrinsics.Arm.Arm64 /// /// Vector max - /// Corresponds to vector forms of ARM64 SMAX, UMAX & FMAX + /// Corresponds to vector forms of ARM64 SMAX, UMAX & FMAX /// public static Vector64 Max(Vector64 left, Vector64 right) { throw new PlatformNotSupportedException(); } public static Vector64 Max(Vector64 left, Vector64 right) { throw new PlatformNotSupportedException(); } @@ -222,7 +222,7 @@ namespace System.Runtime.Intrinsics.Arm.Arm64 /// /// Vector min - /// Corresponds to vector forms of ARM64 SMIN, UMIN & FMIN + /// Corresponds to vector forms of ARM64 SMIN, UMIN & FMIN /// public static Vector64 Min(Vector64 left, Vector64 right) { throw new PlatformNotSupportedException(); } public static Vector64 Min(Vector64 left, Vector64 right) { throw new PlatformNotSupportedException(); } @@ -247,7 +247,7 @@ namespace System.Runtime.Intrinsics.Arm.Arm64 /// /// For each element result[elem] = left[elem] * right[elem] /// - /// Corresponds to vector forms of ARM64 MUL & FMUL + /// Corresponds to vector forms of ARM64 MUL & FMUL /// public static Vector64 Multiply(Vector64 left, Vector64 right) { throw new PlatformNotSupportedException(); } public static Vector64 Multiply(Vector64 left, Vector64 right) { throw new PlatformNotSupportedException(); } @@ -267,7 +267,7 @@ namespace System.Runtime.Intrinsics.Arm.Arm64 /// /// Vector negate - /// Corresponds to vector forms of ARM64 NEG & FNEG + /// Corresponds to vector forms of ARM64 NEG & FNEG /// public static Vector64 Negate(Vector64 value) { throw new PlatformNotSupportedException(); } public static Vector64 Negate(Vector64 value) { throw new PlatformNotSupportedException(); } @@ -328,7 +328,7 @@ namespace System.Runtime.Intrinsics.Arm.Arm64 /// /// Vector subtract - /// Corresponds to vector forms of ARM64 SUB & FSUB + /// Corresponds to vector forms of ARM64 SUB & FSUB /// public static Vector64 Subtract(Vector64 left, Vector64 right) where T : struct { throw new PlatformNotSupportedException(); } public static Vector128 Subtract(Vector128 left, Vector128 right) where T : struct { throw new PlatformNotSupportedException(); } diff --git a/src/System.Private.CoreLib/shared/System/Runtime/Intrinsics/Vector128.cs b/src/System.Private.CoreLib/shared/System/Runtime/Intrinsics/Vector128.cs index f8eefb7..41f069f 100644 --- a/src/System.Private.CoreLib/shared/System/Runtime/Intrinsics/Vector128.cs +++ b/src/System.Private.CoreLib/shared/System/Runtime/Intrinsics/Vector128.cs @@ -10,9 +10,9 @@ namespace System.Runtime.Intrinsics { internal const int Size = 16; - /// Creates a new instance with all elements initialized to the specified value. + /// Creates a new instance with all elements initialized to the specified value. /// The value that all elements will be initialized to. - /// A new with all elements initialized to . + /// A new with all elements initialized to . public static unsafe Vector128 Create(byte value) { var pResult = stackalloc byte[16] @@ -38,9 +38,9 @@ namespace System.Runtime.Intrinsics return Unsafe.AsRef>(pResult); } - /// Creates a new instance with all elements initialized to the specified value. + /// Creates a new instance with all elements initialized to the specified value. /// The value that all elements will be initialized to. - /// A new with all elements initialized to . + /// A new with all elements initialized to . public static unsafe Vector128 Create(double value) { var pResult = stackalloc double[2] @@ -52,9 +52,9 @@ namespace System.Runtime.Intrinsics return Unsafe.AsRef>(pResult); } - /// Creates a new instance with all elements initialized to the specified value. + /// Creates a new instance with all elements initialized to the specified value. /// The value that all elements will be initialized to. - /// A new with all elements initialized to . + /// A new with all elements initialized to . public static unsafe Vector128 Create(short value) { var pResult = stackalloc short[8] @@ -72,9 +72,9 @@ namespace System.Runtime.Intrinsics return Unsafe.AsRef>(pResult); } - /// Creates a new instance with all elements initialized to the specified value. + /// Creates a new instance with all elements initialized to the specified value. /// The value that all elements will be initialized to. - /// A new with all elements initialized to . + /// A new with all elements initialized to . public static unsafe Vector128 Create(int value) { var pResult = stackalloc int[4] @@ -88,9 +88,9 @@ namespace System.Runtime.Intrinsics return Unsafe.AsRef>(pResult); } - /// Creates a new instance with all elements initialized to the specified value. + /// Creates a new instance with all elements initialized to the specified value. /// The value that all elements will be initialized to. - /// A new with all elements initialized to . + /// A new with all elements initialized to . public static unsafe Vector128 Create(long value) { var pResult = stackalloc long[2] @@ -102,9 +102,9 @@ namespace System.Runtime.Intrinsics return Unsafe.AsRef>(pResult); } - /// Creates a new instance with all elements initialized to the specified value. + /// Creates a new instance with all elements initialized to the specified value. /// The value that all elements will be initialized to. - /// A new with all elements initialized to . + /// A new with all elements initialized to . [CLSCompliant(false)] public static unsafe Vector128 Create(sbyte value) { @@ -131,9 +131,9 @@ namespace System.Runtime.Intrinsics return Unsafe.AsRef>(pResult); } - /// Creates a new instance with all elements initialized to the specified value. + /// Creates a new instance with all elements initialized to the specified value. /// The value that all elements will be initialized to. - /// A new with all elements initialized to . + /// A new with all elements initialized to . public static unsafe Vector128 Create(float value) { var pResult = stackalloc float[4] @@ -147,9 +147,9 @@ namespace System.Runtime.Intrinsics return Unsafe.AsRef>(pResult); } - /// Creates a new instance with all elements initialized to the specified value. + /// Creates a new instance with all elements initialized to the specified value. /// The value that all elements will be initialized to. - /// A new with all elements initialized to . + /// A new with all elements initialized to . [CLSCompliant(false)] public static unsafe Vector128 Create(ushort value) { @@ -168,9 +168,9 @@ namespace System.Runtime.Intrinsics return Unsafe.AsRef>(pResult); } - /// Creates a new instance with all elements initialized to the specified value. + /// Creates a new instance with all elements initialized to the specified value. /// The value that all elements will be initialized to. - /// A new with all elements initialized to . + /// A new with all elements initialized to . [CLSCompliant(false)] public static unsafe Vector128 Create(uint value) { @@ -185,9 +185,9 @@ namespace System.Runtime.Intrinsics return Unsafe.AsRef>(pResult); } - /// Creates a new instance with all elements initialized to the specified value. + /// Creates a new instance with all elements initialized to the specified value. /// The value that all elements will be initialized to. - /// A new with all elements initialized to . + /// A new with all elements initialized to . [CLSCompliant(false)] public static unsafe Vector128 Create(ulong value) { @@ -200,7 +200,7 @@ namespace System.Runtime.Intrinsics return Unsafe.AsRef>(pResult); } - /// Creates a new instance with each element initialized to the corresponding specified value. + /// Creates a new instance with each element initialized to the corresponding specified value. /// The value that element 0 will be initialized to. /// The value that element 1 will be initialized to. /// The value that element 2 will be initialized to. @@ -217,7 +217,7 @@ namespace System.Runtime.Intrinsics /// The value that element 13 will be initialized to. /// The value that element 14 will be initialized to. /// The value that element 15 will be initialized to. - /// A new with each element initialized to corresponding specified value. + /// A new with each element initialized to corresponding specified value. public static unsafe Vector128 Create(byte e0, byte e1, byte e2, byte e3, byte e4, byte e5, byte e6, byte e7, byte e8, byte e9, byte e10, byte e11, byte e12, byte e13, byte e14, byte e15) { var pResult = stackalloc byte[16] @@ -243,10 +243,10 @@ namespace System.Runtime.Intrinsics return Unsafe.AsRef>(pResult); } - /// Creates a new instance with each element initialized to the corresponding specified value. + /// Creates a new instance with each element initialized to the corresponding specified value. /// The value that element 0 will be initialized to. /// The value that element 1 will be initialized to. - /// A new with each element initialized to corresponding specified value. + /// A new with each element initialized to corresponding specified value. public static unsafe Vector128 Create(double e0, double e1) { var pResult = stackalloc double[2] @@ -258,7 +258,7 @@ namespace System.Runtime.Intrinsics return Unsafe.AsRef>(pResult); } - /// Creates a new instance with each element initialized to the corresponding specified value. + /// Creates a new instance with each element initialized to the corresponding specified value. /// The value that element 0 will be initialized to. /// The value that element 1 will be initialized to. /// The value that element 2 will be initialized to. @@ -267,7 +267,7 @@ namespace System.Runtime.Intrinsics /// The value that element 5 will be initialized to. /// The value that element 6 will be initialized to. /// The value that element 7 will be initialized to. - /// A new with each element initialized to corresponding specified value. + /// A new with each element initialized to corresponding specified value. public static unsafe Vector128 Create(short e0, short e1, short e2, short e3, short e4, short e5, short e6, short e7) { var pResult = stackalloc short[8] @@ -285,12 +285,12 @@ namespace System.Runtime.Intrinsics return Unsafe.AsRef>(pResult); } - /// Creates a new instance with each element initialized to the corresponding specified value. + /// Creates a new instance with each element initialized to the corresponding specified value. /// The value that element 0 will be initialized to. /// The value that element 1 will be initialized to. /// The value that element 2 will be initialized to. /// The value that element 3 will be initialized to. - /// A new with each element initialized to corresponding specified value. + /// A new with each element initialized to corresponding specified value. public static unsafe Vector128 Create(int e0, int e1, int e2, int e3) { var pResult = stackalloc int[4] @@ -304,10 +304,10 @@ namespace System.Runtime.Intrinsics return Unsafe.AsRef>(pResult); } - /// Creates a new instance with each element initialized to the corresponding specified value. + /// Creates a new instance with each element initialized to the corresponding specified value. /// The value that element 0 will be initialized to. /// The value that element 1 will be initialized to. - /// A new with each element initialized to corresponding specified value. + /// A new with each element initialized to corresponding specified value. public static unsafe Vector128 Create(long e0, long e1) { var pResult = stackalloc long[2] @@ -319,7 +319,7 @@ namespace System.Runtime.Intrinsics return Unsafe.AsRef>(pResult); } - /// Creates a new instance with each element initialized to the corresponding specified value. + /// Creates a new instance with each element initialized to the corresponding specified value. /// The value that element 0 will be initialized to. /// The value that element 1 will be initialized to. /// The value that element 2 will be initialized to. @@ -336,7 +336,7 @@ namespace System.Runtime.Intrinsics /// The value that element 13 will be initialized to. /// The value that element 14 will be initialized to. /// The value that element 15 will be initialized to. - /// A new with each element initialized to corresponding specified value. + /// A new with each element initialized to corresponding specified value. [CLSCompliant(false)] public static unsafe Vector128 Create(sbyte e0, sbyte e1, sbyte e2, sbyte e3, sbyte e4, sbyte e5, sbyte e6, sbyte e7, sbyte e8, sbyte e9, sbyte e10, sbyte e11, sbyte e12, sbyte e13, sbyte e14, sbyte e15) { @@ -363,12 +363,12 @@ namespace System.Runtime.Intrinsics return Unsafe.AsRef>(pResult); } - /// Creates a new instance with each element initialized to the corresponding specified value. + /// Creates a new instance with each element initialized to the corresponding specified value. /// The value that element 0 will be initialized to. /// The value that element 1 will be initialized to. /// The value that element 2 will be initialized to. /// The value that element 3 will be initialized to. - /// A new with each element initialized to corresponding specified value. + /// A new with each element initialized to corresponding specified value. public static unsafe Vector128 Create(float e0, float e1, float e2, float e3) { var pResult = stackalloc float[4] @@ -382,7 +382,7 @@ namespace System.Runtime.Intrinsics return Unsafe.AsRef>(pResult); } - /// Creates a new instance with each element initialized to the corresponding specified value. + /// Creates a new instance with each element initialized to the corresponding specified value. /// The value that element 0 will be initialized to. /// The value that element 1 will be initialized to. /// The value that element 2 will be initialized to. @@ -391,7 +391,7 @@ namespace System.Runtime.Intrinsics /// The value that element 5 will be initialized to. /// The value that element 6 will be initialized to. /// The value that element 7 will be initialized to. - /// A new with each element initialized to corresponding specified value. + /// A new with each element initialized to corresponding specified value. [CLSCompliant(false)] public static unsafe Vector128 Create(ushort e0, ushort e1, ushort e2, ushort e3, ushort e4, ushort e5, ushort e6, ushort e7) { @@ -410,12 +410,12 @@ namespace System.Runtime.Intrinsics return Unsafe.AsRef>(pResult); } - /// Creates a new instance with each element initialized to the corresponding specified value. + /// Creates a new instance with each element initialized to the corresponding specified value. /// The value that element 0 will be initialized to. /// The value that element 1 will be initialized to. /// The value that element 2 will be initialized to. /// The value that element 3 will be initialized to. - /// A new with each element initialized to corresponding specified value. + /// A new with each element initialized to corresponding specified value. [CLSCompliant(false)] public static unsafe Vector128 Create(uint e0, uint e1, uint e2, uint e3) { @@ -430,10 +430,10 @@ namespace System.Runtime.Intrinsics return Unsafe.AsRef>(pResult); } - /// Creates a new instance with each element initialized to the corresponding specified value. + /// Creates a new instance with each element initialized to the corresponding specified value. /// The value that element 0 will be initialized to. /// The value that element 1 will be initialized to. - /// A new with each element initialized to corresponding specified value. + /// A new with each element initialized to corresponding specified value. [CLSCompliant(false)] public static unsafe Vector128 Create(ulong e0, ulong e1) { @@ -446,10 +446,10 @@ namespace System.Runtime.Intrinsics return Unsafe.AsRef>(pResult); } - /// Creates a new instance from two instances. + /// Creates a new instance from two instances. /// The value that the lower 64-bits will be initialized to. /// The value that the upper 64-bits will be initialized to. - /// A new initialized from and . + /// A new initialized from and . public static unsafe Vector128 Create(Vector64 lower, Vector64 upper) { Vector128 result128 = Vector128.Zero; @@ -461,10 +461,10 @@ namespace System.Runtime.Intrinsics return result128; } - /// Creates a new instance from two instances. + /// Creates a new instance from two instances. /// The value that the lower 64-bits will be initialized to. /// The value that the upper 64-bits will be initialized to. - /// A new initialized from and . + /// A new initialized from and . public static unsafe Vector128 Create(Vector64 lower, Vector64 upper) { Vector128 result128 = Vector128.Zero; @@ -476,10 +476,10 @@ namespace System.Runtime.Intrinsics return result128; } - /// Creates a new instance from two instances. + /// Creates a new instance from two instances. /// The value that the lower 64-bits will be initialized to. /// The value that the upper 64-bits will be initialized to. - /// A new initialized from and . + /// A new initialized from and . public static unsafe Vector128 Create(Vector64 lower, Vector64 upper) { Vector128 result128 = Vector128.Zero; @@ -491,10 +491,10 @@ namespace System.Runtime.Intrinsics return result128; } - /// Creates a new instance from two instances. + /// Creates a new instance from two instances. /// The value that the lower 64-bits will be initialized to. /// The value that the upper 64-bits will be initialized to. - /// A new initialized from and . + /// A new initialized from and . public static unsafe Vector128 Create(Vector64 lower, Vector64 upper) { Vector128 result128 = Vector128.Zero; @@ -506,10 +506,10 @@ namespace System.Runtime.Intrinsics return result128; } - /// Creates a new instance from two instances. + /// Creates a new instance from two instances. /// The value that the lower 64-bits will be initialized to. /// The value that the upper 64-bits will be initialized to. - /// A new initialized from and . + /// A new initialized from and . public static unsafe Vector128 Create(Vector64 lower, Vector64 upper) { Vector128 result128 = Vector128.Zero; @@ -521,10 +521,10 @@ namespace System.Runtime.Intrinsics return result128; } - /// Creates a new instance from two instances. + /// Creates a new instance from two instances. /// The value that the lower 64-bits will be initialized to. /// The value that the upper 64-bits will be initialized to. - /// A new initialized from and . + /// A new initialized from and . [CLSCompliant(false)] public static unsafe Vector128 Create(Vector64 lower, Vector64 upper) { @@ -537,10 +537,10 @@ namespace System.Runtime.Intrinsics return result128; } - /// Creates a new instance from two instances. + /// Creates a new instance from two instances. /// The value that the lower 64-bits will be initialized to. /// The value that the upper 64-bits will be initialized to. - /// A new initialized from and . + /// A new initialized from and . public static unsafe Vector128 Create(Vector64 lower, Vector64 upper) { Vector128 result128 = Vector128.Zero; @@ -552,10 +552,10 @@ namespace System.Runtime.Intrinsics return result128; } - /// Creates a new instance from two instances. + /// Creates a new instance from two instances. /// The value that the lower 64-bits will be initialized to. /// The value that the upper 64-bits will be initialized to. - /// A new initialized from and . + /// A new initialized from and . [CLSCompliant(false)] public static unsafe Vector128 Create(Vector64 lower, Vector64 upper) { @@ -568,10 +568,10 @@ namespace System.Runtime.Intrinsics return result128; } - /// Creates a new instance from two instances. + /// Creates a new instance from two instances. /// The value that the lower 64-bits will be initialized to. /// The value that the upper 64-bits will be initialized to. - /// A new initialized from and . + /// A new initialized from and . [CLSCompliant(false)] public static unsafe Vector128 Create(Vector64 lower, Vector64 upper) { @@ -584,10 +584,10 @@ namespace System.Runtime.Intrinsics return result128; } - /// Creates a new instance from two instances. + /// Creates a new instance from two instances. /// The value that the lower 64-bits will be initialized to. /// The value that the upper 64-bits will be initialized to. - /// A new initialized from and . + /// A new initialized from and . [CLSCompliant(false)] public static unsafe Vector128 Create(Vector64 lower, Vector64 upper) { @@ -600,9 +600,9 @@ namespace System.Runtime.Intrinsics return result128; } - /// Creates a new instance with the first element initialized to the specified value and the remaining elements initialized to zero. + /// Creates a new instance with the first element initialized to the specified value and the remaining elements initialized to zero. /// The value that element 0 will be initialized to. - /// A new instance with the first element initialized to and the remaining elements initialized to zero. + /// A new instance with the first element initialized to and the remaining elements initialized to zero. public static unsafe Vector128 CreateScalar(byte value) { var result = Vector128.Zero; @@ -610,9 +610,9 @@ namespace System.Runtime.Intrinsics return result; } - /// Creates a new instance with the first element initialized to the specified value and the remaining elements initialized to zero. + /// Creates a new instance with the first element initialized to the specified value and the remaining elements initialized to zero. /// The value that element 0 will be initialized to. - /// A new instance with the first element initialized to and the remaining elements initialized to zero. + /// A new instance with the first element initialized to and the remaining elements initialized to zero. public static unsafe Vector128 CreateScalar(double value) { var result = Vector128.Zero; @@ -620,9 +620,9 @@ namespace System.Runtime.Intrinsics return result; } - /// Creates a new instance with the first element initialized to the specified value and the remaining elements initialized to zero. + /// Creates a new instance with the first element initialized to the specified value and the remaining elements initialized to zero. /// The value that element 0 will be initialized to. - /// A new instance with the first element initialized to and the remaining elements initialized to zero. + /// A new instance with the first element initialized to and the remaining elements initialized to zero. public static unsafe Vector128 CreateScalar(short value) { var result = Vector128.Zero; @@ -630,9 +630,9 @@ namespace System.Runtime.Intrinsics return result; } - /// Creates a new instance with the first element initialized to the specified value and the remaining elements initialized to zero. + /// Creates a new instance with the first element initialized to the specified value and the remaining elements initialized to zero. /// The value that element 0 will be initialized to. - /// A new instance with the first element initialized to and the remaining elements initialized to zero. + /// A new instance with the first element initialized to and the remaining elements initialized to zero. public static unsafe Vector128 CreateScalar(int value) { var result = Vector128.Zero; @@ -640,9 +640,9 @@ namespace System.Runtime.Intrinsics return result; } - /// Creates a new instance with the first element initialized to the specified value and the remaining elements initialized to zero. + /// Creates a new instance with the first element initialized to the specified value and the remaining elements initialized to zero. /// The value that element 0 will be initialized to. - /// A new instance with the first element initialized to and the remaining elements initialized to zero. + /// A new instance with the first element initialized to and the remaining elements initialized to zero. public static unsafe Vector128 CreateScalar(long value) { var result = Vector128.Zero; @@ -650,9 +650,9 @@ namespace System.Runtime.Intrinsics return result; } - /// Creates a new instance with the first element initialized to the specified value and the remaining elements initialized to zero. + /// Creates a new instance with the first element initialized to the specified value and the remaining elements initialized to zero. /// The value that element 0 will be initialized to. - /// A new instance with the first element initialized to and the remaining elements initialized to zero. + /// A new instance with the first element initialized to and the remaining elements initialized to zero. [CLSCompliant(false)] public static unsafe Vector128 CreateScalar(sbyte value) { @@ -661,9 +661,9 @@ namespace System.Runtime.Intrinsics return result; } - /// Creates a new instance with the first element initialized to the specified value and the remaining elements initialized to zero. + /// Creates a new instance with the first element initialized to the specified value and the remaining elements initialized to zero. /// The value that element 0 will be initialized to. - /// A new instance with the first element initialized to and the remaining elements initialized to zero. + /// A new instance with the first element initialized to and the remaining elements initialized to zero. public static unsafe Vector128 CreateScalar(float value) { var result = Vector128.Zero; @@ -671,9 +671,9 @@ namespace System.Runtime.Intrinsics return result; } - /// Creates a new instance with the first element initialized to the specified value and the remaining elements initialized to zero. + /// Creates a new instance with the first element initialized to the specified value and the remaining elements initialized to zero. /// The value that element 0 will be initialized to. - /// A new instance with the first element initialized to and the remaining elements initialized to zero. + /// A new instance with the first element initialized to and the remaining elements initialized to zero. [CLSCompliant(false)] public static unsafe Vector128 CreateScalar(ushort value) { @@ -682,9 +682,9 @@ namespace System.Runtime.Intrinsics return result; } - /// Creates a new instance with the first element initialized to the specified value and the remaining elements initialized to zero. + /// Creates a new instance with the first element initialized to the specified value and the remaining elements initialized to zero. /// The value that element 0 will be initialized to. - /// A new instance with the first element initialized to and the remaining elements initialized to zero. + /// A new instance with the first element initialized to and the remaining elements initialized to zero. [CLSCompliant(false)] public static unsafe Vector128 CreateScalar(uint value) { @@ -693,9 +693,9 @@ namespace System.Runtime.Intrinsics return result; } - /// Creates a new instance with the first element initialized to the specified value and the remaining elements initialized to zero. + /// Creates a new instance with the first element initialized to the specified value and the remaining elements initialized to zero. /// The value that element 0 will be initialized to. - /// A new instance with the first element initialized to and the remaining elements initialized to zero. + /// A new instance with the first element initialized to and the remaining elements initialized to zero. [CLSCompliant(false)] public static unsafe Vector128 CreateScalar(ulong value) { @@ -704,9 +704,9 @@ namespace System.Runtime.Intrinsics return result; } - /// Creates a new instance with the first element initialized to the specified value and the remaining elements left uninitialized. + /// Creates a new instance with the first element initialized to the specified value and the remaining elements left uninitialized. /// The value that element 0 will be initialized to. - /// A new instance with the first element initialized to and the remaining elements left uninitialized. + /// A new instance with the first element initialized to and the remaining elements left uninitialized. public static unsafe Vector128 CreateScalarUnsafe(byte value) { // This relies on us stripping the "init" flag from the ".locals" @@ -717,9 +717,9 @@ namespace System.Runtime.Intrinsics return Unsafe.AsRef>(pResult); } - /// Creates a new instance with the first element initialized to the specified value and the remaining elements left uninitialized. + /// Creates a new instance with the first element initialized to the specified value and the remaining elements left uninitialized. /// The value that element 0 will be initialized to. - /// A new instance with the first element initialized to and the remaining elements left uninitialized. + /// A new instance with the first element initialized to and the remaining elements left uninitialized. public static unsafe Vector128 CreateScalarUnsafe(double value) { // This relies on us stripping the "init" flag from the ".locals" @@ -730,9 +730,9 @@ namespace System.Runtime.Intrinsics return Unsafe.AsRef>(pResult); } - /// Creates a new instance with the first element initialized to the specified value and the remaining elements left uninitialized. + /// Creates a new instance with the first element initialized to the specified value and the remaining elements left uninitialized. /// The value that element 0 will be initialized to. - /// A new instance with the first element initialized to and the remaining elements left uninitialized. + /// A new instance with the first element initialized to and the remaining elements left uninitialized. public static unsafe Vector128 CreateScalarUnsafe(short value) { // This relies on us stripping the "init" flag from the ".locals" @@ -743,9 +743,9 @@ namespace System.Runtime.Intrinsics return Unsafe.AsRef>(pResult); } - /// Creates a new instance with the first element initialized to the specified value and the remaining elements left uninitialized. + /// Creates a new instance with the first element initialized to the specified value and the remaining elements left uninitialized. /// The value that element 0 will be initialized to. - /// A new instance with the first element initialized to and the remaining elements left uninitialized. + /// A new instance with the first element initialized to and the remaining elements left uninitialized. public static unsafe Vector128 CreateScalarUnsafe(int value) { // This relies on us stripping the "init" flag from the ".locals" @@ -756,9 +756,9 @@ namespace System.Runtime.Intrinsics return Unsafe.AsRef>(pResult); } - /// Creates a new instance with the first element initialized to the specified value and the remaining elements left uninitialized. + /// Creates a new instance with the first element initialized to the specified value and the remaining elements left uninitialized. /// The value that element 0 will be initialized to. - /// A new instance with the first element initialized to and the remaining elements left uninitialized. + /// A new instance with the first element initialized to and the remaining elements left uninitialized. public static unsafe Vector128 CreateScalarUnsafe(long value) { // This relies on us stripping the "init" flag from the ".locals" @@ -769,9 +769,9 @@ namespace System.Runtime.Intrinsics return Unsafe.AsRef>(pResult); } - /// Creates a new instance with the first element initialized to the specified value and the remaining elements left uninitialized. + /// Creates a new instance with the first element initialized to the specified value and the remaining elements left uninitialized. /// The value that element 0 will be initialized to. - /// A new instance with the first element initialized to and the remaining elements left uninitialized. + /// A new instance with the first element initialized to and the remaining elements left uninitialized. [CLSCompliant(false)] public static unsafe Vector128 CreateScalarUnsafe(sbyte value) { @@ -783,9 +783,9 @@ namespace System.Runtime.Intrinsics return Unsafe.AsRef>(pResult); } - /// Creates a new instance with the first element initialized to the specified value and the remaining elements left uninitialized. + /// Creates a new instance with the first element initialized to the specified value and the remaining elements left uninitialized. /// The value that element 0 will be initialized to. - /// A new instance with the first element initialized to and the remaining elements left uninitialized. + /// A new instance with the first element initialized to and the remaining elements left uninitialized. public static unsafe Vector128 CreateScalarUnsafe(float value) { // This relies on us stripping the "init" flag from the ".locals" @@ -796,9 +796,9 @@ namespace System.Runtime.Intrinsics return Unsafe.AsRef>(pResult); } - /// Creates a new instance with the first element initialized to the specified value and the remaining elements left uninitialized. + /// Creates a new instance with the first element initialized to the specified value and the remaining elements left uninitialized. /// The value that element 0 will be initialized to. - /// A new instance with the first element initialized to and the remaining elements left uninitialized. + /// A new instance with the first element initialized to and the remaining elements left uninitialized. [CLSCompliant(false)] public static unsafe Vector128 CreateScalarUnsafe(ushort value) { @@ -810,9 +810,9 @@ namespace System.Runtime.Intrinsics return Unsafe.AsRef>(pResult); } - /// Creates a new instance with the first element initialized to the specified value and the remaining elements left uninitialized. + /// Creates a new instance with the first element initialized to the specified value and the remaining elements left uninitialized. /// The value that element 0 will be initialized to. - /// A new instance with the first element initialized to and the remaining elements left uninitialized. + /// A new instance with the first element initialized to and the remaining elements left uninitialized. [CLSCompliant(false)] public static unsafe Vector128 CreateScalarUnsafe(uint value) { @@ -824,9 +824,9 @@ namespace System.Runtime.Intrinsics return Unsafe.AsRef>(pResult); } - /// Creates a new instance with the first element initialized to the specified value and the remaining elements left uninitialized. + /// Creates a new instance with the first element initialized to the specified value and the remaining elements left uninitialized. /// The value that element 0 will be initialized to. - /// A new instance with the first element initialized to and the remaining elements left uninitialized. + /// A new instance with the first element initialized to and the remaining elements left uninitialized. [CLSCompliant(false)] public static unsafe Vector128 CreateScalarUnsafe(ulong value) { diff --git a/src/System.Private.CoreLib/shared/System/Runtime/Intrinsics/Vector128_1.cs b/src/System.Private.CoreLib/shared/System/Runtime/Intrinsics/Vector128_1.cs index da73f87..48b5064 100644 --- a/src/System.Private.CoreLib/shared/System/Runtime/Intrinsics/Vector128_1.cs +++ b/src/System.Private.CoreLib/shared/System/Runtime/Intrinsics/Vector128_1.cs @@ -101,65 +101,65 @@ namespace System.Runtime.Intrinsics return Unsafe.As, Vector128>(ref Unsafe.AsRef(in this)); } - /// Reinterprets the current instance as a new . - /// The current instance reinterpreted as a new . + /// Reinterprets the current instance as a new . + /// The current instance reinterpreted as a new . /// The type of the current instance () is not supported. [Intrinsic] public Vector128 AsByte() => As(); - /// Reinterprets the current instance as a new . - /// The current instance reinterpreted as a new . + /// Reinterprets the current instance as a new . + /// The current instance reinterpreted as a new . /// The type of the current instance () is not supported. [Intrinsic] public Vector128 AsDouble() => As(); - /// Reinterprets the current instance as a new . - /// The current instance reinterpreted as a new . + /// Reinterprets the current instance as a new . + /// The current instance reinterpreted as a new . /// The type of the current instance () is not supported. [Intrinsic] public Vector128 AsInt16() => As(); - /// Reinterprets the current instance as a new . - /// The current instance reinterpreted as a new . + /// Reinterprets the current instance as a new . + /// The current instance reinterpreted as a new . /// The type of the current instance () is not supported. [Intrinsic] public Vector128 AsInt32() => As(); - /// Reinterprets the current instance as a new . - /// The current instance reinterpreted as a new . + /// Reinterprets the current instance as a new . + /// The current instance reinterpreted as a new . /// The type of the current instance () is not supported. [Intrinsic] public Vector128 AsInt64() => As(); - /// Reinterprets the current instance as a new . - /// The current instance reinterpreted as a new . + /// Reinterprets the current instance as a new . + /// The current instance reinterpreted as a new . /// The type of the current instance () is not supported. [Intrinsic] [CLSCompliant(false)] public Vector128 AsSByte() => As(); - /// Reinterprets the current instance as a new . - /// The current instance reinterpreted as a new . + /// Reinterprets the current instance as a new . + /// The current instance reinterpreted as a new . /// The type of the current instance () is not supported. [Intrinsic] public Vector128 AsSingle() => As(); - /// Reinterprets the current instance as a new . - /// The current instance reinterpreted as a new . + /// Reinterprets the current instance as a new . + /// The current instance reinterpreted as a new . /// The type of the current instance () is not supported. [Intrinsic] [CLSCompliant(false)] public Vector128 AsUInt16() => As(); - /// Reinterprets the current instance as a new . - /// The current instance reinterpreted as a new . + /// Reinterprets the current instance as a new . + /// The current instance reinterpreted as a new . /// The type of the current instance () is not supported. [Intrinsic] [CLSCompliant(false)] public Vector128 AsUInt32() => As(); - /// Reinterprets the current instance as a new . - /// The current instance reinterpreted as a new . + /// Reinterprets the current instance as a new . + /// The current instance reinterpreted as a new . /// The type of the current instance () is not supported. [Intrinsic] [CLSCompliant(false)] diff --git a/src/System.Private.CoreLib/shared/System/Runtime/Intrinsics/Vector256.cs b/src/System.Private.CoreLib/shared/System/Runtime/Intrinsics/Vector256.cs index a4f4cd6..6863a86 100644 --- a/src/System.Private.CoreLib/shared/System/Runtime/Intrinsics/Vector256.cs +++ b/src/System.Private.CoreLib/shared/System/Runtime/Intrinsics/Vector256.cs @@ -10,9 +10,9 @@ namespace System.Runtime.Intrinsics { internal const int Size = 32; - /// Creates a new instance with all elements initialized to the specified value. + /// Creates a new instance with all elements initialized to the specified value. /// The value that all elements will be initialized to. - /// A new with all elements initialized to . + /// A new with all elements initialized to . public static unsafe Vector256 Create(byte value) { var pResult = stackalloc byte[32] @@ -54,9 +54,9 @@ namespace System.Runtime.Intrinsics return Unsafe.AsRef>(pResult); } - /// Creates a new instance with all elements initialized to the specified value. + /// Creates a new instance with all elements initialized to the specified value. /// The value that all elements will be initialized to. - /// A new with all elements initialized to . + /// A new with all elements initialized to . public static unsafe Vector256 Create(double value) { var pResult = stackalloc double[4] @@ -70,9 +70,9 @@ namespace System.Runtime.Intrinsics return Unsafe.AsRef>(pResult); } - /// Creates a new instance with all elements initialized to the specified value. + /// Creates a new instance with all elements initialized to the specified value. /// The value that all elements will be initialized to. - /// A new with all elements initialized to . + /// A new with all elements initialized to . public static unsafe Vector256 Create(short value) { var pResult = stackalloc short[16] @@ -98,9 +98,9 @@ namespace System.Runtime.Intrinsics return Unsafe.AsRef>(pResult); } - /// Creates a new instance with all elements initialized to the specified value. + /// Creates a new instance with all elements initialized to the specified value. /// The value that all elements will be initialized to. - /// A new with all elements initialized to . + /// A new with all elements initialized to . public static unsafe Vector256 Create(int value) { var pResult = stackalloc int[8] @@ -118,9 +118,9 @@ namespace System.Runtime.Intrinsics return Unsafe.AsRef>(pResult); } - /// Creates a new instance with all elements initialized to the specified value. + /// Creates a new instance with all elements initialized to the specified value. /// The value that all elements will be initialized to. - /// A new with all elements initialized to . + /// A new with all elements initialized to . public static unsafe Vector256 Create(long value) { var pResult = stackalloc long[4] @@ -134,9 +134,9 @@ namespace System.Runtime.Intrinsics return Unsafe.AsRef>(pResult); } - /// Creates a new instance with all elements initialized to the specified value. + /// Creates a new instance with all elements initialized to the specified value. /// The value that all elements will be initialized to. - /// A new with all elements initialized to . + /// A new with all elements initialized to . [CLSCompliant(false)] public static unsafe Vector256 Create(sbyte value) { @@ -179,9 +179,9 @@ namespace System.Runtime.Intrinsics return Unsafe.AsRef>(pResult); } - /// Creates a new instance with all elements initialized to the specified value. + /// Creates a new instance with all elements initialized to the specified value. /// The value that all elements will be initialized to. - /// A new with all elements initialized to . + /// A new with all elements initialized to . public static unsafe Vector256 Create(float value) { var pResult = stackalloc float[8] @@ -199,9 +199,9 @@ namespace System.Runtime.Intrinsics return Unsafe.AsRef>(pResult); } - /// Creates a new instance with all elements initialized to the specified value. + /// Creates a new instance with all elements initialized to the specified value. /// The value that all elements will be initialized to. - /// A new with all elements initialized to . + /// A new with all elements initialized to . [CLSCompliant(false)] public static unsafe Vector256 Create(ushort value) { @@ -228,9 +228,9 @@ namespace System.Runtime.Intrinsics return Unsafe.AsRef>(pResult); } - /// Creates a new instance with all elements initialized to the specified value. + /// Creates a new instance with all elements initialized to the specified value. /// The value that all elements will be initialized to. - /// A new with all elements initialized to . + /// A new with all elements initialized to . [CLSCompliant(false)] public static unsafe Vector256 Create(uint value) { @@ -249,9 +249,9 @@ namespace System.Runtime.Intrinsics return Unsafe.AsRef>(pResult); } - /// Creates a new instance with all elements initialized to the specified value. + /// Creates a new instance with all elements initialized to the specified value. /// The value that all elements will be initialized to. - /// A new with all elements initialized to . + /// A new with all elements initialized to . [CLSCompliant(false)] public static unsafe Vector256 Create(ulong value) { @@ -266,7 +266,7 @@ namespace System.Runtime.Intrinsics return Unsafe.AsRef>(pResult); } - /// Creates a new instance with each element initialized to the corresponding specified value. + /// Creates a new instance with each element initialized to the corresponding specified value. /// The value that element 0 will be initialized to. /// The value that element 1 will be initialized to. /// The value that element 2 will be initialized to. @@ -299,7 +299,7 @@ namespace System.Runtime.Intrinsics /// The value that element 29 will be initialized to. /// The value that element 30 will be initialized to. /// The value that element 31 will be initialized to. - /// A new with each element initialized to corresponding specified value. + /// A new with each element initialized to corresponding specified value. public static unsafe Vector256 Create(byte e0, byte e1, byte e2, byte e3, byte e4, byte e5, byte e6, byte e7, byte e8, byte e9, byte e10, byte e11, byte e12, byte e13, byte e14, byte e15, byte e16, byte e17, byte e18, byte e19, byte e20, byte e21, byte e22, byte e23, byte e24, byte e25, byte e26, byte e27, byte e28, byte e29, byte e30, byte e31) { var pResult = stackalloc byte[32] @@ -341,12 +341,12 @@ namespace System.Runtime.Intrinsics return Unsafe.AsRef>(pResult); } - /// Creates a new instance with each element initialized to the corresponding specified value. + /// Creates a new instance with each element initialized to the corresponding specified value. /// The value that element 0 will be initialized to. /// The value that element 1 will be initialized to. /// The value that element 2 will be initialized to. /// The value that element 3 will be initialized to. - /// A new with each element initialized to corresponding specified value. + /// A new with each element initialized to corresponding specified value. public static unsafe Vector256 Create(double e0, double e1, double e2, double e3) { var pResult = stackalloc double[4] @@ -360,7 +360,7 @@ namespace System.Runtime.Intrinsics return Unsafe.AsRef>(pResult); } - /// Creates a new instance with each element initialized to the corresponding specified value. + /// Creates a new instance with each element initialized to the corresponding specified value. /// The value that element 0 will be initialized to. /// The value that element 1 will be initialized to. /// The value that element 2 will be initialized to. @@ -377,7 +377,7 @@ namespace System.Runtime.Intrinsics /// The value that element 13 will be initialized to. /// The value that element 14 will be initialized to. /// The value that element 15 will be initialized to. - /// A new with each element initialized to corresponding specified value. + /// A new with each element initialized to corresponding specified value. public static unsafe Vector256 Create(short e0, short e1, short e2, short e3, short e4, short e5, short e6, short e7, short e8, short e9, short e10, short e11, short e12, short e13, short e14, short e15) { var pResult = stackalloc short[16] @@ -403,7 +403,7 @@ namespace System.Runtime.Intrinsics return Unsafe.AsRef>(pResult); } - /// Creates a new instance with each element initialized to the corresponding specified value. + /// Creates a new instance with each element initialized to the corresponding specified value. /// The value that element 0 will be initialized to. /// The value that element 1 will be initialized to. /// The value that element 2 will be initialized to. @@ -412,7 +412,7 @@ namespace System.Runtime.Intrinsics /// The value that element 5 will be initialized to. /// The value that element 6 will be initialized to. /// The value that element 7 will be initialized to. - /// A new with each element initialized to corresponding specified value. + /// A new with each element initialized to corresponding specified value. public static unsafe Vector256 Create(int e0, int e1, int e2, int e3, int e4, int e5, int e6, int e7) { var pResult = stackalloc int[8] @@ -430,12 +430,12 @@ namespace System.Runtime.Intrinsics return Unsafe.AsRef>(pResult); } - /// Creates a new instance with each element initialized to the corresponding specified value. + /// Creates a new instance with each element initialized to the corresponding specified value. /// The value that element 0 will be initialized to. /// The value that element 1 will be initialized to. /// The value that element 2 will be initialized to. /// The value that element 3 will be initialized to. - /// A new with each element initialized to corresponding specified value. + /// A new with each element initialized to corresponding specified value. public static unsafe Vector256 Create(long e0, long e1, long e2, long e3) { var pResult = stackalloc long[4] @@ -449,7 +449,7 @@ namespace System.Runtime.Intrinsics return Unsafe.AsRef>(pResult); } - /// Creates a new instance with each element initialized to the corresponding specified value. + /// Creates a new instance with each element initialized to the corresponding specified value. /// The value that element 0 will be initialized to. /// The value that element 1 will be initialized to. /// The value that element 2 will be initialized to. @@ -482,7 +482,7 @@ namespace System.Runtime.Intrinsics /// The value that element 29 will be initialized to. /// The value that element 30 will be initialized to. /// The value that element 31 will be initialized to. - /// A new with each element initialized to corresponding specified value. + /// A new with each element initialized to corresponding specified value. [CLSCompliant(false)] public static unsafe Vector256 Create(sbyte e0, sbyte e1, sbyte e2, sbyte e3, sbyte e4, sbyte e5, sbyte e6, sbyte e7, sbyte e8, sbyte e9, sbyte e10, sbyte e11, sbyte e12, sbyte e13, sbyte e14, sbyte e15, sbyte e16, sbyte e17, sbyte e18, sbyte e19, sbyte e20, sbyte e21, sbyte e22, sbyte e23, sbyte e24, sbyte e25, sbyte e26, sbyte e27, sbyte e28, sbyte e29, sbyte e30, sbyte e31) { @@ -525,7 +525,7 @@ namespace System.Runtime.Intrinsics return Unsafe.AsRef>(pResult); } - /// Creates a new instance with each element initialized to the corresponding specified value. + /// Creates a new instance with each element initialized to the corresponding specified value. /// The value that element 0 will be initialized to. /// The value that element 1 will be initialized to. /// The value that element 2 will be initialized to. @@ -534,7 +534,7 @@ namespace System.Runtime.Intrinsics /// The value that element 5 will be initialized to. /// The value that element 6 will be initialized to. /// The value that element 7 will be initialized to. - /// A new with each element initialized to corresponding specified value. + /// A new with each element initialized to corresponding specified value. public static unsafe Vector256 Create(float e0, float e1, float e2, float e3, float e4, float e5, float e6, float e7) { var pResult = stackalloc float[8] @@ -552,7 +552,7 @@ namespace System.Runtime.Intrinsics return Unsafe.AsRef>(pResult); } - /// Creates a new instance with each element initialized to the corresponding specified value. + /// Creates a new instance with each element initialized to the corresponding specified value. /// The value that element 0 will be initialized to. /// The value that element 1 will be initialized to. /// The value that element 2 will be initialized to. @@ -569,7 +569,7 @@ namespace System.Runtime.Intrinsics /// The value that element 13 will be initialized to. /// The value that element 14 will be initialized to. /// The value that element 15 will be initialized to. - /// A new with each element initialized to corresponding specified value. + /// A new with each element initialized to corresponding specified value. [CLSCompliant(false)] public static unsafe Vector256 Create(ushort e0, ushort e1, ushort e2, ushort e3, ushort e4, ushort e5, ushort e6, ushort e7, ushort e8, ushort e9, ushort e10, ushort e11, ushort e12, ushort e13, ushort e14, ushort e15) { @@ -596,7 +596,7 @@ namespace System.Runtime.Intrinsics return Unsafe.AsRef>(pResult); } - /// Creates a new instance with each element initialized to the corresponding specified value. + /// Creates a new instance with each element initialized to the corresponding specified value. /// The value that element 0 will be initialized to. /// The value that element 1 will be initialized to. /// The value that element 2 will be initialized to. @@ -605,7 +605,7 @@ namespace System.Runtime.Intrinsics /// The value that element 5 will be initialized to. /// The value that element 6 will be initialized to. /// The value that element 7 will be initialized to. - /// A new with each element initialized to corresponding specified value. + /// A new with each element initialized to corresponding specified value. [CLSCompliant(false)] public static unsafe Vector256 Create(uint e0, uint e1, uint e2, uint e3, uint e4, uint e5, uint e6, uint e7) { @@ -624,12 +624,12 @@ namespace System.Runtime.Intrinsics return Unsafe.AsRef>(pResult); } - /// Creates a new instance with each element initialized to the corresponding specified value. + /// Creates a new instance with each element initialized to the corresponding specified value. /// The value that element 0 will be initialized to. /// The value that element 1 will be initialized to. /// The value that element 2 will be initialized to. /// The value that element 3 will be initialized to. - /// A new with each element initialized to corresponding specified value. + /// A new with each element initialized to corresponding specified value. [CLSCompliant(false)] public static unsafe Vector256 Create(ulong e0, ulong e1, ulong e2, ulong e3) { @@ -644,10 +644,10 @@ namespace System.Runtime.Intrinsics return Unsafe.AsRef>(pResult); } - /// Creates a new instance from two instances. + /// Creates a new instance from two instances. /// The value that the lower 128-bits will be initialized to. /// The value that the upper 128-bits will be initialized to. - /// A new initialized from and . + /// A new initialized from and . public static unsafe Vector256 Create(Vector128 lower, Vector128 upper) { Vector256 result256 = Vector256.Zero; @@ -659,10 +659,10 @@ namespace System.Runtime.Intrinsics return result256; } - /// Creates a new instance from two instances. + /// Creates a new instance from two instances. /// The value that the lower 128-bits will be initialized to. /// The value that the upper 128-bits will be initialized to. - /// A new initialized from and . + /// A new initialized from and . public static unsafe Vector256 Create(Vector128 lower, Vector128 upper) { Vector256 result256 = Vector256.Zero; @@ -674,10 +674,10 @@ namespace System.Runtime.Intrinsics return result256; } - /// Creates a new instance from two instances. + /// Creates a new instance from two instances. /// The value that the lower 128-bits will be initialized to. /// The value that the upper 128-bits will be initialized to. - /// A new initialized from and . + /// A new initialized from and . public static unsafe Vector256 Create(Vector128 lower, Vector128 upper) { Vector256 result256 = Vector256.Zero; @@ -689,10 +689,10 @@ namespace System.Runtime.Intrinsics return result256; } - /// Creates a new instance from two instances. + /// Creates a new instance from two instances. /// The value that the lower 128-bits will be initialized to. /// The value that the upper 128-bits will be initialized to. - /// A new initialized from and . + /// A new initialized from and . public static unsafe Vector256 Create(Vector128 lower, Vector128 upper) { Vector256 result256 = Vector256.Zero; @@ -704,10 +704,10 @@ namespace System.Runtime.Intrinsics return result256; } - /// Creates a new instance from two instances. + /// Creates a new instance from two instances. /// The value that the lower 128-bits will be initialized to. /// The value that the upper 128-bits will be initialized to. - /// A new initialized from and . + /// A new initialized from and . public static unsafe Vector256 Create(Vector128 lower, Vector128 upper) { Vector256 result256 = Vector256.Zero; @@ -719,10 +719,10 @@ namespace System.Runtime.Intrinsics return result256; } - /// Creates a new instance from two instances. + /// Creates a new instance from two instances. /// The value that the lower 128-bits will be initialized to. /// The value that the upper 128-bits will be initialized to. - /// A new initialized from and . + /// A new initialized from and . [CLSCompliant(false)] public static unsafe Vector256 Create(Vector128 lower, Vector128 upper) { @@ -735,10 +735,10 @@ namespace System.Runtime.Intrinsics return result256; } - /// Creates a new instance from two instances. + /// Creates a new instance from two instances. /// The value that the lower 128-bits will be initialized to. /// The value that the upper 128-bits will be initialized to. - /// A new initialized from and . + /// A new initialized from and . public static unsafe Vector256 Create(Vector128 lower, Vector128 upper) { Vector256 result256 = Vector256.Zero; @@ -750,10 +750,10 @@ namespace System.Runtime.Intrinsics return result256; } - /// Creates a new instance from two instances. + /// Creates a new instance from two instances. /// The value that the lower 128-bits will be initialized to. /// The value that the upper 128-bits will be initialized to. - /// A new initialized from and . + /// A new initialized from and . [CLSCompliant(false)] public static unsafe Vector256 Create(Vector128 lower, Vector128 upper) { @@ -766,10 +766,10 @@ namespace System.Runtime.Intrinsics return result256; } - /// Creates a new instance from two instances. + /// Creates a new instance from two instances. /// The value that the lower 128-bits will be initialized to. /// The value that the upper 128-bits will be initialized to. - /// A new initialized from and . + /// A new initialized from and . [CLSCompliant(false)] public static unsafe Vector256 Create(Vector128 lower, Vector128 upper) { @@ -782,10 +782,10 @@ namespace System.Runtime.Intrinsics return result256; } - /// Creates a new instance from two instances. + /// Creates a new instance from two instances. /// The value that the lower 128-bits will be initialized to. /// The value that the upper 128-bits will be initialized to. - /// A new initialized from and . + /// A new initialized from and . [CLSCompliant(false)] public static unsafe Vector256 Create(Vector128 lower, Vector128 upper) { @@ -798,9 +798,9 @@ namespace System.Runtime.Intrinsics return result256; } - /// Creates a new instance with the first element initialized to the specified value and the remaining elements initialized to zero. + /// Creates a new instance with the first element initialized to the specified value and the remaining elements initialized to zero. /// The value that element 0 will be initialized to. - /// A new instance with the first element initialized to and the remaining elements initialized to zero. + /// A new instance with the first element initialized to and the remaining elements initialized to zero. public static unsafe Vector256 CreateScalar(byte value) { var result = Vector256.Zero; @@ -808,9 +808,9 @@ namespace System.Runtime.Intrinsics return result; } - /// Creates a new instance with the first element initialized to the specified value and the remaining elements initialized to zero. + /// Creates a new instance with the first element initialized to the specified value and the remaining elements initialized to zero. /// The value that element 0 will be initialized to. - /// A new instance with the first element initialized to and the remaining elements initialized to zero. + /// A new instance with the first element initialized to and the remaining elements initialized to zero. public static unsafe Vector256 CreateScalar(double value) { var result = Vector256.Zero; @@ -818,9 +818,9 @@ namespace System.Runtime.Intrinsics return result; } - /// Creates a new instance with the first element initialized to the specified value and the remaining elements initialized to zero. + /// Creates a new instance with the first element initialized to the specified value and the remaining elements initialized to zero. /// The value that element 0 will be initialized to. - /// A new instance with the first element initialized to and the remaining elements initialized to zero. + /// A new instance with the first element initialized to and the remaining elements initialized to zero. public static unsafe Vector256 CreateScalar(short value) { var result = Vector256.Zero; @@ -828,9 +828,9 @@ namespace System.Runtime.Intrinsics return result; } - /// Creates a new instance with the first element initialized to the specified value and the remaining elements initialized to zero. + /// Creates a new instance with the first element initialized to the specified value and the remaining elements initialized to zero. /// The value that element 0 will be initialized to. - /// A new instance with the first element initialized to and the remaining elements initialized to zero. + /// A new instance with the first element initialized to and the remaining elements initialized to zero. public static unsafe Vector256 CreateScalar(int value) { var result = Vector256.Zero; @@ -838,9 +838,9 @@ namespace System.Runtime.Intrinsics return result; } - /// Creates a new instance with the first element initialized to the specified value and the remaining elements initialized to zero. + /// Creates a new instance with the first element initialized to the specified value and the remaining elements initialized to zero. /// The value that element 0 will be initialized to. - /// A new instance with the first element initialized to and the remaining elements initialized to zero. + /// A new instance with the first element initialized to and the remaining elements initialized to zero. public static unsafe Vector256 CreateScalar(long value) { var result = Vector256.Zero; @@ -848,9 +848,9 @@ namespace System.Runtime.Intrinsics return result; } - /// Creates a new instance with the first element initialized to the specified value and the remaining elements initialized to zero. + /// Creates a new instance with the first element initialized to the specified value and the remaining elements initialized to zero. /// The value that element 0 will be initialized to. - /// A new instance with the first element initialized to and the remaining elements initialized to zero. + /// A new instance with the first element initialized to and the remaining elements initialized to zero. [CLSCompliant(false)] public static unsafe Vector256 CreateScalar(sbyte value) { @@ -859,9 +859,9 @@ namespace System.Runtime.Intrinsics return result; } - /// Creates a new instance with the first element initialized to the specified value and the remaining elements initialized to zero. + /// Creates a new instance with the first element initialized to the specified value and the remaining elements initialized to zero. /// The value that element 0 will be initialized to. - /// A new instance with the first element initialized to and the remaining elements initialized to zero. + /// A new instance with the first element initialized to and the remaining elements initialized to zero. public static unsafe Vector256 CreateScalar(float value) { var result = Vector256.Zero; @@ -869,9 +869,9 @@ namespace System.Runtime.Intrinsics return result; } - /// Creates a new instance with the first element initialized to the specified value and the remaining elements initialized to zero. + /// Creates a new instance with the first element initialized to the specified value and the remaining elements initialized to zero. /// The value that element 0 will be initialized to. - /// A new instance with the first element initialized to and the remaining elements initialized to zero. + /// A new instance with the first element initialized to and the remaining elements initialized to zero. [CLSCompliant(false)] public static unsafe Vector256 CreateScalar(ushort value) { @@ -880,9 +880,9 @@ namespace System.Runtime.Intrinsics return result; } - /// Creates a new instance with the first element initialized to the specified value and the remaining elements initialized to zero. + /// Creates a new instance with the first element initialized to the specified value and the remaining elements initialized to zero. /// The value that element 0 will be initialized to. - /// A new instance with the first element initialized to and the remaining elements initialized to zero. + /// A new instance with the first element initialized to and the remaining elements initialized to zero. [CLSCompliant(false)] public static unsafe Vector256 CreateScalar(uint value) { @@ -891,9 +891,9 @@ namespace System.Runtime.Intrinsics return result; } - /// Creates a new instance with the first element initialized to the specified value and the remaining elements initialized to zero. + /// Creates a new instance with the first element initialized to the specified value and the remaining elements initialized to zero. /// The value that element 0 will be initialized to. - /// A new instance with the first element initialized to and the remaining elements initialized to zero. + /// A new instance with the first element initialized to and the remaining elements initialized to zero. [CLSCompliant(false)] public static unsafe Vector256 CreateScalar(ulong value) { @@ -902,9 +902,9 @@ namespace System.Runtime.Intrinsics return result; } - /// Creates a new instance with the first element initialized to the specified value and the remaining elements left uninitialized. + /// Creates a new instance with the first element initialized to the specified value and the remaining elements left uninitialized. /// The value that element 0 will be initialized to. - /// A new instance with the first element initialized to and the remaining elements left uninitialized. + /// A new instance with the first element initialized to and the remaining elements left uninitialized. public static unsafe Vector256 CreateScalarUnsafe(byte value) { // This relies on us stripping the "init" flag from the ".locals" @@ -915,9 +915,9 @@ namespace System.Runtime.Intrinsics return Unsafe.AsRef>(pResult); } - /// Creates a new instance with the first element initialized to the specified value and the remaining elements left uninitialized. + /// Creates a new instance with the first element initialized to the specified value and the remaining elements left uninitialized. /// The value that element 0 will be initialized to. - /// A new instance with the first element initialized to and the remaining elements left uninitialized. + /// A new instance with the first element initialized to and the remaining elements left uninitialized. public static unsafe Vector256 CreateScalarUnsafe(double value) { // This relies on us stripping the "init" flag from the ".locals" @@ -928,9 +928,9 @@ namespace System.Runtime.Intrinsics return Unsafe.AsRef>(pResult); } - /// Creates a new instance with the first element initialized to the specified value and the remaining elements left uninitialized. + /// Creates a new instance with the first element initialized to the specified value and the remaining elements left uninitialized. /// The value that element 0 will be initialized to. - /// A new instance with the first element initialized to and the remaining elements left uninitialized. + /// A new instance with the first element initialized to and the remaining elements left uninitialized. public static unsafe Vector256 CreateScalarUnsafe(short value) { // This relies on us stripping the "init" flag from the ".locals" @@ -941,9 +941,9 @@ namespace System.Runtime.Intrinsics return Unsafe.AsRef>(pResult); } - /// Creates a new instance with the first element initialized to the specified value and the remaining elements left uninitialized. + /// Creates a new instance with the first element initialized to the specified value and the remaining elements left uninitialized. /// The value that element 0 will be initialized to. - /// A new instance with the first element initialized to and the remaining elements left uninitialized. + /// A new instance with the first element initialized to and the remaining elements left uninitialized. public static unsafe Vector256 CreateScalarUnsafe(int value) { // This relies on us stripping the "init" flag from the ".locals" @@ -954,9 +954,9 @@ namespace System.Runtime.Intrinsics return Unsafe.AsRef>(pResult); } - /// Creates a new instance with the first element initialized to the specified value and the remaining elements left uninitialized. + /// Creates a new instance with the first element initialized to the specified value and the remaining elements left uninitialized. /// The value that element 0 will be initialized to. - /// A new instance with the first element initialized to and the remaining elements left uninitialized. + /// A new instance with the first element initialized to and the remaining elements left uninitialized. public static unsafe Vector256 CreateScalarUnsafe(long value) { // This relies on us stripping the "init" flag from the ".locals" @@ -967,9 +967,9 @@ namespace System.Runtime.Intrinsics return Unsafe.AsRef>(pResult); } - /// Creates a new instance with the first element initialized to the specified value and the remaining elements left uninitialized. + /// Creates a new instance with the first element initialized to the specified value and the remaining elements left uninitialized. /// The value that element 0 will be initialized to. - /// A new instance with the first element initialized to and the remaining elements left uninitialized. + /// A new instance with the first element initialized to and the remaining elements left uninitialized. [CLSCompliant(false)] public static unsafe Vector256 CreateScalarUnsafe(sbyte value) { @@ -981,9 +981,9 @@ namespace System.Runtime.Intrinsics return Unsafe.AsRef>(pResult); } - /// Creates a new instance with the first element initialized to the specified value and the remaining elements left uninitialized. + /// Creates a new instance with the first element initialized to the specified value and the remaining elements left uninitialized. /// The value that element 0 will be initialized to. - /// A new instance with the first element initialized to and the remaining elements left uninitialized. + /// A new instance with the first element initialized to and the remaining elements left uninitialized. public static unsafe Vector256 CreateScalarUnsafe(float value) { // This relies on us stripping the "init" flag from the ".locals" @@ -994,9 +994,9 @@ namespace System.Runtime.Intrinsics return Unsafe.AsRef>(pResult); } - /// Creates a new instance with the first element initialized to the specified value and the remaining elements left uninitialized. + /// Creates a new instance with the first element initialized to the specified value and the remaining elements left uninitialized. /// The value that element 0 will be initialized to. - /// A new instance with the first element initialized to and the remaining elements left uninitialized. + /// A new instance with the first element initialized to and the remaining elements left uninitialized. [CLSCompliant(false)] public static unsafe Vector256 CreateScalarUnsafe(ushort value) { @@ -1008,9 +1008,9 @@ namespace System.Runtime.Intrinsics return Unsafe.AsRef>(pResult); } - /// Creates a new instance with the first element initialized to the specified value and the remaining elements left uninitialized. + /// Creates a new instance with the first element initialized to the specified value and the remaining elements left uninitialized. /// The value that element 0 will be initialized to. - /// A new instance with the first element initialized to and the remaining elements left uninitialized. + /// A new instance with the first element initialized to and the remaining elements left uninitialized. [CLSCompliant(false)] public static unsafe Vector256 CreateScalarUnsafe(uint value) { @@ -1022,9 +1022,9 @@ namespace System.Runtime.Intrinsics return Unsafe.AsRef>(pResult); } - /// Creates a new instance with the first element initialized to the specified value and the remaining elements left uninitialized. + /// Creates a new instance with the first element initialized to the specified value and the remaining elements left uninitialized. /// The value that element 0 will be initialized to. - /// A new instance with the first element initialized to and the remaining elements left uninitialized. + /// A new instance with the first element initialized to and the remaining elements left uninitialized. [CLSCompliant(false)] public static unsafe Vector256 CreateScalarUnsafe(ulong value) { diff --git a/src/System.Private.CoreLib/shared/System/Runtime/Intrinsics/Vector256_1.cs b/src/System.Private.CoreLib/shared/System/Runtime/Intrinsics/Vector256_1.cs index 3731698..c9ed0e5 100644 --- a/src/System.Private.CoreLib/shared/System/Runtime/Intrinsics/Vector256_1.cs +++ b/src/System.Private.CoreLib/shared/System/Runtime/Intrinsics/Vector256_1.cs @@ -103,65 +103,65 @@ namespace System.Runtime.Intrinsics return Unsafe.As, Vector256>(ref Unsafe.AsRef(in this)); } - /// Reinterprets the current instance as a new . - /// The current instance reinterpreted as a new . + /// Reinterprets the current instance as a new . + /// The current instance reinterpreted as a new . /// The type of the current instance () is not supported. [Intrinsic] public Vector256 AsByte() => As(); - /// Reinterprets the current instance as a new . - /// The current instance reinterpreted as a new . + /// Reinterprets the current instance as a new . + /// The current instance reinterpreted as a new . /// The type of the current instance () is not supported. [Intrinsic] public Vector256 AsDouble() => As(); - /// Reinterprets the current instance as a new . - /// The current instance reinterpreted as a new . + /// Reinterprets the current instance as a new . + /// The current instance reinterpreted as a new . /// The type of the current instance () is not supported. [Intrinsic] public Vector256 AsInt16() => As(); - /// Reinterprets the current instance as a new . - /// The current instance reinterpreted as a new . + /// Reinterprets the current instance as a new . + /// The current instance reinterpreted as a new . /// The type of the current instance () is not supported. [Intrinsic] public Vector256 AsInt32() => As(); - /// Reinterprets the current instance as a new . - /// The current instance reinterpreted as a new . + /// Reinterprets the current instance as a new . + /// The current instance reinterpreted as a new . /// The type of the current instance () is not supported. [Intrinsic] public Vector256 AsInt64() => As(); - /// Reinterprets the current instance as a new . - /// The current instance reinterpreted as a new . + /// Reinterprets the current instance as a new . + /// The current instance reinterpreted as a new . /// The type of the current instance () is not supported. [Intrinsic] [CLSCompliant(false)] public Vector256 AsSByte() => As(); - /// Reinterprets the current instance as a new . - /// The current instance reinterpreted as a new . + /// Reinterprets the current instance as a new . + /// The current instance reinterpreted as a new . /// The type of the current instance () is not supported. [Intrinsic] public Vector256 AsSingle() => As(); - /// Reinterprets the current instance as a new . - /// The current instance reinterpreted as a new . + /// Reinterprets the current instance as a new . + /// The current instance reinterpreted as a new . /// The type of the current instance () is not supported. [Intrinsic] [CLSCompliant(false)] public Vector256 AsUInt16() => As(); - /// Reinterprets the current instance as a new . - /// The current instance reinterpreted as a new . + /// Reinterprets the current instance as a new . + /// The current instance reinterpreted as a new . /// The type of the current instance () is not supported. [Intrinsic] [CLSCompliant(false)] public Vector256 AsUInt32() => As(); - /// Reinterprets the current instance as a new . - /// The current instance reinterpreted as a new . + /// Reinterprets the current instance as a new . + /// The current instance reinterpreted as a new . /// The type of the current instance () is not supported. [Intrinsic] [CLSCompliant(false)] diff --git a/src/System.Private.CoreLib/shared/System/Runtime/Intrinsics/Vector64.cs b/src/System.Private.CoreLib/shared/System/Runtime/Intrinsics/Vector64.cs index aa95c61..2bee6eb 100644 --- a/src/System.Private.CoreLib/shared/System/Runtime/Intrinsics/Vector64.cs +++ b/src/System.Private.CoreLib/shared/System/Runtime/Intrinsics/Vector64.cs @@ -10,9 +10,9 @@ namespace System.Runtime.Intrinsics { internal const int Size = 8; - /// Creates a new instance with all elements initialized to the specified value. + /// Creates a new instance with all elements initialized to the specified value. /// The value that all elements will be initialized to. - /// A new with all elements initialized to . + /// A new with all elements initialized to . public static unsafe Vector64 Create(byte value) { var pResult = stackalloc byte[8] @@ -30,17 +30,17 @@ namespace System.Runtime.Intrinsics return Unsafe.AsRef>(pResult); } - /// Creates a new instance with all elements initialized to the specified value. + /// Creates a new instance with all elements initialized to the specified value. /// The value that all elements will be initialized to. - /// A new with all elements initialized to . + /// A new with all elements initialized to . public static unsafe Vector64 Create(double value) { return Unsafe.As>(ref value); } - /// Creates a new instance with all elements initialized to the specified value. + /// Creates a new instance with all elements initialized to the specified value. /// The value that all elements will be initialized to. - /// A new with all elements initialized to . + /// A new with all elements initialized to . public static unsafe Vector64 Create(short value) { var pResult = stackalloc short[4] @@ -54,9 +54,9 @@ namespace System.Runtime.Intrinsics return Unsafe.AsRef>(pResult); } - /// Creates a new instance with all elements initialized to the specified value. + /// Creates a new instance with all elements initialized to the specified value. /// The value that all elements will be initialized to. - /// A new with all elements initialized to . + /// A new with all elements initialized to . public static unsafe Vector64 Create(int value) { var pResult = stackalloc int[2] @@ -68,17 +68,17 @@ namespace System.Runtime.Intrinsics return Unsafe.AsRef>(pResult); } - /// Creates a new instance with all elements initialized to the specified value. + /// Creates a new instance with all elements initialized to the specified value. /// The value that all elements will be initialized to. - /// A new with all elements initialized to . + /// A new with all elements initialized to . public static unsafe Vector64 Create(long value) { return Unsafe.As>(ref value); } - /// Creates a new instance with all elements initialized to the specified value. + /// Creates a new instance with all elements initialized to the specified value. /// The value that all elements will be initialized to. - /// A new with all elements initialized to . + /// A new with all elements initialized to . [CLSCompliant(false)] public static unsafe Vector64 Create(sbyte value) { @@ -97,9 +97,9 @@ namespace System.Runtime.Intrinsics return Unsafe.AsRef>(pResult); } - /// Creates a new instance with all elements initialized to the specified value. + /// Creates a new instance with all elements initialized to the specified value. /// The value that all elements will be initialized to. - /// A new with all elements initialized to . + /// A new with all elements initialized to . public static unsafe Vector64 Create(float value) { var pResult = stackalloc float[2] @@ -111,9 +111,9 @@ namespace System.Runtime.Intrinsics return Unsafe.AsRef>(pResult); } - /// Creates a new instance with all elements initialized to the specified value. + /// Creates a new instance with all elements initialized to the specified value. /// The value that all elements will be initialized to. - /// A new with all elements initialized to . + /// A new with all elements initialized to . [CLSCompliant(false)] public static unsafe Vector64 Create(ushort value) { @@ -128,9 +128,9 @@ namespace System.Runtime.Intrinsics return Unsafe.AsRef>(pResult); } - /// Creates a new instance with all elements initialized to the specified value. + /// Creates a new instance with all elements initialized to the specified value. /// The value that all elements will be initialized to. - /// A new with all elements initialized to . + /// A new with all elements initialized to . [CLSCompliant(false)] public static unsafe Vector64 Create(uint value) { @@ -143,16 +143,16 @@ namespace System.Runtime.Intrinsics return Unsafe.AsRef>(pResult); } - /// Creates a new instance with all elements initialized to the specified value. + /// Creates a new instance with all elements initialized to the specified value. /// The value that all elements will be initialized to. - /// A new with all elements initialized to . + /// A new with all elements initialized to . [CLSCompliant(false)] public static unsafe Vector64 Create(ulong value) { return Unsafe.As>(ref value); } - /// Creates a new instance with each element initialized to the corresponding specified value. + /// Creates a new instance with each element initialized to the corresponding specified value. /// The value that element 0 will be initialized to. /// The value that element 1 will be initialized to. /// The value that element 2 will be initialized to. @@ -161,7 +161,7 @@ namespace System.Runtime.Intrinsics /// The value that element 5 will be initialized to. /// The value that element 6 will be initialized to. /// The value that element 7 will be initialized to. - /// A new with each element initialized to corresponding specified value. + /// A new with each element initialized to corresponding specified value. public static unsafe Vector64 Create(byte e0, byte e1, byte e2, byte e3, byte e4, byte e5, byte e6, byte e7) { var pResult = stackalloc byte[8] @@ -179,12 +179,12 @@ namespace System.Runtime.Intrinsics return Unsafe.AsRef>(pResult); } - /// Creates a new instance with each element initialized to the corresponding specified value. + /// Creates a new instance with each element initialized to the corresponding specified value. /// The value that element 0 will be initialized to. /// The value that element 1 will be initialized to. /// The value that element 2 will be initialized to. /// The value that element 3 will be initialized to. - /// A new with each element initialized to corresponding specified value. + /// A new with each element initialized to corresponding specified value. public static unsafe Vector64 Create(short e0, short e1, short e2, short e3) { var pResult = stackalloc short[4] @@ -198,10 +198,10 @@ namespace System.Runtime.Intrinsics return Unsafe.AsRef>(pResult); } - /// Creates a new instance with each element initialized to the corresponding specified value. + /// Creates a new instance with each element initialized to the corresponding specified value. /// The value that element 0 will be initialized to. /// The value that element 1 will be initialized to. - /// A new with each element initialized to corresponding specified value. + /// A new with each element initialized to corresponding specified value. public static unsafe Vector64 Create(int e0, int e1) { var pResult = stackalloc int[2] @@ -213,7 +213,7 @@ namespace System.Runtime.Intrinsics return Unsafe.AsRef>(pResult); } - /// Creates a new instance with each element initialized to the corresponding specified value. + /// Creates a new instance with each element initialized to the corresponding specified value. /// The value that element 0 will be initialized to. /// The value that element 1 will be initialized to. /// The value that element 2 will be initialized to. @@ -222,7 +222,7 @@ namespace System.Runtime.Intrinsics /// The value that element 5 will be initialized to. /// The value that element 6 will be initialized to. /// The value that element 7 will be initialized to. - /// A new with each element initialized to corresponding specified value. + /// A new with each element initialized to corresponding specified value. [CLSCompliant(false)] public static unsafe Vector64 Create(sbyte e0, sbyte e1, sbyte e2, sbyte e3, sbyte e4, sbyte e5, sbyte e6, sbyte e7) { @@ -241,10 +241,10 @@ namespace System.Runtime.Intrinsics return Unsafe.AsRef>(pResult); } - /// Creates a new instance with each element initialized to the corresponding specified value. + /// Creates a new instance with each element initialized to the corresponding specified value. /// The value that element 0 will be initialized to. /// The value that element 1 will be initialized to. - /// A new with each element initialized to corresponding specified value. + /// A new with each element initialized to corresponding specified value. public static unsafe Vector64 Create(float e0, float e1) { var pResult = stackalloc float[2] @@ -256,12 +256,12 @@ namespace System.Runtime.Intrinsics return Unsafe.AsRef>(pResult); } - /// Creates a new instance with each element initialized to the corresponding specified value. + /// Creates a new instance with each element initialized to the corresponding specified value. /// The value that element 0 will be initialized to. /// The value that element 1 will be initialized to. /// The value that element 2 will be initialized to. /// The value that element 3 will be initialized to. - /// A new with each element initialized to corresponding specified value. + /// A new with each element initialized to corresponding specified value. [CLSCompliant(false)] public static unsafe Vector64 Create(ushort e0, ushort e1, ushort e2, ushort e3) { @@ -276,10 +276,10 @@ namespace System.Runtime.Intrinsics return Unsafe.AsRef>(pResult); } - /// Creates a new instance with each element initialized to the corresponding specified value. + /// Creates a new instance with each element initialized to the corresponding specified value. /// The value that element 0 will be initialized to. /// The value that element 1 will be initialized to. - /// A new with each element initialized to corresponding specified value. + /// A new with each element initialized to corresponding specified value. [CLSCompliant(false)] public static unsafe Vector64 Create(uint e0, uint e1) { @@ -292,9 +292,9 @@ namespace System.Runtime.Intrinsics return Unsafe.AsRef>(pResult); } - /// Creates a new instance with the first element initialized to the specified value and the remaining elements initialized to zero. + /// Creates a new instance with the first element initialized to the specified value and the remaining elements initialized to zero. /// The value that element 0 will be initialized to. - /// A new instance with the first element initialized to and the remaining elements initialized to zero. + /// A new instance with the first element initialized to and the remaining elements initialized to zero. public static unsafe Vector64 CreateScalar(byte value) { var result = Vector64.Zero; @@ -302,9 +302,9 @@ namespace System.Runtime.Intrinsics return result; } - /// Creates a new instance with the first element initialized to the specified value and the remaining elements initialized to zero. + /// Creates a new instance with the first element initialized to the specified value and the remaining elements initialized to zero. /// The value that element 0 will be initialized to. - /// A new instance with the first element initialized to and the remaining elements initialized to zero. + /// A new instance with the first element initialized to and the remaining elements initialized to zero. public static unsafe Vector64 CreateScalar(short value) { var result = Vector64.Zero; @@ -312,9 +312,9 @@ namespace System.Runtime.Intrinsics return result; } - /// Creates a new instance with the first element initialized to the specified value and the remaining elements initialized to zero. + /// Creates a new instance with the first element initialized to the specified value and the remaining elements initialized to zero. /// The value that element 0 will be initialized to. - /// A new instance with the first element initialized to and the remaining elements initialized to zero. + /// A new instance with the first element initialized to and the remaining elements initialized to zero. public static unsafe Vector64 CreateScalar(int value) { var result = Vector64.Zero; @@ -322,9 +322,9 @@ namespace System.Runtime.Intrinsics return result; } - /// Creates a new instance with the first element initialized to the specified value and the remaining elements initialized to zero. + /// Creates a new instance with the first element initialized to the specified value and the remaining elements initialized to zero. /// The value that element 0 will be initialized to. - /// A new instance with the first element initialized to and the remaining elements initialized to zero. + /// A new instance with the first element initialized to and the remaining elements initialized to zero. [CLSCompliant(false)] public static unsafe Vector64 CreateScalar(sbyte value) { @@ -333,9 +333,9 @@ namespace System.Runtime.Intrinsics return result; } - /// Creates a new instance with the first element initialized to the specified value and the remaining elements initialized to zero. + /// Creates a new instance with the first element initialized to the specified value and the remaining elements initialized to zero. /// The value that element 0 will be initialized to. - /// A new instance with the first element initialized to and the remaining elements initialized to zero. + /// A new instance with the first element initialized to and the remaining elements initialized to zero. public static unsafe Vector64 CreateScalar(float value) { var result = Vector64.Zero; @@ -343,9 +343,9 @@ namespace System.Runtime.Intrinsics return result; } - /// Creates a new instance with the first element initialized to the specified value and the remaining elements initialized to zero. + /// Creates a new instance with the first element initialized to the specified value and the remaining elements initialized to zero. /// The value that element 0 will be initialized to. - /// A new instance with the first element initialized to and the remaining elements initialized to zero. + /// A new instance with the first element initialized to and the remaining elements initialized to zero. [CLSCompliant(false)] public static unsafe Vector64 CreateScalar(ushort value) { @@ -354,9 +354,9 @@ namespace System.Runtime.Intrinsics return result; } - /// Creates a new instance with the first element initialized to the specified value and the remaining elements initialized to zero. + /// Creates a new instance with the first element initialized to the specified value and the remaining elements initialized to zero. /// The value that element 0 will be initialized to. - /// A new instance with the first element initialized to and the remaining elements initialized to zero. + /// A new instance with the first element initialized to and the remaining elements initialized to zero. [CLSCompliant(false)] public static unsafe Vector64 CreateScalar(uint value) { @@ -365,9 +365,9 @@ namespace System.Runtime.Intrinsics return result; } - /// Creates a new instance with the first element initialized to the specified value and the remaining elements left uninitialized. + /// Creates a new instance with the first element initialized to the specified value and the remaining elements left uninitialized. /// The value that element 0 will be initialized to. - /// A new instance with the first element initialized to and the remaining elements left uninitialized. + /// A new instance with the first element initialized to and the remaining elements left uninitialized. public static unsafe Vector64 CreateScalarUnsafe(byte value) { // This relies on us stripping the "init" flag from the ".locals" @@ -378,9 +378,9 @@ namespace System.Runtime.Intrinsics return Unsafe.AsRef>(pResult); } - /// Creates a new instance with the first element initialized to the specified value and the remaining elements left uninitialized. + /// Creates a new instance with the first element initialized to the specified value and the remaining elements left uninitialized. /// The value that element 0 will be initialized to. - /// A new instance with the first element initialized to and the remaining elements left uninitialized. + /// A new instance with the first element initialized to and the remaining elements left uninitialized. public static unsafe Vector64 CreateScalarUnsafe(short value) { // This relies on us stripping the "init" flag from the ".locals" @@ -391,9 +391,9 @@ namespace System.Runtime.Intrinsics return Unsafe.AsRef>(pResult); } - /// Creates a new instance with the first element initialized to the specified value and the remaining elements left uninitialized. + /// Creates a new instance with the first element initialized to the specified value and the remaining elements left uninitialized. /// The value that element 0 will be initialized to. - /// A new instance with the first element initialized to and the remaining elements left uninitialized. + /// A new instance with the first element initialized to and the remaining elements left uninitialized. public static unsafe Vector64 CreateScalarUnsafe(int value) { // This relies on us stripping the "init" flag from the ".locals" @@ -404,9 +404,9 @@ namespace System.Runtime.Intrinsics return Unsafe.AsRef>(pResult); } - /// Creates a new instance with the first element initialized to the specified value and the remaining elements left uninitialized. + /// Creates a new instance with the first element initialized to the specified value and the remaining elements left uninitialized. /// The value that element 0 will be initialized to. - /// A new instance with the first element initialized to and the remaining elements left uninitialized. + /// A new instance with the first element initialized to and the remaining elements left uninitialized. [CLSCompliant(false)] public static unsafe Vector64 CreateScalarUnsafe(sbyte value) { @@ -418,9 +418,9 @@ namespace System.Runtime.Intrinsics return Unsafe.AsRef>(pResult); } - /// Creates a new instance with the first element initialized to the specified value and the remaining elements left uninitialized. + /// Creates a new instance with the first element initialized to the specified value and the remaining elements left uninitialized. /// The value that element 0 will be initialized to. - /// A new instance with the first element initialized to and the remaining elements left uninitialized. + /// A new instance with the first element initialized to and the remaining elements left uninitialized. public static unsafe Vector64 CreateScalarUnsafe(float value) { // This relies on us stripping the "init" flag from the ".locals" @@ -431,9 +431,9 @@ namespace System.Runtime.Intrinsics return Unsafe.AsRef>(pResult); } - /// Creates a new instance with the first element initialized to the specified value and the remaining elements left uninitialized. + /// Creates a new instance with the first element initialized to the specified value and the remaining elements left uninitialized. /// The value that element 0 will be initialized to. - /// A new instance with the first element initialized to and the remaining elements left uninitialized. + /// A new instance with the first element initialized to and the remaining elements left uninitialized. [CLSCompliant(false)] public static unsafe Vector64 CreateScalarUnsafe(ushort value) { @@ -445,9 +445,9 @@ namespace System.Runtime.Intrinsics return Unsafe.AsRef>(pResult); } - /// Creates a new instance with the first element initialized to the specified value and the remaining elements left uninitialized. + /// Creates a new instance with the first element initialized to the specified value and the remaining elements left uninitialized. /// The value that element 0 will be initialized to. - /// A new instance with the first element initialized to and the remaining elements left uninitialized. + /// A new instance with the first element initialized to and the remaining elements left uninitialized. [CLSCompliant(false)] public static unsafe Vector64 CreateScalarUnsafe(uint value) { diff --git a/src/System.Private.CoreLib/shared/System/Runtime/Intrinsics/Vector64_1.cs b/src/System.Private.CoreLib/shared/System/Runtime/Intrinsics/Vector64_1.cs index b190549..f315b67 100644 --- a/src/System.Private.CoreLib/shared/System/Runtime/Intrinsics/Vector64_1.cs +++ b/src/System.Private.CoreLib/shared/System/Runtime/Intrinsics/Vector64_1.cs @@ -99,65 +99,65 @@ namespace System.Runtime.Intrinsics return Unsafe.As, Vector64>(ref Unsafe.AsRef(in this)); } - /// Reinterprets the current instance as a new . - /// The current instance reinterpreted as a new . + /// Reinterprets the current instance as a new . + /// The current instance reinterpreted as a new . /// The type of the current instance () is not supported. [Intrinsic] public Vector64 AsByte() => As(); - /// Reinterprets the current instance as a new . - /// The current instance reinterpreted as a new . + /// Reinterprets the current instance as a new . + /// The current instance reinterpreted as a new . /// The type of the current instance () is not supported. [Intrinsic] public Vector64 AsDouble() => As(); - /// Reinterprets the current instance as a new . - /// The current instance reinterpreted as a new . + /// Reinterprets the current instance as a new . + /// The current instance reinterpreted as a new . /// The type of the current instance () is not supported. [Intrinsic] public Vector64 AsInt16() => As(); - /// Reinterprets the current instance as a new . - /// The current instance reinterpreted as a new . + /// Reinterprets the current instance as a new . + /// The current instance reinterpreted as a new . /// The type of the current instance () is not supported. [Intrinsic] public Vector64 AsInt32() => As(); - /// Reinterprets the current instance as a new . - /// The current instance reinterpreted as a new . + /// Reinterprets the current instance as a new . + /// The current instance reinterpreted as a new . /// The type of the current instance () is not supported. [Intrinsic] public Vector64 AsInt64() => As(); - /// Reinterprets the current instance as a new . - /// The current instance reinterpreted as a new . + /// Reinterprets the current instance as a new . + /// The current instance reinterpreted as a new . /// The type of the current instance () is not supported. [Intrinsic] [CLSCompliant(false)] public Vector64 AsSByte() => As(); - /// Reinterprets the current instance as a new . - /// The current instance reinterpreted as a new . + /// Reinterprets the current instance as a new . + /// The current instance reinterpreted as a new . /// The type of the current instance () is not supported. [Intrinsic] public Vector64 AsSingle() => As(); - /// Reinterprets the current instance as a new . - /// The current instance reinterpreted as a new . + /// Reinterprets the current instance as a new . + /// The current instance reinterpreted as a new . /// The type of the current instance () is not supported. [Intrinsic] [CLSCompliant(false)] public Vector64 AsUInt16() => As(); - /// Reinterprets the current instance as a new . - /// The current instance reinterpreted as a new . + /// Reinterprets the current instance as a new . + /// The current instance reinterpreted as a new . /// The type of the current instance () is not supported. [Intrinsic] [CLSCompliant(false)] public Vector64 AsUInt32() => As(); - /// Reinterprets the current instance as a new . - /// The current instance reinterpreted as a new . + /// Reinterprets the current instance as a new . + /// The current instance reinterpreted as a new . /// The type of the current instance () is not supported. [Intrinsic] [CLSCompliant(false)] diff --git a/src/System.Private.CoreLib/shared/System/Runtime/Intrinsics/X86/Avx2.cs b/src/System.Private.CoreLib/shared/System/Runtime/Intrinsics/X86/Avx2.cs index 9d3f9ef..42139c6 100644 --- a/src/System.Private.CoreLib/shared/System/Runtime/Intrinsics/X86/Avx2.cs +++ b/src/System.Private.CoreLib/shared/System/Runtime/Intrinsics/X86/Avx2.cs @@ -735,7 +735,8 @@ namespace System.Runtime.Intrinsics.X86 /// VEXTRACTI128 xmm, ymm, imm8 /// public new static Vector128 ExtractVector128(Vector256 value, byte index) => ExtractVector128(value, index); - // + + /// /// __m128i _mm256_extracti128_si256 (__m256i a, const int imm8) /// VEXTRACTI128 m128, ymm, imm8 /// diff --git a/src/System.Private.CoreLib/shared/System/Runtime/Intrinsics/X86/Sse2.cs b/src/System.Private.CoreLib/shared/System/Runtime/Intrinsics/X86/Sse2.cs index d9d440a..8b5f4e3 100644 --- a/src/System.Private.CoreLib/shared/System/Runtime/Intrinsics/X86/Sse2.cs +++ b/src/System.Private.CoreLib/shared/System/Runtime/Intrinsics/X86/Sse2.cs @@ -1603,7 +1603,7 @@ namespace System.Runtime.Intrinsics.X86 /// /// __m128i _mm_unpackhi_epi16 (__m128i a, __m128i b) /// PUNPCKHWD xmm, xmm/m128 - /// public static Vector128 UnpackHigh(Vector128 left, Vector128 right) => UnpackHigh(left, right); /// /// __m128i _mm_unpackhi_epi32 (__m128i a, __m128i b) diff --git a/src/System.Private.CoreLib/shared/System/Span.Fast.cs b/src/System.Private.CoreLib/shared/System/Span.Fast.cs index 526987c..490767d 100644 --- a/src/System.Private.CoreLib/shared/System/Span.Fast.cs +++ b/src/System.Private.CoreLib/shared/System/Span.Fast.cs @@ -39,7 +39,6 @@ namespace System /// /// The target array. /// Returns default when is null. - /// reference (Nothing in Visual Basic). /// Thrown when is covariant and array's type is not exactly T[]. [MethodImpl(MethodImplOptions.AggressiveInlining)] public Span(T[] array) @@ -64,7 +63,6 @@ namespace System /// The index at which to begin the span. /// The number of items in the span. /// Returns default when is null. - /// reference (Nothing in Visual Basic). /// Thrown when is covariant and array's type is not exactly T[]. /// /// Thrown when the specified or end index is not in the range (<0 or >=Length). @@ -131,6 +129,7 @@ namespace System _length = length; } + /// /// Returns a reference to specified element of the Span. /// /// diff --git a/src/System.Private.CoreLib/shared/System/Text/Rune.cs b/src/System.Private.CoreLib/shared/System/Text/Rune.cs index 2ed76d1..7de9c2d 100644 --- a/src/System.Private.CoreLib/shared/System/Text/Rune.cs +++ b/src/System.Private.CoreLib/shared/System/Text/Rune.cs @@ -148,7 +148,7 @@ namespace System.Text public int Utf16SequenceLength => UnicodeUtility.GetUtf16SequenceLength(_value); /// - /// Returns the length in code units () of the + /// Returns the length in code units of the /// UTF-8 sequence required to represent this scalar value. /// /// @@ -420,7 +420,7 @@ namespace System.Text /// Encodes this to a destination buffer as UTF-8 bytes. /// /// The buffer to which to write this value as UTF-8. - /// + /// /// The number of s written to , /// or 0 if the destination buffer is not large enough to contain the output. /// True if the value was written to the buffer; otherwise, false. diff --git a/src/System.Private.CoreLib/shared/System/Text/StringBuilder.cs b/src/System.Private.CoreLib/shared/System/Text/StringBuilder.cs index 54218ca..75b7ed6 100644 --- a/src/System.Private.CoreLib/shared/System/Text/StringBuilder.cs +++ b/src/System.Private.CoreLib/shared/System/Text/StringBuilder.cs @@ -562,7 +562,7 @@ namespace System.Text /// thus can be used in a C# 'foreach' statements to retreive the data in the StringBuilder /// as chunks (ReadOnlyMemory) of characters. An example use is: /// - /// foreach (ReadOnlyMemory chunk in sb.GetChunks()) + /// foreach (ReadOnlyMemory<char> chunk in sb.GetChunks()) /// foreach(char c in chunk.Span) /// { /* operation on c } /// @@ -577,10 +577,10 @@ namespace System.Text /// compared to the fetching of the character, so create a local variable for the SPAN /// if you need to use it in a nested for statement. For example /// - /// foreach (ReadOnlyMemory chunk in sb.GetChunks()) + /// foreach (ReadOnlyMemory<char> chunk in sb.GetChunks()) /// { /// var span = chunk.Span; - /// for(int i = 0; i < span.Length; i++) + /// for(int i = 0; i < span.Length; i++) /// { /* operation on span[i] */ } /// } /// @@ -1819,9 +1819,9 @@ namespace System.Text } /// - /// Determines if the contents of this builder are equal to the contents of ReadOnlySpan. + /// Determines if the contents of this builder are equal to the contents of . /// - /// The ReadOnlySpan{char}. + /// The . public bool Equals(ReadOnlySpan span) { if (span.Length != Length) diff --git a/src/System.Private.CoreLib/shared/System/Text/UnicodeUtility.cs b/src/System.Private.CoreLib/shared/System/Text/UnicodeUtility.cs index c1dcefd..e607acd 100644 --- a/src/System.Private.CoreLib/shared/System/Text/UnicodeUtility.cs +++ b/src/System.Private.CoreLib/shared/System/Text/UnicodeUtility.cs @@ -154,9 +154,9 @@ namespace System.Text /// [MethodImpl(MethodImplOptions.AggressiveInlining)] public static bool IsSurrogateCodePoint(uint value) => IsInRangeInclusive(value, 0xD800U, 0xDFFFU); - + /// - /// Returns iff is a valid Unicode code + /// Returns iff is a valid Unicode code /// point, i.e., is in [ U+0000..U+10FFFF ], inclusive. /// [MethodImpl(MethodImplOptions.AggressiveInlining)] diff --git a/src/System.Private.CoreLib/shared/System/Threading/LazyInitializer.cs b/src/System.Private.CoreLib/shared/System/Threading/LazyInitializer.cs index f422ab9..e7928b6 100644 --- a/src/System.Private.CoreLib/shared/System/Threading/LazyInitializer.cs +++ b/src/System.Private.CoreLib/shared/System/Threading/LazyInitializer.cs @@ -153,7 +153,7 @@ namespace System.Threading /// A reference to the target to be initialized. /// A reference to a location tracking whether the target has been initialized. /// A reference to a location containing a mutual exclusive lock. If is null, - /// a new object will be instantiated. + /// a new object will be instantiated. /// /// The initialized object. private static T EnsureInitializedCore(ref T target, ref bool initialized, ref object syncLock) diff --git a/src/System.Private.CoreLib/shared/System/Threading/SemaphoreSlim.cs b/src/System.Private.CoreLib/shared/System/Threading/SemaphoreSlim.cs index 17873b4..081e09d 100644 --- a/src/System.Private.CoreLib/shared/System/Threading/SemaphoreSlim.cs +++ b/src/System.Private.CoreLib/shared/System/Threading/SemaphoreSlim.cs @@ -547,9 +547,6 @@ namespace System.Threading /// A that represents the number of milliseconds /// to wait, or a that represents -1 milliseconds to wait indefinitely. /// - /// - /// The token to observe. - /// /// /// A task that will complete with a result of true if the current thread successfully entered /// the , otherwise with a result of false. @@ -574,6 +571,9 @@ namespace System.Threading /// A that represents the number of milliseconds /// to wait, or a that represents -1 milliseconds to wait indefinitely. /// + /// + /// The token to observe. + /// /// /// A task that will complete with a result of true if the current thread successfully entered /// the , otherwise with a result of false. @@ -711,6 +711,7 @@ namespace System.Threading } /// Performs the asynchronous wait. + /// The asynchronous waiter. /// The timeout. /// The cancellation token. /// The task to return to the caller. diff --git a/src/System.Private.CoreLib/shared/System/Threading/SpinWait.cs b/src/System.Private.CoreLib/shared/System/Threading/SpinWait.cs index 54857c3..ad25253 100644 --- a/src/System.Private.CoreLib/shared/System/Threading/SpinWait.cs +++ b/src/System.Private.CoreLib/shared/System/Threading/SpinWait.cs @@ -103,7 +103,7 @@ namespace System.Threading private int _count; /// - /// Gets the number of times has been called on this instance. + /// Gets the number of times has been called on this instance. /// public int Count { @@ -116,14 +116,14 @@ namespace System.Threading } /// - /// Gets whether the next call to will yield the processor, triggering a + /// Gets whether the next call to will yield the processor, triggering a /// forced context switch. /// - /// Whether the next call to will yield the processor, triggering a + /// Whether the next call to will yield the processor, triggering a /// forced context switch. /// - /// On a single-CPU machine, always yields the processor. On machines with - /// multiple CPUs, may yield after an unspecified number of calls. + /// On a single-CPU machine, always yields the processor. On machines with + /// multiple CPUs, may yield after an unspecified number of calls. /// public bool NextSpinWillYield => _count >= YieldThreshold || PlatformHelper.IsSingleProcessor; @@ -132,7 +132,7 @@ namespace System.Threading /// /// /// This is typically called in a loop, and may change in behavior based on the number of times a - /// has been called thus far on this instance. + /// has been called thus far on this instance. /// public void SpinOnce() { @@ -151,7 +151,7 @@ namespace System.Threading /// /// /// This is typically called in a loop, and may change in behavior based on the number of times a - /// has been called thus far on this instance. + /// has been called thus far on this instance. /// public void SpinOnce(int sleep1Threshold) { @@ -257,8 +257,8 @@ namespace System.Threading /// Resets the spin counter. /// /// - /// This makes and behave as though no calls - /// to had been issued on this instance. If a instance + /// This makes and behave as though no calls + /// to had been issued on this instance. If a instance /// is reused many times, it may be useful to reset it to avoid yielding too soon. /// public void Reset() diff --git a/src/System.Private.CoreLib/shared/System/Threading/Tasks/TaskExtensions.cs b/src/System.Private.CoreLib/shared/System/Threading/Tasks/TaskExtensions.cs index a07033d..6a2b820 100644 --- a/src/System.Private.CoreLib/shared/System/Threading/Tasks/TaskExtensions.cs +++ b/src/System.Private.CoreLib/shared/System/Threading/Tasks/TaskExtensions.cs @@ -29,9 +29,9 @@ namespace System.Threading.Tasks Task.FromCanceled(new CancellationToken(true)); } - /// Creates a proxy that represents the asynchronous operation of a . - /// The to unwrap. - /// A that represents the asynchronous operation of the provided . + /// Creates a proxy that represents the asynchronous operation of a wrapped . + /// The wrapped to unwrap. + /// A that represents the asynchronous operation of the provided wrapped . public static Task Unwrap(this Task> task) { if (task == null) diff --git a/src/System.Private.CoreLib/shared/System/TimeZoneInfo.Win32.cs b/src/System.Private.CoreLib/shared/System/TimeZoneInfo.Win32.cs index a6b583e..a16f6a8 100644 --- a/src/System.Private.CoreLib/shared/System/TimeZoneInfo.Win32.cs +++ b/src/System.Private.CoreLib/shared/System/TimeZoneInfo.Win32.cs @@ -323,7 +323,7 @@ namespace System } /// - /// Helper function for retrieving a TimeZoneInfo object by . + /// Helper function for retrieving a TimeZoneInfo object by time_zone_name. /// This function wraps the logic necessary to keep the private /// SystemTimeZones cache in working order /// @@ -521,7 +521,7 @@ namespace System /// /// Helper function that takes: - /// 1. A string representing a registry key name. + /// 1. A string representing a time_zone_name registry key name. /// 2. A REG_TZI_FORMAT struct containing the default rule. /// 3. An AdjustmentRule[] out-parameter. /// @@ -905,7 +905,7 @@ namespace System } /// - /// Helper function that takes a string representing a registry key name + /// Helper function that takes a string representing a time_zone_name registry key name /// and returns a TimeZoneInfo instance. /// private static TimeZoneInfoResult TryGetTimeZoneFromLocalMachine(string id, out TimeZoneInfo value, out Exception e) diff --git a/src/System.Private.CoreLib/shared/System/TimeZoneInfo.cs b/src/System.Private.CoreLib/shared/System/TimeZoneInfo.cs index e95321d..bbb0c46 100644 --- a/src/System.Private.CoreLib/shared/System/TimeZoneInfo.cs +++ b/src/System.Private.CoreLib/shared/System/TimeZoneInfo.cs @@ -789,7 +789,7 @@ namespace System public override int GetHashCode() => StringComparer.OrdinalIgnoreCase.GetHashCode(_id); /// - /// Returns a ReadOnlyCollection containing all valid TimeZone's + /// Returns a containing all valid TimeZone's /// from the local machine. The entries in the collection are sorted by /// . /// This method does *not* throw TimeZoneNotFoundException or InvalidTimeZoneException. @@ -1831,7 +1831,7 @@ namespace System } /// - /// Helper function for retrieving a TimeZoneInfo object by . + /// Helper function for retrieving a TimeZoneInfo object by time_zone_name. /// /// This function may return null. /// diff --git a/src/System.Private.CoreLib/src/Microsoft/Win32/Win32Native.cs b/src/System.Private.CoreLib/src/Microsoft/Win32/Win32Native.cs index 950537a..c6fc981 100644 --- a/src/System.Private.CoreLib/src/Microsoft/Win32/Win32Native.cs +++ b/src/System.Private.CoreLib/src/Microsoft/Win32/Win32Native.cs @@ -11,7 +11,7 @@ ** ** ===========================================================*/ -/** +/* * Notes to PInvoke users: Getting the syntax exactly correct is crucial, and * more than a little confusing. Here's some guidelines. * @@ -51,7 +51,7 @@ * but your function prototype must use different syntax depending on your * choice. For example, if your native method is prototyped as such: * - * bool GetVersionEx(OSVERSIONINFO & lposvi); + * bool GetVersionEx(OSVERSIONINFO & lposvi); * * * you must use EITHER THIS OR THE NEXT syntax: @@ -76,7 +76,7 @@ * Also note the CharSet.Auto on GetVersionEx - while it does not take a String * as a parameter, the OSVERSIONINFO contains an embedded array of TCHARs, so * the size of the struct varies on different platforms, and there's a - * GetVersionExA & a GetVersionExW. Also, the OSVERSIONINFO struct has a sizeof + * GetVersionExA & a GetVersionExW. Also, the OSVERSIONINFO struct has a sizeof * field so the OS can ensure you've passed in the correctly-sized copy of an * OSVERSIONINFO. You must explicitly set this using Marshal.SizeOf(Object); * diff --git a/src/System.Private.CoreLib/src/System/Diagnostics/Contracts/Contracts.cs b/src/System.Private.CoreLib/src/System/Diagnostics/Contracts/Contracts.cs index 44bb846..d1640aa 100644 --- a/src/System.Private.CoreLib/src/System/Diagnostics/Contracts/Contracts.cs +++ b/src/System.Private.CoreLib/src/System/Diagnostics/Contracts/Contracts.cs @@ -243,7 +243,7 @@ namespace System.Diagnostics.Contracts /// /// Expression to assume will always be true. /// - /// At runtime this is equivalent to an . + /// At runtime this is equivalent to an . /// [Pure] [Conditional("DEBUG")] @@ -262,7 +262,7 @@ namespace System.Diagnostics.Contracts /// Expression to assume will always be true. /// If it is not a constant string literal, then the contract may not be understood by tools. /// - /// At runtime this is equivalent to an . + /// At runtime this is equivalent to an . /// [Pure] [Conditional("DEBUG")] diff --git a/src/System.Private.CoreLib/src/System/Diagnostics/Contracts/ContractsBCL.cs b/src/System.Private.CoreLib/src/System/Diagnostics/Contracts/ContractsBCL.cs index f0c2f07..6d4ae27 100644 --- a/src/System.Private.CoreLib/src/System/Diagnostics/Contracts/ContractsBCL.cs +++ b/src/System.Private.CoreLib/src/System/Diagnostics/Contracts/ContractsBCL.cs @@ -248,9 +248,9 @@ namespace System.Runtime.CompilerServices /// 1. Call any contract hooks (such as listeners to Contract failed events) /// 2. Determine if the listeners deem the failure as handled (then resultFailureMessage should be set to null) /// 3. Produce a localized resultFailureMessage used in advertising the failure subsequently. - /// /// On exit: null if the event was handled and should not trigger a failure. - /// Otherwise, returns the localized failure message + /// Otherwise, returns the localized failure message. + /// [System.Diagnostics.DebuggerNonUserCode] public static string RaiseContractFailedEvent(ContractFailureKind failureKind, string userMessage, string conditionText, Exception innerException) { diff --git a/src/System.Private.CoreLib/src/System/RtType.cs b/src/System.Private.CoreLib/src/System/RtType.cs index 6cce52b..d97036d 100644 --- a/src/System.Private.CoreLib/src/System/RtType.cs +++ b/src/System.Private.CoreLib/src/System/RtType.cs @@ -4532,7 +4532,7 @@ namespace System /// /// Helper to invoke the default (parameterless) constructor. - /// + /// [DebuggerStepThrough] [DebuggerHidden] internal object CreateInstanceDefaultCtor(bool publicOnly, bool skipCheckThis, bool fillCache, bool wrapExceptions) diff --git a/src/System.Private.CoreLib/src/System/Runtime/CompilerServices/AsyncMethodBuilder.cs b/src/System.Private.CoreLib/src/System/Runtime/CompilerServices/AsyncMethodBuilder.cs index e85f89b..df0e141 100644 --- a/src/System.Private.CoreLib/src/System/Runtime/CompilerServices/AsyncMethodBuilder.cs +++ b/src/System.Private.CoreLib/src/System/Runtime/CompilerServices/AsyncMethodBuilder.cs @@ -522,7 +522,6 @@ namespace System.Runtime.CompilerServices /// A strongly-typed box for Task-based async state machines. /// Specifies the type of the state machine. - /// Specifies the type of the Task's result. private class AsyncStateMachineBox : // SOS DumpAsync command depends on this name Task, IAsyncStateMachineBox where TStateMachine : IAsyncStateMachine @@ -530,14 +529,14 @@ namespace System.Runtime.CompilerServices /// Delegate used to invoke on an ExecutionContext when passed an instance of this box type. private static readonly ContextCallback s_callback = s => ((AsyncStateMachineBox)s).StateMachine.MoveNext(); - /// A delegate to the method. + /// A delegate to the method. private Action _moveNextAction; /// The state machine itself. public TStateMachine StateMachine; // mutable struct; do not make this readonly. SOS DumpAsync command depends on this name. /// Captured ExecutionContext with which to invoke ; may be null. public ExecutionContext Context; - /// A delegate to the method. + /// A delegate to the method. public Action MoveNextAction => _moveNextAction ?? (_moveNextAction = new Action(MoveNext)); internal sealed override void ExecuteFromThreadPool(Thread threadPoolThread) => MoveNext(threadPoolThread); @@ -910,7 +909,7 @@ namespace System.Runtime.CompilerServices } /// - /// An interface implemented by all instances, regardless of generics. + /// An interface implemented by all instances, regardless of generics. /// internal interface IAsyncStateMachineBox { @@ -1067,7 +1066,7 @@ namespace System.Runtime.CompilerServices /// the action after that is and after that. To solve this problem we create a 'ContinuationWrapper /// which when invoked just does the original action (the invoke action), but also remembers other information /// (like the action after that (which is also a ContinuationWrapper and thus form a linked list). - // We also store that task if the action is associate with at task. + /// We also store that task if the action is associate with at task. /// private sealed class ContinuationWrapper { diff --git a/src/System.Private.CoreLib/src/System/Runtime/InteropServices/Marshal.cs b/src/System.Private.CoreLib/src/System/Runtime/InteropServices/Marshal.cs index e77cdbc..eeef8eb 100644 --- a/src/System.Private.CoreLib/src/System/Runtime/InteropServices/Marshal.cs +++ b/src/System.Private.CoreLib/src/System/Runtime/InteropServices/Marshal.cs @@ -1767,7 +1767,7 @@ namespace System.Runtime.InteropServices /// NativeLibrary Loader: Simple API /// This method is a wrapper around OS loader, using "default" flags. /// - /// The name of the native library to be loaded + /// The name of the native library to be loaded /// The handle for the loaded native library /// If libraryPath is null /// If the library can't be found. @@ -1783,7 +1783,7 @@ namespace System.Runtime.InteropServices /// /// NativeLibrary Loader: Simple API that doesn't throw /// - /// The name of the native library to be loaded + /// The name of the native library to be loaded /// The out-parameter for the loaded native library handle /// True on successful load, false otherwise /// If libraryPath is null @@ -1807,8 +1807,8 @@ namespace System.Runtime.InteropServices /// * AssemblyLoadContext.LoadUnmanagedDll() /// /// The name of the native library to be loaded - /// The search path /// The assembly loading the native library + /// The search path /// The handle for the loaded library /// If libraryPath or assembly is null /// If assembly is not a RuntimeAssembly @@ -1834,7 +1834,7 @@ namespace System.Runtime.InteropServices /// NativeLibrary Loader: High-level API that doesn't throw. /// /// The name of the native library to be loaded - /// The search path + /// The search path /// The assembly loading the native library /// The out-parameter for the loaded native library handle /// True on successful load, false otherwise diff --git a/src/System.Private.CoreLib/src/System/Threading/CancellationTokenSource.cs b/src/System.Private.CoreLib/src/System/Threading/CancellationTokenSource.cs index d0656c3..de9faa5 100644 --- a/src/System.Private.CoreLib/src/System/Threading/CancellationTokenSource.cs +++ b/src/System.Private.CoreLib/src/System/Threading/CancellationTokenSource.cs @@ -17,7 +17,7 @@ namespace System.Threading /// token may have cancellation requested by calling to the source's method. /// /// - /// All members of this class, except , are thread-safe and may be used + /// All members of this class, except , are thread-safe and may be used /// concurrently from multiple threads. /// /// @@ -908,7 +908,7 @@ namespace System.Threading public readonly CancellationTokenSource Source; /// Lock that protects all state in the partition. public SpinLock Lock = new SpinLock(enableThreadOwnerTracking: false); // mutable struct; do not make this readonly - /// Doubly-linked list of callbacks registered with the partition. Callbacks are removed during unregistration and as they're invoked. + /// Doubly-linked list of callbacks registered with the partition. Callbacks are removed during unregistration and as they're invoked. public CallbackNode Callbacks; /// Singly-linked list of free nodes that can be used for subsequent callback registrations. public CallbackNode FreeNodeList; diff --git a/src/System.Private.CoreLib/src/System/Threading/ClrThreadPoolBoundHandle.cs b/src/System.Private.CoreLib/src/System/Threading/ClrThreadPoolBoundHandle.cs index ea03087..56e0814 100644 --- a/src/System.Private.CoreLib/src/System/Threading/ClrThreadPoolBoundHandle.cs +++ b/src/System.Private.CoreLib/src/System/Threading/ClrThreadPoolBoundHandle.cs @@ -239,7 +239,7 @@ namespace System.Threading /// /// Returns the user-provided object specified when the instance was - /// allocated using the . + /// allocated using the . /// /// /// An unmanaged pointer to the structure from which to return the diff --git a/src/System.Private.CoreLib/src/System/Threading/Tasks/FutureFactory.cs b/src/System.Private.CoreLib/src/System/Threading/Tasks/FutureFactory.cs index 378f1e0..775c12f 100644 --- a/src/System.Private.CoreLib/src/System/Threading/Tasks/FutureFactory.cs +++ b/src/System.Private.CoreLib/src/System/Threading/Tasks/FutureFactory.cs @@ -1227,7 +1227,7 @@ namespace System.Threading.Tasks /// and delegate allocations. /// /// Specifies the type of the instance on which the APM implementation lives. - /// Specifies the type containing the arguments. + /// Specifies the type containing the arguments. /// The instance from which the begin and end methods are invoked. /// The begin method. /// The end method. @@ -1326,10 +1326,6 @@ namespace System.Threading.Tasks /// The target instance on which the end method should be called. /// The end method to call to retrieve the result. /// The IAsyncResult for the async operation. - /// - /// Whether completing the task requires synchronization. This should be true - /// unless absolutely sure that the task has not yet been handed out to any consumers. - /// internal void Complete( TInstance thisRef, Func endMethod, IAsyncResult asyncResult, bool requiresSynchronization) diff --git a/src/System.Private.CoreLib/src/System/Threading/Tasks/ProducerConsumerQueues.cs b/src/System.Private.CoreLib/src/System/Threading/Tasks/ProducerConsumerQueues.cs index bd71595..1880288 100644 --- a/src/System.Private.CoreLib/src/System/Threading/Tasks/ProducerConsumerQueues.cs +++ b/src/System.Private.CoreLib/src/System/Threading/Tasks/ProducerConsumerQueues.cs @@ -357,7 +357,7 @@ namespace System.Threading.Tasks private readonly SingleProducerSingleConsumerQueue m_queue; /// Initializes the debug view. - /// The queue being debugged. + /// The queue being debugged. public SingleProducerSingleConsumerQueue_DebugView(SingleProducerSingleConsumerQueue queue) { Debug.Assert(queue != null, "Expected a non-null queue."); diff --git a/src/System.Private.CoreLib/src/System/Threading/Tasks/TPLETWProvider.cs b/src/System.Private.CoreLib/src/System/Threading/Tasks/TPLETWProvider.cs index 9981020..93931f5 100644 --- a/src/System.Private.CoreLib/src/System/Threading/Tasks/TPLETWProvider.cs +++ b/src/System.Private.CoreLib/src/System/Threading/Tasks/TPLETWProvider.cs @@ -320,9 +320,10 @@ namespace System.Threading.Tasks /// The task ID. /// The task ID. /// Configured behavior for the wait. - /// If known, if 'TaskID' has a 'continueWith' task, mention give its ID here. - /// 0 means unknown. This allows better visualization of the common sequential chaining case. - /// + /// + /// If known, if 'TaskID' has a 'continueWith' task, mention give its ID here. + /// 0 means unknown. This allows better visualization of the common sequential chaining case. + /// [Event(TASKWAITBEGIN_ID, Version = 3, Task = TplEtwProvider.Tasks.TaskWait, Opcode = EventOpcode.Send, Level = EventLevel.Informational, Keywords = Keywords.TaskTransfer | Keywords.Tasks)] public void TaskWaitBegin( @@ -383,8 +384,6 @@ namespace System.Threading.Tasks /// /// Fired when the work (method) associated with a TaskWaitEnd completes /// - /// The scheduler ID. - /// The task ID. /// The task ID. [Event(TASKWAITCONTINUATIONCOMPLETE_ID, Level = EventLevel.Verbose, Keywords = Keywords.TaskStops)] @@ -398,8 +397,6 @@ namespace System.Threading.Tasks /// /// Fired when the work (method) associated with a TaskWaitEnd completes /// - /// The scheduler ID. - /// The task ID. /// The task ID. [Event(TASKWAITCONTINUATIONSTARTED_ID, Level = EventLevel.Verbose, Keywords = Keywords.TaskStops)] @@ -415,7 +412,6 @@ namespace System.Threading.Tasks /// /// The scheduler ID. /// The task ID. - /// The activityId for the continuation. [Event(AWAITTASKCONTINUATIONSCHEDULED_ID, Task = Tasks.AwaitTaskContinuationScheduled, Opcode = EventOpcode.Send, Level = EventLevel.Informational, Keywords = Keywords.TaskTransfer | Keywords.Tasks)] public void AwaitTaskContinuationScheduled( diff --git a/src/System.Private.CoreLib/src/System/Threading/Tasks/Task.cs b/src/System.Private.CoreLib/src/System/Threading/Tasks/Task.cs index 7db6cdb..4b9ccc6 100644 --- a/src/System.Private.CoreLib/src/System/Threading/Tasks/Task.cs +++ b/src/System.Private.CoreLib/src/System/Threading/Tasks/Task.cs @@ -1266,7 +1266,7 @@ namespace System.Threading.Tasks /// Gets the Task instance currently executing if the specified creation options /// contain AttachedToParent. /// - /// The options to check. + /// The options to check. /// The current task if there is one and if AttachToParent is in the options; otherwise, null. internal static Task InternalCurrentIfAttached(TaskCreationOptions creationOptions) { @@ -5100,7 +5100,6 @@ namespace System.Threading.Tasks } /// Creates a that's completed exceptionally with the specified exception. - /// The type of the result returned by the task. /// The exception with which to complete the task. /// The faulted task. public static Task FromException(Exception exception) @@ -6633,7 +6632,7 @@ namespace System.Threading.Tasks } /// Transfer the completion status from "task" to ourself. - /// The source task whose results should be transfered to . + /// The source task whose results should be transfered to this. /// Whether or not to look for OperationCanceledExceptions in task's exceptions if it faults. /// true if the transfer was successful; otherwise, false. private bool TrySetFromTask(Task task, bool lookForOce) diff --git a/src/System.Private.CoreLib/src/System/Threading/Tasks/TaskContinuation.cs b/src/System.Private.CoreLib/src/System/Threading/Tasks/TaskContinuation.cs index e8eb1b9..504ecce 100644 --- a/src/System.Private.CoreLib/src/System/Threading/Tasks/TaskContinuation.cs +++ b/src/System.Private.CoreLib/src/System/Threading/Tasks/TaskContinuation.cs @@ -223,7 +223,7 @@ namespace System.Threading.Tasks { /// Inlines or schedules the continuation. /// The antecedent task that has completed. - /// true if inlining is permitted; otherwise, false. + /// true if inlining is permitted; otherwise, false. internal abstract void Run(Task completedTask, bool bCanInlineContinuationTask); /// Tries to run the task on the current thread, if possible; otherwise, schedules it. @@ -395,7 +395,7 @@ namespace System.Threading.Tasks } /// Inlines or schedules the continuation. - /// The antecedent task, which is ignored. + /// The antecedent task, which is ignored. /// true if inlining is permitted; otherwise, false. internal sealed override void Run(Task task, bool canInlineContinuationTask) { @@ -565,7 +565,7 @@ namespace System.Threading.Tasks } /// Inlines or schedules the continuation onto the default scheduler. - /// The antecedent task, which is ignored. + /// The antecedent task, which is ignored. /// true if inlining is permitted; otherwise, false. internal override void Run(Task task, bool canInlineContinuationTask) { @@ -809,6 +809,7 @@ namespace System.Threading.Tasks /// Schedules the action to be executed. No ExecutionContext work is performed used. /// The action to invoke or queue. + /// The task scheduling the action. internal static void UnsafeScheduleAction(Action action, Task task) { AwaitTaskContinuation atc = new AwaitTaskContinuation(action, flowExecutionContext: false); diff --git a/src/System.Private.CoreLib/src/System/Threading/Tasks/future.cs b/src/System.Private.CoreLib/src/System/Threading/Tasks/future.cs index 77e032f..29309c6 100644 --- a/src/System.Private.CoreLib/src/System/Threading/Tasks/future.cs +++ b/src/System.Private.CoreLib/src/System/Threading/Tasks/future.cs @@ -1466,6 +1466,7 @@ namespace System.Threading.Tasks #endregion +#if SUPPORT_IOBSERVABLE /// /// Subscribes an to receive notification of the final state of this . /// @@ -1480,7 +1481,6 @@ namespace System.Threading.Tasks /// /// The argument is null. /// -#if SUPPORT_IOBSERVABLE IDisposable IObservable.Subscribe(IObserver observer) { if (observer == null) -- 2.7.4