Merge branch 'master' into gazeCS

Author: azchohfi

.editorconfig

@@ -323,5 +323,5 @@ dotnet_diagnostic.SA1634.severity = none
 dotnet_diagnostic.SA1652.severity = none
 
 dotnet_diagnostic.SA1629.severity = none # DocumentationTextMustEndWithAPeriod: Let's enable this rule back when we shift to WinUI3 (v8.x). If we do it now, it would mean more than 400 file changes.
-dotnet_diagnostic.SA1413.severity = none # UseTrailingCommasInMultiLineInitializers: This would also mean a lot of changes at the end of all multiline intializers. It's also debatable if we want this or not.
+dotnet_diagnostic.SA1413.severity = none # UseTrailingCommasInMultiLineInitializers: This would also mean a lot of changes at the end of all multiline initializers. It's also debatable if we want this or not.
 dotnet_diagnostic.SA1314.severity = none # TypeParameterNamesMustBeginWithT: We do have a few templates that don't start with T. We need to double check that changing this is not a breaking change. If not, we can re-enable this.

GazeInputTest/MainPage.xaml

@@ -43,7 +43,7 @@
             </ToggleButton>
             <ProgressBar Grid.Row="1" x:Name="ProgressShow" Maximum="100" />
         </Grid>
-        <TextBlock Grid.Row="2" Grid.Column="0" x:Name="DeviceAvailable"  Text="Device availablility not yet detected"/>
+        <TextBlock Grid.Row="2" Grid.Column="0" x:Name="DeviceAvailable"  Text="Device availability not yet detected"/>
         <Grid Grid.Row="2" Grid.Column="1">
             <Grid.ColumnDefinitions>
                 <ColumnDefinition/>

Microsoft.Toolkit.HighPerformance/Buffers/MemoryBufferWriter{T}.cs

@@ -11,7 +11,7 @@
 namespace Microsoft.Toolkit.HighPerformance.Buffers
 {
     /// <summary>
-    /// Represents an utput sink into which <typeparamref name="T"/> data can be written, backed by a <see cref="Memory{T}"/> instance.
+    /// Represents an output sink into which <typeparamref name="T"/> data can be written, backed by a <see cref="Memory{T}"/> instance.
     /// </summary>
     /// <typeparam name="T">The type of items to write to the current instance.</typeparam>
     /// <remarks>

Microsoft.Toolkit.HighPerformance/Extensions/ReadOnlySpanExtensions.cs

@@ -99,7 +99,7 @@ public static ref readonly T DangerousGetLookupReferenceAt<T>(this ReadOnlySpan<
             // The result is then negated, producing the value 0xFFFFFFFF
             // for valid indices, or 0 otherwise. The generated mask
             // is then combined with the original index. This leaves
-            // the index intact if it was valid, otherwise zeroes it.
+            // the index intact if it was valid, otherwise zeros it.
             // The computed offset is finally used to access the
             // lookup table, and it is guaranteed to never go out of
             // bounds unless the input span was just empty, which for a

Microsoft.Toolkit.HighPerformance/Helpers/BitHelper.cs

@@ -54,7 +54,7 @@ public static bool HasFlag(uint value, int n)
         /// decrement the input parameter <paramref name="x"/> to ensure that the range of accepted
         /// values fits within the available 32 bits of the lookup table in use.
         /// For more info on this optimization technique, see <see href="https://egorbo.com/llvm-range-checks.html"/>.
-        /// Here is how the code from the lik above would be implemented using this method:
+        /// Here is how the code from the link above would be implemented using this method:
         /// <code>
         /// bool IsReservedCharacter(char c)
         /// {

Microsoft.Toolkit.HighPerformance/Helpers/Internals/SpanHelper.Hash.cs

@@ -105,7 +105,7 @@ public static unsafe int GetDjb2LikeByteHash(ref byte r0, IntPtr length)
             // and the final loop to combine the partial hash values.
             // Note that even when we use the vectorized path we don't need to do
             // any preprocessing to try to get memory aligned, as that would cause
-            // the hashcodes to potentially be different for the same data.
+            // the hash codes to potentially be different for the same data.
             if (Vector.IsHardwareAccelerated &&
                 (byte*)length >= (byte*)(Vector<byte>.Count << 3))
             {

Microsoft.Toolkit.HighPerformance/NullableRef{T}.cs

@@ -59,7 +59,7 @@ public bool HasValue
             get
             {
                 // We know that the span will always have a length of either
-                // 1 or 0, se instead of using a cmp instruction and setting the
+                // 1 or 0, so instead of using a cmp instruction and setting the
                 // zero flag to produce our boolean value, we can just cast
                 // the length to byte without overflow checks (doing a cast will
                 // also account for the byte endianness of the current system),

Microsoft.Toolkit.Parsers/Markdown/Blocks/CodeBlock.cs

@@ -27,7 +27,7 @@ public CodeBlock()
         public string Text { get; set; }
 
         /// <summary>
-        /// Gets or sets the Language specified in prefix, e.g. ```c# (Github Style Parsing).<para/>
+        /// Gets or sets the Language specified in prefix, e.g. ```c# (GitHub Style Parsing).<para/>
         /// This does not guarantee that the Code Block has a language, or no language, some valid code might not have been prefixed, and this will still return null. <para/>
         /// To ensure all Code is Highlighted (If desired), you might have to determine the language from the provided string, such as looking for key words.
         /// </summary>

Microsoft.Toolkit.Parsers/Rss/BaseRssParser.cs

@@ -9,7 +9,7 @@
 namespace Microsoft.Toolkit.Parsers.Rss
 {
     /// <summary>
-    /// Base class for Rss Parser(s).
+    /// Base class for RSS Parser(s).
     /// </summary>
     internal abstract class BaseRssParser
     {

Microsoft.Toolkit.Parsers/Rss/Enums/RssType.cs

@@ -5,7 +5,7 @@
 namespace Microsoft.Toolkit.Parsers.Rss
 {
     /// <summary>
-    /// Type of Rss.
+    /// Type of RSS.
     /// </summary>
     internal enum RssType
     {

Microsoft.Toolkit.Parsers/Rss/Rss2Parser.cs

@@ -11,7 +11,7 @@
 namespace Microsoft.Toolkit.Parsers.Rss
 {
     /// <summary>
-    /// Rss reader implementation to parse Rss content.
+    /// RSS reader implementation to parse RSS content.
     /// </summary>
     internal class Rss2Parser : BaseRssParser
     {

Microsoft.Toolkit.Parsers/Rss/RssHelper.cs

@@ -13,7 +13,7 @@
 namespace Microsoft.Toolkit.Parsers.Rss
 {
     /// <summary>
-    /// Class with utilities for Rss related works.
+    /// Class with utilities for RSS related works.
     /// </summary>
     internal static class RssHelper
     {

Microsoft.Toolkit.Services/PlatformSpecific/Uwp/UwpSignatureManager.cs

@@ -11,7 +11,7 @@
 namespace Microsoft.Toolkit.Services.PlatformSpecific.Uwp
 {
     /// <summary>
-    /// Uwp specific signature generator using cryptographic library
+    /// UWP specific signature generator using cryptographic library
     /// </summary>
     internal class UwpSignatureManager : ISignatureManager
     {

Microsoft.Toolkit.Services/PlatformSpecific/Uwp/UwpStorageManager.cs

@@ -11,7 +11,7 @@
 namespace Microsoft.Toolkit.Services.PlatformSpecific.Uwp
 {
     /// <summary>
-    /// Uwp specific implementation for IStorageManager using ApplicationData and LocalSettings
+    /// UWP specific implementation for IStorageManager using ApplicationData and LocalSettings
     /// </summary>
     internal class UwpStorageManager : IStorageManager
     {

Microsoft.Toolkit.Services/Services/LinkedIn/LinkedInService.cs

@@ -113,7 +113,7 @@ public Task LogoutAsync()
 
 #if WINRT
         /// <summary>
-        /// Initialize underlying provider with relevant token information for Uwp.
+        /// Initialize underlying provider with relevant token information for UWP.
         /// </summary>
         /// <param name="oAuthTokens">Token instance.</param>
         /// <param name="requiredPermissions">Scope / permissions app requires user to sign up for.</param>
@@ -138,7 +138,7 @@ public bool Initialize(string clientId, string clientSecret, string callbackUri)
 
 #if NET462
         /// <summary>
-        /// Initialize underlying provider with relevant token information for Uwp.
+        /// Initialize underlying provider with relevant token information for UWP.
         /// </summary>
         /// <param name="oAuthTokens">Token instance.</param>
         /// <param name="requiredPermissions">Scope / permissions app requires user to sign up for.</param>

Microsoft.Toolkit.Services/Services/Twitter/TwitterService.cs

@@ -151,7 +151,7 @@ public bool Initialize(TwitterOAuthTokens oAuthTokens, IAuthenticationBroker aut
 
 #if WINRT
         /// <summary>
-        /// Initialize underlying provider with relevant token information for Uwp.
+        /// Initialize underlying provider with relevant token information for UWP.
         /// </summary>
         /// <param name="consumerKey">Consumer key.</param>
         /// <param name="consumerSecret">Consumer secret.</param>
@@ -175,7 +175,7 @@ public bool Initialize(TwitterOAuthTokens oAuthTokens)
 
 #if NET462
         /// <summary>
-        /// Initialize underlying provider with relevant token information for Uwp.
+        /// Initialize underlying provider with relevant token information for UWP.
         /// </summary>
         /// <param name="consumerKey">Consumer key.</param>
         /// <param name="consumerSecret">Consumer secret.</param>

Microsoft.Toolkit.Services/Services/Weibo/WeiboService.cs

@@ -136,7 +136,7 @@ public bool Initialize(WeiboOAuthTokens oAuthTokens, IAuthenticationBroker authe
 
 #if WINRT
         /// <summary>
-        /// Initialize underlying provider with relevant token information for Uwp.
+        /// Initialize underlying provider with relevant token information for UWP.
         /// </summary>
         /// <param name="appKey">App key.</param>
         /// <param name="appSecret">App secret.</param>

Microsoft.Toolkit.Uwp.Connectivity/BluetoothLEHelper/GattNativeUuid.cs

@@ -633,7 +633,7 @@ public enum GattNativeUuid : ushort
         PositionQuality = 0x2A69,
 
         /// <summary>
-        /// The scientific temperature in celsius
+        /// The scientific temperature in Celsius
         /// </summary>
         ScientificTemperatureInCelsius = 0x2A3C,
 
@@ -648,12 +648,12 @@ public enum GattNativeUuid : ushort
         String = 0x2A3D,
 
         /// <summary>
-        /// The temperature in celsius
+        /// The temperature in Celsius
         /// </summary>
         TemperatureInCelsius = 0x2A1F,
 
         /// <summary>
-        /// The temperature in fahrenheit
+        /// The temperature in Fahrenheit
         /// </summary>
         TemperatureInFahrenheit = 0x2A20,
 

Microsoft.Toolkit.Uwp.Input.GazeInteraction/GazeInput.cs

@@ -231,7 +231,7 @@ public static TimeSpan GetFixationDuration(UIElement element)
         }
 
         /// <summary>
-        /// Gets the duration for the control to transition from the Fixation state to the Dwell state. At this point, a StateChanged event is fired with PointerState set to Dwell. The Enter and Fixation states are typicaly achieved too rapidly for the user to have much control over. In contrast Dwell is conscious event. This is the point at which the control is invoked, e.g. a button click. The application can modify this property to control when a gaze enabled UI element gets invoked after a user starts looking at it.
+        /// Gets the duration for the control to transition from the Fixation state to the Dwell state. At this point, a StateChanged event is fired with PointerState set to Dwell. The Enter and Fixation states are typically achieved too rapidly for the user to have much control over. In contrast Dwell is conscious event. This is the point at which the control is invoked, e.g. a button click. The application can modify this property to control when a gaze enabled UI element gets invoked after a user starts looking at it.
         /// </summary>
         /// <returns>The duration for the control to transition from the Fixation state to the Dwell state.</returns>
         public static TimeSpan GetDwellDuration(UIElement element)
@@ -325,7 +325,7 @@ public static void SetFixationDuration(UIElement element, TimeSpan span)
         }
 
         /// <summary>
-        /// Sets the duration for the control to transition from the Fixation state to the Dwell state. At this point, a StateChanged event is fired with PointerState set to Dwell. The Enter and Fixation states are typicaly achieved too rapidly for the user to have much control over. In contrast Dwell is conscious event. This is the point at which the control is invoked, e.g. a button click. The application can modify this property to control when a gaze enabled UI element gets invoked after a user starts looking at it.
+        /// Sets the duration for the control to transition from the Fixation state to the Dwell state. At this point, a StateChanged event is fired with PointerState set to Dwell. The Enter and Fixation states are typically achieved too rapidly for the user to have much control over. In contrast Dwell is conscious event. This is the point at which the control is invoked, e.g. a button click. The application can modify this property to control when a gaze enabled UI element gets invoked after a user starts looking at it.
         /// </summary>
         public static void SetDwellDuration(UIElement element, TimeSpan span)
         {

Microsoft.Toolkit.Uwp.Input.GazeInteraction/GazePointer.cs

@@ -546,8 +546,8 @@ private GazeTargetItem GetHitTarget(Point gazePoint)
 
         private GazeTargetItem ResolveHitTarget(Point gazePoint, TimeSpan timestamp)
         {
-            // TODO: The existance of a GazeTargetItem should be used to indicate that
-            // the target item is invokable. The method of invokation should be stored
+            // TODO: The existence of a GazeTargetItem should be used to indicate that
+            // the target item is invokable. The method of invocation should be stored
             // within the GazeTargetItem when it is created and not recalculated when
             // subsequently needed.
 

Microsoft.Toolkit.Uwp.Input.GazeInteraction/IGazeFilter.cs

@@ -6,7 +6,7 @@
 
 namespace Microsoft.Toolkit.Uwp.Input.GazeInteraction
 {
-    // Every filter must provide an Wpdate method which transforms sample data
+    // Every filter must provide an Update method which transforms sample data
     // and returns filtered output
     internal interface IGazeFilter
     {

Microsoft.Toolkit.Uwp.Input.GazeInteraction/PointerState.cs

@@ -34,7 +34,7 @@ public enum PointerState
         Fixation = 3,
 
         /// <summary>
-        /// User is conciously dwelling on the control with an intent to invoke, e.g. click a button
+        /// User is consciously dwelling on the control with an intent to invoke, e.g. click a button
         /// </summary>
         Dwell = 4,
 

Microsoft.Toolkit.Uwp.Notifications/Adaptive/BaseTextHelper.cs

@@ -8,12 +8,12 @@ namespace Microsoft.Toolkit.Uwp.Notifications
 {
     internal class BaseTextHelper
     {
-        internal static Element_AdaptiveText CreateBaseElement(IBaseText baseText)
+        internal static Element_AdaptiveText CreateBaseElement(IBaseText current)
         {
             return new Element_AdaptiveText()
             {
-                Text = baseText.Text,
-                Lang = baseText.Language
+                Text = current.Text,
+                Lang = current.Language
             };
         }
     }

Microsoft.Toolkit.Uwp.Notifications/Adaptive/BindableValues/BindableProgressBarValue.cs

@@ -80,7 +80,7 @@ public static implicit operator AdaptiveProgressBarValue(BindableProgressBarValu
         }
 
         /// <summary>
-        /// Creates an <see cref="BindableProgressBarValue"/> that has tbe raw double value.
+        /// Creates an <see cref="BindableProgressBarValue"/> that has the raw double value.
         /// </summary>
         /// <param name="d">The raw value</param>
         public static implicit operator BindableProgressBarValue(double d)

Microsoft.Toolkit.Uwp.Notifications/Tiles/Elements/Element_TileBinding.cs

@@ -61,7 +61,7 @@ public Element_TileBinding(TileTemplateNameV3 template)
         public string DisplayName { get; set; }
 
         /// <summary>
-        /// Gets or sets the target locale of the XML payload, specified as a BCP-47 language tags such as "en-US" or "fr-FR". The locale specified here overrides that in visual, but can be overriden by that in text. If this value is a literal string, this attribute defaults to the user's UI language. If this value is a string reference, this attribute defaults to the locale chosen by Windows Runtime in resolving the string. See Remarks for when this value isn't specified.
+        /// Gets or sets the target locale of the XML payload, specified as a BCP-47 language tags such as "en-US" or "fr-FR". The locale specified here overrides that in visual, but can be overridden by that in text. If this value is a literal string, this attribute defaults to the user's UI language. If this value is a string reference, this attribute defaults to the locale chosen by Windows Runtime in resolving the string. See Remarks for when this value isn't specified.
         /// </summary>
         [NotificationXmlAttribute("lang")]
         public string Language { get; set; }

Microsoft.Toolkit.Uwp.Notifications/Tiles/SpecialTemplates/TileBindingContentPhotos.cs

@@ -7,12 +7,12 @@
 namespace Microsoft.Toolkit.Uwp.Notifications
 {
     /// <summary>
-    /// Animates through a slideshow of photos. Supported on all sizes.
+    /// Animates through a slide show of photos. Supported on all sizes.
     /// </summary>
     public sealed class TileBindingContentPhotos : ITileBindingContent
     {
         /// <summary>
-        /// Gets the collection of slideshow images. Up to 12 images can be provided (Mobile will only display up to 9), which will be used for the slideshow. Adding more than 12 will throw an exception.
+        /// Gets the collection of slide show images. Up to 12 images can be provided (Mobile will only display up to 9), which will be used for the slide show. Adding more than 12 will throw an exception.
         /// </summary>
         public IList<TileBasicImage> Images { get; private set; } = new LimitedList<TileBasicImage>(12);
 

Microsoft.Toolkit.Uwp.Notifications/Tiles/TileBinding.cs

@@ -12,7 +12,7 @@ namespace Microsoft.Toolkit.Uwp.Notifications
     public sealed class TileBinding
     {
         /// <summary>
-        /// Gets or sets the target locale of the XML payload, specified as a BCP-47 language tags such as "en-US" or "fr-FR". The locale specified here overrides that in visual, but can be overriden by that in text. If this value is a literal string, this attribute defaults to the user's UI language. If this value is a string reference, this attribute defaults to the locale chosen by Windows Runtime in resolving the string. See Remarks for when this value isn't specified.
+        /// Gets or sets the target locale of the XML payload, specified as a BCP-47 language tags such as "en-US" or "fr-FR". The locale specified here overrides that in visual, but can be overridden by that in text. If this value is a literal string, this attribute defaults to the user's UI language. If this value is a string reference, this attribute defaults to the locale chosen by Windows Runtime in resolving the string. See Remarks for when this value isn't specified.
         /// </summary>
         public string Language { get; set; }
 

Microsoft.Toolkit.Uwp.Notifications/Tiles/TileVisual.cs

@@ -111,7 +111,7 @@ private static bool TryReuseTextElementForLockDetailedText(int lineNumber, strin
                 throw new ArgumentNullException("binding cannot be null");
             }
 
-            // If a text element already has an id with the line number (only look at immediate children, since the lockscreen will ignore things under groups/subgroups)
+            // If a text element already has an id with the line number (only look at immediate children, since the lock screen will ignore things under groups/subgroups)
             Element_AdaptiveText matchingIdTextElement = binding.Children.OfType<Element_AdaptiveText>().FirstOrDefault(i => i.Id != null && i.Id.Equals(lineNumber.ToString()));
 
             if (matchingIdTextElement != null)

Microsoft.Toolkit.Uwp.Notifications/Toasts/Elements/Element_ToastBinding.cs

@@ -37,7 +37,7 @@ public Element_ToastBinding(ToastTemplateType template)
         public Uri BaseUri { get; set; }
 
         /// <summary>
-        /// Gets or sets the target locale of the XML payload, specified as a BCP-47 language tags such as "en-US" or "fr-FR". The locale specified here overrides that in visual, but can be overriden by that in text. If this value is a literal string, this attribute defaults to the user's UI language. If this value is a string reference, this attribute defaults to the locale chosen by Windows Runtime in resolving the string. See Remarks for when this value isn't specified.
+        /// Gets or sets the target locale of the XML payload, specified as a BCP-47 language tags such as "en-US" or "fr-FR". The locale specified here overrides that in visual, but can be overridden by that in text. If this value is a literal string, this attribute defaults to the user's UI language. If this value is a string reference, this attribute defaults to the locale chosen by Windows Runtime in resolving the string. See Remarks for when this value isn't specified.
         /// </summary>
         [NotificationXmlAttribute("lang")]
         public string Language { get; set; }