IntelliSense fixes (#3797)

mairaw · web-flow · commit 9d4430731a2f · 2020-01-23T18:19:03.000-08:00
* IntelliSense fixes

* fix markdown links

* fix markdown links

* fix xref

* remove markdown syntax

* fix markdown link

* remove exception from class

* remove exception from class

* fix tag

* more fixes
diff --git a/xml/System.IO/Path.xml b/xml/System.IO/Path.xml
@@ -1513,7 +1513,7 @@ For more information on file paths on Windows, see [File path formats on Windows
 
  -or-
  
-<see cref="P:System.String.Empty" /> if <paramref name="path" /> does not contain root directory information.
+<see cref="F:System.String.Empty" /> if <paramref name="path" /> does not contain root directory information.
 
  -or-
  
diff --git a/xml/System.Reflection.Metadata.Ecma335/SignatureTypeEncoder.xml b/xml/System.Reflection.Metadata.Ecma335/SignatureTypeEncoder.xml
@@ -819,7 +819,7 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>Encodes a void pointer (<code>void*</code>).</summary>
+        <summary>Encodes a void pointer (<c>void*</c>).</summary>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
diff --git a/xml/System.Security.Cryptography/DSACng.xml b/xml/System.Security.Cryptography/DSACng.xml
@@ -178,8 +178,7 @@
         <remarks>To be added.</remarks>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="rgbHash" /> is <see langword="null" />.</exception>
-        <exception cref="T:System.Security.Cryptography.CryptographicException">
-            This instance represents only a public key.
+        <exception cref="T:System.Security.Cryptography.CryptographicException">This instance represents only a public key.
 
 -or-
 
diff --git a/xml/System.Security.Cryptography/ECDiffieHellmanCng.xml b/xml/System.Security.Cryptography/ECDiffieHellmanCng.xml
@@ -1071,7 +1071,7 @@ Because key sizes do not uniquely identify elliptic curves, the use of the prope
 ]]></format>
         </remarks>
         <exception cref="T:System.Security.Cryptography.CryptographicException">
-          <paramref name="value" /> is not permitted by <see cref="P:System.Security.Cryptography.ECDiffieHellmanCng.LegalKeySizes" />.</exception>
+          <paramref name="value" /> is not permitted by <see cref="P:System.Security.Cryptography.AsymmetricAlgorithm.LegalKeySizes" />.</exception>
         <altmember cref="M:System.Security.Cryptography.ECDiffieHellmanCng.GenerateKey(System.Security.Cryptography.ECCurve)" />
       </Docs>
     </Member>
diff --git a/xml/System.Threading.Channels/ChannelReader`1.xml b/xml/System.Threading.Channels/ChannelReader`1.xml
@@ -177,7 +177,7 @@ Each <xref:System.Collections.Generic.IAsyncEnumerator%601.MoveNextAsync> call t
           <para>A <see cref="T:System.Threading.Tasks.ValueTask`1" /> that will complete with a <see langword="true" /> result when data is available to read
             or with a <see langword="false" /> result when no further data will ever be available to be read due to the channel completing successfully.</para>
           <para>If the channel completes with an exception, the task will also complete with an exception.</para>
-      .</returns>
+        </returns>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
diff --git a/xml/System.Windows.Controls/PasswordBox.xml b/xml/System.Windows.Controls/PasswordBox.xml
@@ -1039,9 +1039,7 @@ PasswordBox with CaretBrush set to red
       </ReturnValue>
       <Docs>
         <summary>Gets or sets the masking character for the <see cref="T:System.Windows.Controls.PasswordBox" />.</summary>
-        <value>A masking character to echo when the user enters text into the <see cref="T:System.Windows.Controls.PasswordBox" />.  
-  
- The default value is a bullet character (**●**).</value>
+        <value>A masking character to echo when the user enters text into the <see cref="T:System.Windows.Controls.PasswordBox" />. The default value is a bullet character (●).</value>
         <remarks>
           <format type="text/markdown"><![CDATA[  
   
diff --git a/xml/System.Windows.Controls/Slider.xml b/xml/System.Windows.Controls/Slider.xml
@@ -562,7 +562,7 @@
       </ReturnValue>
       <Docs>
         <summary>Gets or sets the amount of time in milliseconds between increase or decrease commands when a user clicks the <see cref="T:System.Windows.Controls.Primitives.RepeatButton" /> of a <see cref="T:System.Windows.Controls.Slider" />.</summary>
-        <value>A time in milliseconds between commands that change the <see cref="P:System.Windows.Controls.Primitives.RangeBase.Value" /> of a <see cref="T:System.Windows.Controls.Slider" />. The default is the system key repeat rate. For more information, see [SystemParametersInfo](https://msdn.microsoft.com/library/default.asp?url=/library/sysinfo/base/systemparametersinfo.asp) (SPI_GETKEYBOARDSPEED).</value>
+        <value>A time in milliseconds between commands that change the <see cref="P:System.Windows.Controls.Primitives.RangeBase.Value" /> of a <see cref="T:System.Windows.Controls.Slider" />. The default is the system key repeat rate. For more information, see <see href="/windows/win32/api/winuser/nf-winuser-systemparametersinfoa">SystemParametersInfo</see> (SPI_GETKEYBOARDSPEED).</value>
         <remarks>
           <format type="text/markdown"><![CDATA[  
   
diff --git a/xml/System.Windows.Documents/AdornerDecorator.xml b/xml/System.Windows.Documents/AdornerDecorator.xml
@@ -35,7 +35,6 @@
   
  ]]></format>
     </remarks>
-    <exception cref="T:System.ArgumentException">An attempt is made to add more than a single child to the <see cref="T:System.Windows.Documents.AdornerDecorator" />.</exception>
     <altmember cref="T:System.Windows.Documents.AdornerDecorator" />
     <altmember cref="T:System.Windows.Documents.AdornerLayer" />
     <related type="ExternalDocumentation" href="https://github.com/Microsoft/WPF-Samples/tree/master/Sample%20Applications/PhotoViewerDemo">WPF Photo Viewer Demo</related>
diff --git a/xml/System.Windows.Media.Animation/Storyboard.xml b/xml/System.Windows.Media.Animation/Storyboard.xml
@@ -1638,8 +1638,8 @@
         <Parameter Name="element" Type="System.Windows.DependencyObject" />
       </Parameters>
       <Docs>
-        <param name="element">The dependency object from which to get the <see cref="P:System.Windows.Media.Animation.Storyboard.TargetProperty" />.</param>
-        <summary>Retrieves the <see cref="P:System.Windows.Media.Animation.Storyboard.TargetProperty" /> value of the specified <see cref="T:System.Windows.Media.Animation.Timeline" />.</summary>
+        <param name="element">The dependency object from which to get the <see cref="F:System.Windows.Media.Animation.Storyboard.TargetProperty" />.</param>
+        <summary>Retrieves the <see cref="F:System.Windows.Media.Animation.Storyboard.TargetProperty" /> value of the specified <see cref="T:System.Windows.Media.Animation.Timeline" />.</summary>
         <returns>The property targeted by <paramref name="element" />.</returns>
         <remarks>
           <format type="text/markdown"><![CDATA[  
diff --git a/xml/System.Windows.Media/StreamGeometryContext.xml b/xml/System.Windows.Media/StreamGeometryContext.xml
@@ -21,7 +21,6 @@
   <Docs>
     <summary>Describes a geometry using drawing commands. This class is used with the <see cref="T:System.Windows.Media.StreamGeometry" /> class to create a lightweight geometry that does not support data binding, animation, or modification.</summary>
     <remarks>To be added.</remarks>
-    <exception cref="T:System.InvalidOperationException">An attempt was made to add a segment without starting a figure by calling the <see cref="M:System.Windows.Media.StreamGeometryContext.BeginFigure(System.Windows.Point,System.Boolean,System.Boolean)" /> method.</exception>
     <altmember cref="T:System.Windows.Media.StreamGeometry" />
     <altmember cref="T:System.Windows.Media.PathGeometry" />
   </Docs>
diff --git a/xml/System.Windows/Application.xml b/xml/System.Windows/Application.xml
@@ -395,7 +395,7 @@
       </Parameters>
       <Docs>
         <param name="resourceKey">The name of the resource to find.</param>
-        <summary>Searches for a [!INCLUDE[TLA#tla_ui](~/includes/tlasharptla-ui-md.md)] resource, such as a <see cref="T:System.Windows.Style" /> or <see cref="T:System.Windows.Media.Brush" />, with the specified key, and throws an exception if the requested resource is not found (see [XAML Resources](~/docs/framework/wpf/advanced/xaml-resources.md)).</summary>
+        <summary>Searches for a [!INCLUDE[TLA#tla_ui](~/includes/tlasharptla-ui-md.md)] resource, such as a <see cref="T:System.Windows.Style" /> or <see cref="T:System.Windows.Media.Brush" />, with the specified key, and throws an exception if the requested resource is not found (see <see href="~/docs/framework/wpf/advanced/xaml-resources.md">XAML Resources</see>).</summary>
         <returns>The requested resource object. If the requested resource is not found, a <see cref="T:System.Windows.ResourceReferenceKeyNotFoundException" /> is thrown.</returns>
         <remarks>
           <format type="text/markdown"><![CDATA[  
@@ -487,7 +487,7 @@
       </Parameters>
       <Docs>
         <param name="uriContent">The relative <see cref="T:System.Uri" /> that maps to a loose resource.</param>
-        <summary>Returns a resource stream for a content data file that is located at the specified <see cref="T:System.Uri" /> (see [WPF Application Resource, Content, and Data Files](~/docs/framework/wpf/app-development/wpf-application-resource-content-and-data-files.md)).</summary>
+        <summary>Returns a resource stream for a content data file that is located at the specified <see cref="T:System.Uri" /> (see <see href="~/docs/framework/wpf/app-development/wpf-application-resource-content-and-data-files.md">WPF Application Resource, Content, and Data Files</see>).</summary>
         <returns>A <see cref="T:System.Windows.Resources.StreamResourceInfo" /> that contains a content data file that is located at the specified <see cref="T:System.Uri" />. If a loose resource is not found, null is returned.</returns>
         <remarks>
           <format type="text/markdown"><![CDATA[  
@@ -568,7 +568,7 @@
       </Parameters>
       <Docs>
         <param name="uriRemote">The <see cref="T:System.Uri" /> that maps to a loose resource at the site of origin.</param>
-        <summary>Returns a resource stream for a site-of-origin data file that is located at the specified <see cref="T:System.Uri" /> (see [WPF Application Resource, Content, and Data Files](~/docs/framework/wpf/app-development/wpf-application-resource-content-and-data-files.md)).</summary>
+        <summary>Returns a resource stream for a site-of-origin data file that is located at the specified <see cref="T:System.Uri" /> (see <see href="~/docs/framework/wpf/app-development/wpf-application-resource-content-and-data-files.md">WPF Application Resource, Content, and Data Files</see>).</summary>
         <returns>A <see cref="T:System.Windows.Resources.StreamResourceInfo" /> that contains a resource stream for a site-of-origin data file that is located at the specified <see cref="T:System.Uri" />. If the loose resource is not found, <see langword="null" /> is returned.</returns>
         <remarks>
           <format type="text/markdown"><![CDATA[  
@@ -611,7 +611,7 @@
       </Parameters>
       <Docs>
         <param name="uriResource">The <see cref="T:System.Uri" /> that maps to an embedded resource.</param>
-        <summary>Returns a resource stream for a resource data file that is located at the specified <see cref="T:System.Uri" /> (see [WPF Application Resource, Content, and Data Files](~/docs/framework/wpf/app-development/wpf-application-resource-content-and-data-files.md)).</summary>
+        <summary>Returns a resource stream for a resource data file that is located at the specified <see cref="T:System.Uri" /> (see <see href="~/docs/framework/wpf/app-development/wpf-application-resource-content-and-data-files.md">WPF Application Resource, Content, and Data Files</see>).</summary>
         <returns>A <see cref="T:System.Windows.Resources.StreamResourceInfo" /> that contains a resource stream for resource data file that is located at the specified <see cref="T:System.Uri" />.</returns>
         <remarks>
           <format type="text/markdown"><![CDATA[  
diff --git a/xml/System.Windows/Setter.xml b/xml/System.Windows/Setter.xml
@@ -49,8 +49,6 @@
   
  ]]></format>
     </remarks>
-    <exception cref="T:System.ArgumentNullException">The <see cref="P:System.Windows.Setter.Property" /> property cannot be null.</exception>
-    <exception cref="T:System.ArgumentException">If the specified <see cref="P:System.Windows.Setter.Value" /> is set to <see cref="F:System.Windows.DependencyProperty.UnsetValue" />.</exception>
     <altmember cref="T:System.Windows.EventSetter" />
     <altmember cref="T:System.Windows.TriggerBase" />
   </Docs>
diff --git a/xml/System/Convert.xml b/xml/System/Convert.xml
@@ -1291,7 +1291,7 @@
         <remarks>To be added.</remarks>
         <exception cref="T:System.ArgumentException">
           <paramref name="options" /> is not a valid <see cref="T:System.Base64FormattingOptions" /> value.</exception>
-        <exception cref="T:System.OutOfMemoryException">The output length was larger than <see cref="P:System.Int32.MaxValue" />.</exception>
+        <exception cref="T:System.OutOfMemoryException">The output length was larger than <see cref="F:System.Int32.MaxValue" />.</exception>
       </Docs>
     </Member>
     <Member MemberName="ToBase64String">
