IntelliSense review fixes (#3486)

mairaw · web-flow · commit d9f4ddebdcb6 · 2019-11-14T09:40:59.000-08:00
diff --git a/xml/System.Threading.Channels/ChannelOptions.xml b/xml/System.Threading.Channels/ChannelOptions.xml
@@ -56,8 +56,7 @@
       <Docs>
         <summary>
           <see langword="true" /> if operations performed on a channel may synchronously invoke continuations subscribed to
-            notifications of pending async operations; <see langword="false" /> if all continuations should be invoked asynchronously.
-        </summary>
+            notifications of pending async operations; <see langword="false" /> if all continuations should be invoked asynchronously.</summary>
         <value>To be added.</value>
         <remarks>Setting this option to <see langword="true" /> can provide measurable throughput improvements by avoiding
             scheduling additional work items. However, it may come at the cost of reduced parallelism, as for example a producer
diff --git a/xml/System.Threading.Tasks/Task.xml b/xml/System.Threading.Tasks/Task.xml
@@ -4892,8 +4892,7 @@ Task t Status: RanToCompletion, Result: 42
         <remarks>To be added.</remarks>
         <exception cref="T:System.ObjectDisposedException">The <see cref="T:System.Threading.Tasks.Task" /> has been disposed.</exception>
         <exception cref="T:System.ArgumentNullException">The <paramref name="tasks" /> argument is <see langword="null" />.</exception>
-        <exception cref="T:System.ArgumentOutOfRangeException">
-          The <see cref="P:System.TimeSpan.TotalMilliseconds" /> property of the <paramref name="timeout" /> argument is a negative number other than -1, which represents an infinite time-out.  
+        <exception cref="T:System.ArgumentOutOfRangeException">The <see cref="P:System.TimeSpan.TotalMilliseconds" /> property of the <paramref name="timeout" /> argument is a negative number other than -1, which represents an infinite time-out.  
   
  -or-  
   
diff --git a/xml/System.Web.Hosting/ProcessHost.xml b/xml/System.Web.Hosting/ProcessHost.xml
@@ -214,8 +214,7 @@
   
  ]]></format>
         </remarks>
-        <exception cref="T:System.ArgumentException">
-          The <see cref="T:System.Web.Hosting.IApplicationPreloadUtil" /> instance that contains information for preloading the application is <see langword="null" /> or empty.
+        <exception cref="T:System.ArgumentException">The <see cref="T:System.Web.Hosting.IApplicationPreloadUtil" /> instance that contains information for preloading the application is <see langword="null" /> or empty.
 
 -or-
 
diff --git a/xml/System.Web.ModelBinding/DataAnnotationsModelValidatorProvider.xml b/xml/System.Web.ModelBinding/DataAnnotationsModelValidatorProvider.xml
@@ -216,8 +216,7 @@
         <summary>Registers an adapter for default object validation.</summary>
         <remarks>To be added.</remarks>
         <exception cref="T:System.ArgumentNullException">The <paramref name="type" /> parameter is <see langword="null" />.</exception>
-        <exception cref="T:System.ArgumentException">
-          The adapter type does not derive from <see cref="T:System.Web.ModelBinding.ModelValidator" />.
+        <exception cref="T:System.ArgumentException">The adapter type does not derive from <see cref="T:System.Web.ModelBinding.ModelValidator" />.
 
 -or-
 
@@ -275,8 +274,7 @@ The adapter type does not have a public constructor that accepts two parameters
         <summary>Registers an adapter for object validation.</summary>
         <remarks>To be added.</remarks>
         <exception cref="T:System.ArgumentNullException">The <paramref name="adapterType" /> parameter is <see langword="null" />.</exception>
-        <exception cref="T:System.ArgumentException">
-          The model type does not implement the <see cref="T:System.ComponentModel.DataAnnotations.IValidatableObject" /> interface.
+        <exception cref="T:System.ArgumentException">The model type does not implement the <see cref="T:System.ComponentModel.DataAnnotations.IValidatableObject" /> interface.
 
 -or-
 
diff --git a/xml/System.Web.UI.WebControls.WebParts/WebPart.xml b/xml/System.Web.UI.WebControls.WebParts/WebPart.xml
@@ -1862,8 +1862,7 @@ protected void mgr1_AuthorizeWebPart(object sender,
  ]]></format>
         </remarks>
         <exception cref="T:System.ArgumentNullException">The object in the <paramref name="control" /> parameter is <see langword="null" />.</exception>
-        <exception cref="T:System.ArgumentException">
-          The control is not associated with a page.
+        <exception cref="T:System.ArgumentException">The control is not associated with a page.
 
 -or-
         
diff --git a/xml/System.Web.UI.WebControls.WebParts/WebPartPersonalization.xml b/xml/System.Web.UI.WebControls.WebParts/WebPartPersonalization.xml
@@ -653,7 +653,7 @@
   
  An attempt was made to retrieve an authorization filter and no personalization state has been loaded.  
   
- \- or  
+-or  
   
  The personalization state returned from the data store was <see langword="null" />.</exception>
         <exception cref="T:System.ArgumentException">
@@ -1082,8 +1082,7 @@
   
  ]]></format>
         </remarks>
-        <exception cref="T:System.InvalidOperationException">
-          An attempt was made to reset personalization data when the current user is not authorized to modify personalization state.
+        <exception cref="T:System.InvalidOperationException">An attempt was made to reset personalization data when the current user is not authorized to modify personalization state.
           
 -or-
 
diff --git a/xml/System.Web.UI/ScriptManager.xml b/xml/System.Web.UI/ScriptManager.xml
@@ -2241,8 +2241,8 @@
         </remarks>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="control" /> is <see langword="null" />.</exception>
-        <exception cref="T:System.ArgumentException">
-          The page is registered as an asynchronous postback control.
+        <exception cref="T:System.ArgumentException">The page is registered as an asynchronous postback control.
+
 -or-
 
 The registered control does not implement the <see cref="T:System.Web.UI.INamingContainer" />, <see cref="T:System.Web.UI.IPostBackDataHandler" />, or <see cref="T:System.Web.UI.IPostBackEventHandler" /> interfaces.</exception>
diff --git a/xml/System.Windows.Automation.Peers/UIElementAutomationPeer.xml b/xml/System.Windows.Automation.Peers/UIElementAutomationPeer.xml
@@ -563,7 +563,7 @@
       <Parameters />
       <Docs>
         <summary>Provides a value for UI Automation's SizeOfSet property.</summary>
-        <returns>Reads <see cref="F:System.Windows.Automation.AutomationProperties.SizeOfSet" /> and returns the value.</returns>
+        <returns>Reads <see cref="P:System.Windows.Automation.AutomationProperties.SizeOfSet" /> and returns the value.</returns>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
diff --git a/xml/System.Windows.Automation/GridPattern.xml b/xml/System.Windows.Automation/GridPattern.xml
@@ -179,8 +179,7 @@ Example of a Grid Control with Empty Coordinates
   
  ]]></format>
         </remarks>
-        <exception cref="T:System.ArgumentOutOfRangeException">
-          Either the requested row or column coordinate is less than zero.
+        <exception cref="T:System.ArgumentOutOfRangeException">Either the requested row or column coordinate is less than zero.
 
 -or-
 
diff --git a/xml/System.Windows.Forms.Automation/AutomationNotificationProcessing.xml b/xml/System.Windows.Forms.Automation/AutomationNotificationProcessing.xml
@@ -74,8 +74,7 @@
       </ReturnValue>
       <MemberValue>0</MemberValue>
       <Docs>
-        <summary>These notifications should be presented to the user as soon as possible. All of the notifications from this source should be delivered to the user.<br /><br />**IMPORTANT:** Limit the use of this option, since delivery of all notifications to the user can cause a overwhelming flood of information.
-        </summary>
+        <summary>These notifications should be presented to the user as soon as possible. All of the notifications from this source should be delivered to the user.<br /><br />**IMPORTANT:** Limit the use of this option, since delivery of all notifications to the user can cause a overwhelming flood of information.</summary>
       </Docs>
     </Member>
     <Member MemberName="ImportantMostRecent">
@@ -95,8 +94,7 @@
       </ReturnValue>
       <MemberValue>1</MemberValue>
       <Docs>
-        <summary>These notifications should be presented to the user as soon as possible. The most recent notifications from this source should be delivered to the user because the most recent notification supersedes all other notifications.
-        </summary>
+        <summary>These notifications should be presented to the user as soon as possible. The most recent notifications from this source should be delivered to the user because the most recent notification supersedes all other notifications.</summary>
       </Docs>
     </Member>
     <Member MemberName="MostRecent">
diff --git a/xml/System.Windows.Forms/ControlBindingsCollection.xml b/xml/System.Windows.Forms/ControlBindingsCollection.xml
@@ -141,8 +141,7 @@
  ]]></format>
         </remarks>
         <exception cref="T:System.ArgumentNullException">The <paramref name="binding" /> is null.</exception>
-        <exception cref="T:System.ArgumentException">
-          The control property is already data-bound.
+        <exception cref="T:System.ArgumentException">The control property is already data-bound.
 
 -or-
 
@@ -197,8 +196,7 @@ The <see cref="T:System.Windows.Forms.Binding" /> does not specify a valid colum
  ]]></format>
         </remarks>
         <exception cref="T:System.ArgumentNullException">The <paramref name="binding" /> is <see langword="null" />.</exception>
-        <exception cref="T:System.Exception">
-          The <paramref name="propertyName" /> is already data-bound.
+        <exception cref="T:System.Exception">The <paramref name="propertyName" /> is already data-bound.
 
 -or-
 
diff --git a/xml/System.Windows.Forms/DataGridViewComboBoxCell+ObjectCollection.xml b/xml/System.Windows.Forms/DataGridViewComboBoxCell+ObjectCollection.xml
@@ -155,8 +155,7 @@
         <remarks>To be added.</remarks>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="items" /> is <see langword="null" />.</exception>
-        <exception cref="T:System.InvalidOperationException">
-          One or more of the items in the <paramref name="items" /> array is <see langword="null" />.
+        <exception cref="T:System.InvalidOperationException">One or more of the items in the <paramref name="items" /> array is <see langword="null" />.
 
 -or-
 
@@ -191,8 +190,7 @@ The cell is in a shared row.</exception>
         <remarks>To be added.</remarks>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="value" /> is <see langword="null" />.</exception>
-        <exception cref="T:System.InvalidOperationException">
-          One or more of the items in the <paramref name="value" /> collection is <see langword="null" />.
+        <exception cref="T:System.InvalidOperationException">One or more of the items in the <paramref name="value" /> collection is <see langword="null" />.
 
 -or-
 
diff --git a/xml/System.Windows.Forms/RichTextBox.xml b/xml/System.Windows.Forms/RichTextBox.xml
@@ -1318,8 +1318,7 @@
  ]]></format>
         </remarks>
         <exception cref="T:System.ArgumentNullException">The <paramref name="str" /> parameter was <see langword="null" />.</exception>
-        <exception cref="T:System.ArgumentException">
-          The <paramref name="start" /> parameter was less than zero.
+        <exception cref="T:System.ArgumentException">The <paramref name="start" /> parameter was less than zero.
 
 -or-
         
diff --git a/xml/System.Windows.Forms/WebBrowser.xml b/xml/System.Windows.Forms/WebBrowser.xml
@@ -3024,7 +3024,7 @@
  ]]></format>
         </remarks>
         <exception cref="T:System.ObjectDisposedException">This <see cref="T:System.Windows.Forms.WebBrowser" /> instance is no longer valid.</exception>
-        <exception cref="T:System.InvalidOperationException">A reference to an implementation of the [IWebBrowser2 interface](https://go.microsoft.com/fwlink/?LinkId=151479) could not be retrieved from the underlying ActiveX [WebBrowser control](https://go.microsoft.com/fwlink/?LinkId=151478).</exception>
+        <exception cref="T:System.InvalidOperationException">A reference to an implementation of the <see href="https://docs.microsoft.com/previous-versions/windows/internet-explorer/ie-developer/platform-apis/aa752127(v=vs.85)">IWebBrowser2 interface</see> could not be retrieved from the underlying ActiveX <see href="https://docs.microsoft.com/previous-versions/windows/internet-explorer/ie-developer/platform-apis/aa752040(v=vs.85)">WebBrowser control</see>.</exception>
         <permission cref="T:System.Security.Permissions.SecurityPermission">for immediate callers to use this control. Demand value: <see cref="F:System.Security.Permissions.SecurityAction.LinkDemand" />; <see href="https://docs.microsoft.com/previous-versions/dotnet/netframework-4.0/4652tyx7(v=vs.100)">Named Permission Sets</see>: <see langword="FullTrust" />.</permission>
         <related type="ExternalDocumentation" href="https://go.microsoft.com/fwlink/?LinkId=151478">WebBrowser Control</related>
         <related type="ExternalDocumentation" href="https://go.microsoft.com/fwlink/?LinkId=151479">IWebBrowser2 Interface</related>
diff --git a/xml/System.Windows.Interop/ComponentDispatcher.xml b/xml/System.Windows.Interop/ComponentDispatcher.xml
@@ -282,7 +282,7 @@
         <param name="msg">The message and its associated data.</param>
         <summary>Indicates that a new message is available for possible handling.</summary>
         <returns>
-          <see langword="true" />, if one of the modules listening to the message loop processed the message. The owner of the message loop should ignore the message. <see langword="false" />, if the message was not processed. In this case, the owner of the message pump should call the [!INCLUDE[TLA2#tla_win32](~/includes/tla2sharptla-win32-md.md)] function [TranslateMessage](https://msdn.microsoft.com/library/ms644955.aspx) followed by [DispatchMessage](https://msdn.microsoft.com/library/ms644934.aspx).</returns>
+          <see langword="true" />, if one of the modules listening to the message loop processed the message. The owner of the message loop should ignore the message. <see langword="false" />, if the message was not processed. In this case, the owner of the message pump should call the Win32 function <see href="/windows/win32/api/winuser/nf-winuser-translatemessage">TranslateMessage</see> followed by <see href="/windows/win32/api/winuser/nf-winuser-dispatchmessage">DispatchMessage</see>.</returns>
         <remarks>
           <format type="text/markdown"><![CDATA[  
   
diff --git a/xml/System.Windows.Threading/DispatcherTimer.xml b/xml/System.Windows.Threading/DispatcherTimer.xml
@@ -168,7 +168,7 @@
 
 -or-
 
-          <paramref name="dispatcher" /> is <see langword="null" />.</exception>
+<paramref name="dispatcher" /> is <see langword="null" />.</exception>
         <exception cref="T:System.ArgumentOutOfRangeException">
           <paramref name="interval" /> is less than 0 or greater than <see cref="F:System.Int32.MaxValue" />.</exception>
       </Docs>
diff --git a/xml/System.Workflow.ComponentModel/DependencyObject.xml b/xml/System.Workflow.ComponentModel/DependencyObject.xml
@@ -577,8 +577,7 @@ The <paramref name="dependencyEvent" /> represents a non-event <see cref="T:Syst
  ]]></format>
         </remarks>
         <exception cref="T:System.ArgumentNullException">Either of the arguments is a null reference (<see langword="Nothing" /> in Visual Basic).</exception>
-        <exception cref="T:System.ArgumentException">
-          The <paramref name="dependencyEvent" /> is a <see langword="metaproperty" />.
+        <exception cref="T:System.ArgumentException">The <paramref name="dependencyEvent" /> is a <see langword="metaproperty" />.
 
 -or-
 
diff --git a/xml/System.Xml/EntityHandling.xml b/xml/System.Xml/EntityHandling.xml
@@ -101,7 +101,7 @@ When set to <see langword="ExpandCharEntities" />, a reader call to the <see cre
       <Docs>
         <summary>Expands all entities and returns the expanded nodes.
         
-<see cref="T:System.Xml.XmlNodeType.EntityReference" /> nodes are not returned. The entity text is expanded in place of the entity references.        
+<see cref="F:System.Xml.XmlNodeType.EntityReference" /> nodes are not returned. The entity text is expanded in place of the entity references.        
         </summary>
       </Docs>
     </Member>
diff --git a/xml/System.Xml/ValidationType.xml b/xml/System.Xml/ValidationType.xml
@@ -146,8 +146,7 @@ Starting with .NET Framework 2.0, this field is obsolete. It applies only to the
       <Docs>
         <summary>No validation is performed, and no validation errors are thrown. This setting creates an XML 1.0 compliant non-validating parser.
         
-Calls to <see cref="M:System.Xml.XmlReader.ResolveEntity" /> report default attributes and resolve general entities. The DOCTYPE is not used for validation purposes.
-        </summary>
+Calls to <see cref="M:System.Xml.XmlReader.ResolveEntity" /> report default attributes and resolve general entities. The DOCTYPE is not used for validation purposes.</summary>
       </Docs>
     </Member>
     <Member MemberName="Schema">
diff --git a/xml/System.Xml/XmlDictionaryWriter.xml b/xml/System.Xml/XmlDictionaryWriter.xml
@@ -1980,8 +1980,7 @@ binarywriter.WriteEndAttribute();
   
  ]]></format>
         </remarks>
-        <exception cref="T:System.InvalidOperationException">
-          An <see cref="T:System.Xml.XmlDictionaryWriter" /> method was called before a previous asynchronous operation finished. In this case, <see cref="T:System.InvalidOperationException" /> is thrown with the message "An asynchronous operation is already in progress."
+        <exception cref="T:System.InvalidOperationException">An <see cref="T:System.Xml.XmlDictionaryWriter" /> method was called before a previous asynchronous operation finished. In this case, <see cref="T:System.InvalidOperationException" /> is thrown with the message "An asynchronous operation is already in progress."
 
 -or-
 
@@ -2759,8 +2758,7 @@ An <see cref="T:System.Xml.XmlDictionaryWriter" /> asynchronous method was calle
   
  ]]></format>
         </remarks>
-        <exception cref="T:System.InvalidOperationException">
-          An <see cref="T:System.Xml.XmlDictionaryWriter" /> method was called before a previous asynchronous operation finished. In this case, <see cref="T:System.InvalidOperationException" /> is thrown with the message "An asynchronous operation is already in progress."
+        <exception cref="T:System.InvalidOperationException">An <see cref="T:System.Xml.XmlDictionaryWriter" /> method was called before a previous asynchronous operation finished. In this case, <see cref="T:System.InvalidOperationException" /> is thrown with the message "An asynchronous operation is already in progress."
 
 -or-
 
diff --git a/xml/System.Xml/XmlReader.xml b/xml/System.Xml/XmlReader.xml
diff --git a/xml/System.Xml/XmlWriter.xml b/xml/System.Xml/XmlWriter.xml
