From 3a00b3f578bc8c19e84249f330e066f003ca3a77 Mon Sep 17 00:00:00 2001
From: Genevieve Warren <24882762+gewarren@users.noreply.github.com>
Date: Thu, 6 Oct 2022 21:31:17 -0700
Subject: [PATCH 01/12] fix up boilerplate text for dispose/finalize
---
xml/System.CodeDom.Compiler/TempFileCollection.xml | 5 +++--
.../ScaffoldColumnAttribute.xml | 2 +-
.../SerializationStore.xml | 3 ++-
xml/System.ComponentModel.Design/ComponentDesigner.xml | 5 +++--
xml/System.ComponentModel.Design/DesignSurface.xml | 5 +++--
.../DesignSurfaceManager.xml | 5 +++--
.../DesignerActionService.xml | 5 +++--
xml/System.ComponentModel.Design/DesignerTransaction.xml | 5 +++--
xml/System.ComponentModel.Design/InheritanceService.xml | 5 +++--
.../LocalizationExtenderProvider.xml | 5 +++--
xml/System.ComponentModel.Design/MenuCommandService.xml | 5 +++--
xml/System.ComponentModel.Design/ServiceContainer.xml | 5 +++--
xml/System.ComponentModel/Component.xml | 5 +++--
xml/System.ComponentModel/Container.xml | 3 ++-
xml/System.ComponentModel/MarshalByValueComponent.xml | 5 +++--
xml/System.ComponentModel/NestedContainer.xml | 5 +++--
xml/System.Data.Common/DataAdapter.xml | 3 ++-
xml/System.Data.Common/DbCommandBuilder.xml | 9 +++++----
xml/System.Diagnostics.Tracing/EventSource.xml | 3 ++-
xml/System.Diagnostics/EventLog.xml | 5 +++--
xml/System.Diagnostics/TraceListener.xml | 2 +-
xml/System.DirectoryServices/DirectoryEntry.xml | 8 +++-----
xml/System.DirectoryServices/SearchResultCollection.xml | 2 +-
xml/System.Drawing.Text/FontCollection.xml | 3 ++-
xml/System.Drawing/Brush.xml | 3 ++-
.../AppDomainHelper.xml | 4 +---
xml/System.EnterpriseServices/ServicedComponent.xml | 3 ++-
xml/System.IO.Compression/DeflateStream.xml | 4 ++--
xml/System.IO.Compression/GZipStream.xml | 4 ++--
.../IsolatedStorageFileStream.xml | 2 +-
xml/System.IO.Packaging/EncryptedPackageEnvelope.xml | 5 +++--
xml/System.IO.Packaging/PackageProperties.xml | 5 +++--
xml/System.IO.Pipes/PipeStream.xml | 5 ++++-
xml/System.IO.Ports/SerialPort.xml | 4 ++--
xml/System.IO/BinaryReader.xml | 2 +-
xml/System.IO/BufferedStream.xml | 2 +-
xml/System.IO/FileStream.xml | 4 ++--
xml/System.IO/FileSystemWatcher.xml | 4 ++--
xml/System.IO/MemoryStream.xml | 4 ++--
xml/System.IO/Stream.xml | 2 +-
xml/System.IO/StreamReader.xml | 2 +-
xml/System.IO/TextReader.xml | 3 ++-
xml/System.IO/TextWriter.xml | 2 +-
xml/System.IO/UnmanagedMemoryAccessor.xml | 5 +++--
xml/System.IO/UnmanagedMemoryStream.xml | 4 ++--
xml/System.Messaging/MessageEnumerator.xml | 2 +-
xml/System.Messaging/MessageQueueEnumerator.xml | 2 +-
xml/System.Messaging/MessageQueueTransaction.xml | 2 +-
xml/System.Net.Http/HttpClient.xml | 5 +++--
xml/System.Net.Http/HttpClientHandler.xml | 3 ++-
xml/System.Net.Http/HttpContent.xml | 7 +++++--
xml/System.Net.Http/HttpMessageHandler.xml | 7 +++++--
xml/System.Net.Http/HttpRequestMessage.xml | 7 +++++--
xml/System.Net.Http/HttpResponseMessage.xml | 7 +++++--
xml/System.Net.Http/MultipartContent.xml | 7 +++++--
xml/System.Net.Http/StreamContent.xml | 7 +++++--
xml/System.Net.Mail/AlternateView.xml | 5 +++--
xml/System.Net.Mail/AttachmentBase.xml | 5 +++--
xml/System.Net.Mail/MailMessage.xml | 5 +++--
xml/System.Net.NetworkInformation/Ping.xml | 2 +-
xml/System.Net.PeerToPeer.Collaboration/Peer.xml | 2 +-
xml/System.Net.Security/AuthenticatedStream.xml | 5 +++--
xml/System.Net.Security/NegotiateStream.xml | 5 +++--
xml/System.Net.Security/SslStream.xml | 5 +++--
xml/System.Net.Sockets/NetworkStream.xml | 3 ++-
xml/System.Net.Sockets/Socket.xml | 3 ++-
xml/System.Net.Sockets/SocketAsyncEventArgs.xml | 5 +++--
xml/System.Net.Sockets/TcpClient.xml | 2 +-
xml/System.Net.Sockets/UdpClient.xml | 5 +++--
xml/System.Net/HttpWebResponse.xml | 5 +++--
xml/System.Net/WebResponse.xml | 5 +++--
xml/System.Printing.IndexedProperties/PrintProperty.xml | 2 +-
.../PrintPropertyDictionary.xml | 2 +-
xml/System.Printing/PrintJobInfoCollection.xml | 2 +-
xml/System.Printing/PrintQueueCollection.xml | 2 +-
xml/System.Printing/PrintQueueStream.xml | 2 +-
xml/System.Printing/PrintSystemObject.xml | 2 +-
.../PrintSystemObjectPropertiesChangedEventArgs.xml | 2 +-
.../PrintSystemObjectPropertyChangedEventArgs.xml | 2 +-
xml/System.Printing/PrintSystemObjects.xml | 2 +-
xml/System.Resources/ResXResourceReader.xml | 2 +-
xml/System.Resources/ResXResourceWriter.xml | 2 +-
xml/System.Security.Cryptography/AsymmetricAlgorithm.xml | 2 +-
xml/System.Security.Cryptography/CryptoStream.xml | 2 +-
xml/System.Security.Cryptography/DeriveBytes.xml | 3 ++-
.../ECDiffieHellmanPublicKey.xml | 5 +++--
xml/System.Security.Cryptography/FromBase64Transform.xml | 2 +-
xml/System.Security.Cryptography/HMAC.xml | 2 +-
xml/System.Security.Cryptography/HashAlgorithm.xml | 2 +-
xml/System.Security.Cryptography/KeyedHashAlgorithm.xml | 2 +-
xml/System.Security.Cryptography/MACTripleDES.xml | 2 +-
xml/System.Security.Cryptography/PasswordDeriveBytes.xml | 3 ++-
.../RandomNumberGenerator.xml | 2 +-
xml/System.Security.Cryptography/Rfc2898DeriveBytes.xml | 3 ++-
xml/System.Security.Cryptography/SymmetricAlgorithm.xml | 2 +-
xml/System.Security.Cryptography/ToBase64Transform.xml | 4 ++--
xml/System.Security.Cryptography/TripleDESCng.xml | 2 +-
xml/System.Security.Principal/WindowsIdentity.xml | 5 +++--
.../WindowsImpersonationContext.xml | 5 +++--
xml/System.Security.RightsManagement/CryptoProvider.xml | 5 +++--
.../SecureEnvironment.xml | 2 +-
xml/System.ServiceProcess/ServiceController.xml | 5 +++--
xml/System.Web.ClientServices/ClientFormsIdentity.xml | 5 +++--
.../ActiveDirectoryMembershipProvider.xml | 2 +-
.../RegexEditorDialog.xml | 2 +-
xml/System.Web.UI.Design.WebControls/XmlDesigner.xml | 2 +-
xml/System.Web.UI.Design/ExtenderControlDesigner.xml | 3 ++-
xml/System.Web.UI.Design/HtmlControlDesigner.xml | 5 +++--
xml/System.Web.UI.Design/TemplateEditingVerb.xml | 2 +-
xml/System.Web.UI.WebControls/CreateUserWizard.xml | 4 ++--
.../AnnotationStore.xml | 2 +-
xml/System.Windows.Annotations/ContentLocator.xml | 2 +-
xml/System.Windows.Annotations/ContentLocatorBase.xml | 2 +-
xml/System.Windows.Annotations/ContentLocatorGroup.xml | 2 +-
xml/System.Windows.Annotations/ContentLocatorPart.xml | 2 +-
.../ComponentDocumentDesigner.xml | 5 +++--
xml/System.Windows.Forms.Design/ComponentTray.xml | 5 +++--
xml/System.Windows.Forms.Design/ControlDesigner.xml | 5 +++--
xml/System.Windows.Forms.Design/DocumentDesigner.xml | 5 +++--
.../ParentControlDesigner.xml | 5 +++--
xml/System.Windows.Forms.Design/PropertyTab.xml | 5 +++--
xml/System.Windows.Forms.Integration/ElementHost.xml | 3 ++-
xml/System.Windows.Forms/ApplicationContext.xml | 2 +-
xml/System.Windows.Forms/BindingNavigator.xml | 3 ++-
xml/System.Windows.Forms/BindingSource.xml | 3 ++-
xml/System.Windows.Forms/ButtonBase.xml | 3 ++-
xml/System.Windows.Forms/ComboBox.xml | 3 ++-
xml/System.Windows.Forms/ContextMenuStrip.xml | 3 ++-
xml/System.Windows.Forms/Control.xml | 2 +-
xml/System.Windows.Forms/DataGridViewBand.xml | 5 +++--
xml/System.Windows.Forms/DataGridViewCell.xml | 3 ++-
.../DateTimePicker+DateTimePickerAccessibleObject.xml | 2 +-
xml/System.Windows.Forms/Form.xml | 3 ++-
xml/System.Windows.Forms/Label.xml | 3 ++-
xml/System.Windows.Forms/MonthCalendar.xml | 5 +++--
xml/System.Windows.Forms/PaintEventArgs.xml | 2 +-
xml/System.Windows.Forms/PictureBox.xml | 3 ++-
xml/System.Windows.Forms/StatusBar.xml | 3 ++-
xml/System.Windows.Forms/StatusBarPanel.xml | 5 +++--
xml/System.Windows.Forms/StatusStrip.xml | 5 +++--
xml/System.Windows.Forms/TextBox.xml | 5 +++--
xml/System.Windows.Forms/ToolBar.xml | 3 ++-
xml/System.Windows.Forms/ToolBarButton.xml | 3 ++-
xml/System.Windows.Forms/ToolStrip.xml | 3 ++-
xml/System.Windows.Forms/ToolStripControlHost.xml | 3 ++-
xml/System.Windows.Forms/ToolStripDropDown.xml | 3 ++-
xml/System.Windows.Forms/ToolStripDropDownItem.xml | 5 +++--
xml/System.Windows.Forms/ToolStripItem.xml | 3 ++-
xml/System.Windows.Forms/ToolStripMenuItem.xml | 3 ++-
xml/System.Windows.Forms/ToolStripPanel.xml | 3 ++-
xml/System.Windows.Forms/ToolStripPanelRow.xml | 3 ++-
xml/System.Windows.Forms/TreeView.xml | 3 ++-
xml/System.Windows.Xps.Packaging/XpsDocument.xml | 5 +++--
153 files changed, 327 insertions(+), 225 deletions(-)
diff --git a/xml/System.CodeDom.Compiler/TempFileCollection.xml b/xml/System.CodeDom.Compiler/TempFileCollection.xml
index cad43875a20..dc6012239aa 100644
--- a/xml/System.CodeDom.Compiler/TempFileCollection.xml
+++ b/xml/System.CodeDom.Compiler/TempFileCollection.xml
@@ -552,8 +552,9 @@
method. `Dispose()` invokes the protected `Dispose(Boolean)` method with the `disposing` parameter set to `true`. invokes `Dispose` with `disposing` set to `false`.
+## Remarks
+
+This method is called by the public `Dispose()` method (and the method, if it has been overridden). `Dispose()` invokes the protected `Dispose(Boolean)` method with the `disposing` parameter set to `true`. `Finalize` invokes `Dispose` with `disposing` set to `false`.
When the `disposing` parameter is `true`, this method releases all resources held by any managed objects that this references. This method invokes the `Dispose()` method of each referenced object.
diff --git a/xml/System.ComponentModel.DataAnnotations/ScaffoldColumnAttribute.xml b/xml/System.ComponentModel.DataAnnotations/ScaffoldColumnAttribute.xml
index 22887cc6e28..9cd797b3d14 100644
--- a/xml/System.ComponentModel.DataAnnotations/ScaffoldColumnAttribute.xml
+++ b/xml/System.ComponentModel.DataAnnotations/ScaffoldColumnAttribute.xml
@@ -61,7 +61,7 @@
## Examples
- The following code example exposes the ProductID column of the Products table in the AdventureWorksLT data base by applying the scaffold property to the ProductID object in the Products partial class and setting it to `true.` It hides the ThumbnailPhotoFileName column by applying the scaffold property to the ThumbnailPhotoFileName object and setting it to `false`.
+ The following code example exposes the ProductID column of the Products table in the AdventureWorksLT data base by applying the scaffold property to the ProductID object in the Products partial class and setting it to `true`. It hides the ThumbnailPhotoFileName column by applying the scaffold property to the ThumbnailPhotoFileName object and setting it to `false`.
```csharp
[MetadataType(typeof(ProductMetadata))]
diff --git a/xml/System.ComponentModel.Design.Serialization/SerializationStore.xml b/xml/System.ComponentModel.Design.Serialization/SerializationStore.xml
index 18ceca29674..f58067d8cdb 100644
--- a/xml/System.ComponentModel.Design.Serialization/SerializationStore.xml
+++ b/xml/System.ComponentModel.Design.Serialization/SerializationStore.xml
@@ -179,7 +179,8 @@
method. `Dispose()` invokes the protected `Dispose(Boolean)` method with the `disposing` parameter set to `true`. invokes `Dispose` with `disposing` set to `false`.
+
+This method is called by the public `Dispose()` method (and the method, if it has been overridden). `Dispose()` invokes the protected `Dispose(Boolean)` method with the `disposing` parameter set to `true`. `Finalize` invokes `Dispose` with `disposing` set to `false`.
When the `disposing` parameter is true, this method releases all resources held by any managed objects that this references. This method invokes the `Dispose()` method of each referenced object.
diff --git a/xml/System.ComponentModel.Design/ComponentDesigner.xml b/xml/System.ComponentModel.Design/ComponentDesigner.xml
index 65c32df48cf..0b9c89996ae 100644
--- a/xml/System.ComponentModel.Design/ComponentDesigner.xml
+++ b/xml/System.ComponentModel.Design/ComponentDesigner.xml
@@ -326,8 +326,9 @@
method. `Dispose()` invokes the protected `Dispose(Boolean)` method with the `disposing` parameter set to `true`. invokes `Dispose` with `disposing` set to `false`.
+## Remarks
+
+This method is called by the public `Dispose()` method (and the method, if it has been overridden). `Dispose()` invokes the protected `Dispose(Boolean)` method with the `disposing` parameter set to `true`. `Finalize` invokes `Dispose` with `disposing` set to `false`.
When the `disposing` parameter is true, this method releases all resources held by any managed objects that this references. This method invokes the `Dispose()` method of each referenced object.
diff --git a/xml/System.ComponentModel.Design/DesignSurface.xml b/xml/System.ComponentModel.Design/DesignSurface.xml
index 9fee421e309..a6643139268 100644
--- a/xml/System.ComponentModel.Design/DesignSurface.xml
+++ b/xml/System.ComponentModel.Design/DesignSurface.xml
@@ -752,8 +752,9 @@
> [!NOTE]
> Because does not have any native code to clean up, it does not have a finalizer that calls . If you need to call , you must add a finalizer yourself.
-
- This method is called by the public `Dispose()` method and the method. `Dispose()` invokes the protected `Dispose(Boolean)` method with the `disposing` parameter set to `true`. invokes `Dispose` with `disposing` set to `false`.
+
+
+This method is called by the public `Dispose()` method (and the method, if it has been overridden). `Dispose()` invokes the protected `Dispose(Boolean)` method with the `disposing` parameter set to `true`. `Finalize` invokes `Dispose` with `disposing` set to `false`.
When the `disposing` parameter is true, this method releases all resources held by any managed objects that this references. This method invokes the `Dispose()` method of each referenced object.
diff --git a/xml/System.ComponentModel.Design/DesignSurfaceManager.xml b/xml/System.ComponentModel.Design/DesignSurfaceManager.xml
index b035fa405c9..48bceaa45a5 100644
--- a/xml/System.ComponentModel.Design/DesignSurfaceManager.xml
+++ b/xml/System.ComponentModel.Design/DesignSurfaceManager.xml
@@ -515,8 +515,9 @@
> [!NOTE]
> Because does not have any native code to clean up, it does not have a finalizer that calls . If you need to call , you must add a finalizer yourself.
-
- This method is called by the public `Dispose()` method and the method. `Dispose()` invokes the protected `Dispose(Boolean)` method with the `disposing` parameter set to `true`. invokes `Dispose` with `disposing` set to `false`.
+
+
+This method is called by the public `Dispose()` method (and the method, if it has been overridden). `Dispose()` invokes the protected `Dispose(Boolean)` method with the `disposing` parameter set to `true`. `Finalize` invokes `Dispose` with `disposing` set to `false`.
When the `disposing` parameter is true, this method releases all resources held by any managed objects that this references. This method invokes the `Dispose()` method of each referenced object.
diff --git a/xml/System.ComponentModel.Design/DesignerActionService.xml b/xml/System.ComponentModel.Design/DesignerActionService.xml
index 1d74b6f8309..b7bb109c2f1 100644
--- a/xml/System.ComponentModel.Design/DesignerActionService.xml
+++ b/xml/System.ComponentModel.Design/DesignerActionService.xml
@@ -483,8 +483,9 @@
- Removes the current service from the list of available services in the design environment through a call to the method.
- Unsubscribes to component change events from the associated interface.
-
- This method is called by the public `Dispose()` method and the method. `Dispose()` invokes the protected `Dispose(Boolean)` method with the `disposing` parameter set to `true`. invokes `Dispose` with `disposing` set to `false`.
+
+
+This method is called by the public `Dispose()` method (and the method, if it has been overridden). `Dispose()` invokes the protected `Dispose(Boolean)` method with the `disposing` parameter set to `true`. `Finalize` invokes `Dispose` with `disposing` set to `false`.
When the `disposing` parameter is `true`, this method releases all resources held by any managed objects that this references. This method invokes the `Dispose()` method of each referenced object.
diff --git a/xml/System.ComponentModel.Design/DesignerTransaction.xml b/xml/System.ComponentModel.Design/DesignerTransaction.xml
index 5ccf00ac3ec..c33a008a821 100644
--- a/xml/System.ComponentModel.Design/DesignerTransaction.xml
+++ b/xml/System.ComponentModel.Design/DesignerTransaction.xml
@@ -497,8 +497,9 @@ using (host.CreateTransaction() {
method. `Dispose()` invokes the protected `Dispose(Boolean)` method with the `disposing` parameter set to `true`. invokes `Dispose` with `disposing` set to `false`.
+## Remarks
+
+This method is called by the public `Dispose()` method (and the method, if it has been overridden). `Dispose()` invokes the protected `Dispose(Boolean)` method with the `disposing` parameter set to `true`. `Finalize` invokes `Dispose` with `disposing` set to `false`.
When the `disposing` parameter is `true`, this method releases all resources held by any managed objects that this references. This method invokes the `Dispose()` method of each referenced object.
diff --git a/xml/System.ComponentModel.Design/InheritanceService.xml b/xml/System.ComponentModel.Design/InheritanceService.xml
index 4fc995cad04..4d3e780a207 100644
--- a/xml/System.ComponentModel.Design/InheritanceService.xml
+++ b/xml/System.ComponentModel.Design/InheritanceService.xml
@@ -261,8 +261,9 @@
method. `Dispose()` invokes the protected `Dispose(Boolean)` method with the `disposing` parameter set to `true`. invokes `Dispose` with `disposing` set to `false`.
+## Remarks
+
+This method is called by the public `Dispose()` method (and the method, if it has been overridden). `Dispose()` invokes the protected `Dispose(Boolean)` method with the `disposing` parameter set to `true`. `Finalize` invokes `Dispose` with `disposing` set to `false`.
When the `disposing` parameter is true, this method releases all resources held by any managed objects that this references. This method invokes the `Dispose()` method of each referenced object.
diff --git a/xml/System.ComponentModel.Design/LocalizationExtenderProvider.xml b/xml/System.ComponentModel.Design/LocalizationExtenderProvider.xml
index ee896024474..757183bf217 100644
--- a/xml/System.ComponentModel.Design/LocalizationExtenderProvider.xml
+++ b/xml/System.ComponentModel.Design/LocalizationExtenderProvider.xml
@@ -220,8 +220,9 @@
method. `Dispose()` invokes the protected `Dispose(Boolean)` method with the `disposing` parameter set to `true`. invokes `Dispose` with `disposing` set to `false`.
+## Remarks
+
+This method is called by the public `Dispose()` method (and the method, if it has been overridden). `Dispose()` invokes the protected `Dispose(Boolean)` method with the `disposing` parameter set to `true`. `Finalize` invokes `Dispose` with `disposing` set to `false`.
When the `disposing` parameter is true, this method releases all resources held by any managed objects that this references. This method invokes the `Dispose()` method of each referenced object.
diff --git a/xml/System.ComponentModel.Design/MenuCommandService.xml b/xml/System.ComponentModel.Design/MenuCommandService.xml
index 619c8aa89b3..35737bc572c 100644
--- a/xml/System.ComponentModel.Design/MenuCommandService.xml
+++ b/xml/System.ComponentModel.Design/MenuCommandService.xml
@@ -279,8 +279,9 @@
method. `Dispose()` invokes the protected `Dispose(Boolean)` method with the `disposing` parameter set to `true`. invokes `Dispose` with `disposing` set to `false`.
+## Remarks
+
+This method is called by the public `Dispose()` method (and the method, if it has been overridden). `Dispose()` invokes the protected `Dispose(Boolean)` method with the `disposing` parameter set to `true`. `Finalize` invokes `Dispose` with `disposing` set to `false`.
When the `disposing` parameter is true, this method releases all resources held by any managed objects that this references. This method invokes the `Dispose()` method of each referenced object.
diff --git a/xml/System.ComponentModel.Design/ServiceContainer.xml b/xml/System.ComponentModel.Design/ServiceContainer.xml
index 98a4dd783de..a083be397fe 100644
--- a/xml/System.ComponentModel.Design/ServiceContainer.xml
+++ b/xml/System.ComponentModel.Design/ServiceContainer.xml
@@ -600,8 +600,9 @@
## Remarks
walks all instantiated services within the container and disposes any that implement , and clears the service list.
-
- This method is called by the public `Dispose()` method and the method. `Dispose()` invokes the protected `Dispose(Boolean)` method with the `disposing` parameter set to `true`. invokes `Dispose` with `disposing` set to `false`.
+
+
+This method is called by the public `Dispose()` method (and the method, if it has been overridden). `Dispose()` invokes the protected `Dispose(Boolean)` method with the `disposing` parameter set to `true`. `Finalize` invokes `Dispose` with `disposing` set to `false`.
When the `disposing` parameter is true, this method releases all resources held by any managed objects that this references. This method invokes the `Dispose()` method of each referenced object.
diff --git a/xml/System.ComponentModel/Component.xml b/xml/System.ComponentModel/Component.xml
index d6ddacd4054..8a29dfc65f9 100644
--- a/xml/System.ComponentModel/Component.xml
+++ b/xml/System.ComponentModel/Component.xml
@@ -420,8 +420,9 @@
method and the method. `Dispose()` invokes the protected `Dispose(Boolean)` method with the `disposing` parameter set to `true`. invokes `Dispose` with `disposing` set to `false`.
+## Remarks
+
+This method is called by the public `Dispose()` method (and the method, if it has been overridden). `Dispose()` invokes the protected `Dispose(Boolean)` method with the `disposing` parameter set to `true`. `Finalize` invokes `Dispose` with `disposing` set to `false`.
When the `disposing` parameter is `true`, this method releases all resources held by any managed objects that this references. This method invokes the `Dispose()` method of each referenced object.
diff --git a/xml/System.ComponentModel/Container.xml b/xml/System.ComponentModel/Container.xml
index 8324ef320ca..c1d8f6b2e94 100644
--- a/xml/System.ComponentModel/Container.xml
+++ b/xml/System.ComponentModel/Container.xml
@@ -450,7 +450,8 @@
method. `Dispose` invokes the protected `Dispose(Boolean)` method with the `disposing` parameter set to `true`. invokes `Dispose` with `disposing` set to `false`.
+
+This method is called by the public `Dispose()` method (and the method, if it has been overridden). `Dispose()` invokes the protected `Dispose(Boolean)` method with the `disposing` parameter set to `true`. `Finalize` invokes `Dispose` with `disposing` set to `false`.
When the `disposing` parameter is true, this method releases all resources held by any managed objects that this references. This method invokes the `Dispose` method of each referenced object.
diff --git a/xml/System.ComponentModel/MarshalByValueComponent.xml b/xml/System.ComponentModel/MarshalByValueComponent.xml
index de804dfdba3..8b82fff6498 100644
--- a/xml/System.ComponentModel/MarshalByValueComponent.xml
+++ b/xml/System.ComponentModel/MarshalByValueComponent.xml
@@ -358,8 +358,9 @@
method. `Dispose()` invokes the protected `Dispose(Boolean)` method with the `disposing` parameter set to `true`. invokes `Dispose` with `disposing` set to `false`.
+## Remarks
+
+This method is called by the public `Dispose()` method (and the method, if it has been overridden). `Dispose()` invokes the protected `Dispose(Boolean)` method with the `disposing` parameter set to `true`. `Finalize` invokes `Dispose` with `disposing` set to `false`.
When the `disposing` parameter is true, this method releases all resources held by any managed objects that this references. This method invokes the `Dispose()` method of each referenced object.
diff --git a/xml/System.ComponentModel/NestedContainer.xml b/xml/System.ComponentModel/NestedContainer.xml
index e1df66b17f6..d133ce645c0 100644
--- a/xml/System.ComponentModel/NestedContainer.xml
+++ b/xml/System.ComponentModel/NestedContainer.xml
@@ -221,8 +221,9 @@
method. `Dispose()` invokes the protected `Dispose(Boolean)` method with the `disposing` parameter set to `true`. invokes `Dispose` with `disposing` set to `false`.
+## Remarks
+
+This method is called by the public `Dispose()` method (and the method, if it has been overridden). `Dispose()` invokes the protected `Dispose(Boolean)` method with the `disposing` parameter set to `true`. `Finalize` invokes `Dispose` with `disposing` set to `false`.
When the `disposing` parameter is true, this method releases all resources held by any managed objects that this references. This method invokes the `Dispose()` method of each referenced object.
diff --git a/xml/System.Data.Common/DataAdapter.xml b/xml/System.Data.Common/DataAdapter.xml
index ef89348908a..72660ab1858 100644
--- a/xml/System.Data.Common/DataAdapter.xml
+++ b/xml/System.Data.Common/DataAdapter.xml
@@ -515,7 +515,8 @@
method and the method. `Dispose` invokes the protected `Dispose(Boolean)` method with the `disposing` parameter set to `true`. invokes `Dispose` with `disposing` set to `false`.
+
+This method is called by the public `Dispose()` method (and the method, if it has been overridden). `Dispose()` invokes the protected `Dispose(Boolean)` method with the `disposing` parameter set to `true`. `Finalize` invokes `Dispose` with `disposing` set to `false`.
When the `disposing` parameter is `true`, this method releases all resources held by any managed objects that this references. This method invokes the `Dispose` method of each referenced object.
diff --git a/xml/System.Data.Common/DbCommandBuilder.xml b/xml/System.Data.Common/DbCommandBuilder.xml
index 34cd71e8238..94d79896486 100644
--- a/xml/System.Data.Common/DbCommandBuilder.xml
+++ b/xml/System.Data.Common/DbCommandBuilder.xml
@@ -386,10 +386,11 @@
method and the `Finalize` method. invokes the protected method with the disposing parameter set to `true`. `Finalize` invokes `Dispose` with `disposing` set to `false`.
+## Remarks
+
+This method is called by the public method and the method, if it has been overridden. invokes the protected method with the disposing parameter set to `true`. `Finalize`, if it exists, invokes `Dispose` with `disposing` set to `false`.
- When the `disposing` parameter is `true`, this method releases all resources held by any managed objects that this references. This method invokes the method of each referenced object.
+When the `disposing` parameter is `true`, this method releases all resources held by any managed objects that this references. This method invokes the method of each referenced object.
]]>
@@ -397,7 +398,7 @@
can be called multiple times by other objects. When overriding , be careful not to reference objects that have been previously disposed of in an earlier call to . For more information about how to implement , see [Implementing a Dispose Method](/dotnet/standard/garbage-collection/implementing-dispose).
- For more information about and , see [Cleaning Up Unmanaged Resources](/dotnet/standard/garbage-collection/unmanaged) and [Overriding the Finalize Method](https://docs.microsoft.com/previous-versions/dotnet/netframework-4.0/ddae83kx(v=vs.100)).
+ For more information about and , see [Cleaning Up Unmanaged Resources](/dotnet/standard/garbage-collection/unmanaged) and [Overriding the Finalize Method](previous-versions/dotnet/netframework-4.0/ddae83kx(v=vs.100)).
Generating Commands with CommandBuilders
ADO.NET Overview
diff --git a/xml/System.Diagnostics.Tracing/EventSource.xml b/xml/System.Diagnostics.Tracing/EventSource.xml
index 8e52cc70a7d..4ea11c971d4 100644
--- a/xml/System.Diagnostics.Tracing/EventSource.xml
+++ b/xml/System.Diagnostics.Tracing/EventSource.xml
@@ -694,7 +694,8 @@ The following example shows an implementation of method, if it has been overridden). `Dispose()` invokes the protected `Dispose(Boolean)` method with the `disposing` parameter set to `true`. `Finalize` invokes `Dispose` with `disposing` set to `false`.
When the `disposing` parameter is `true`, this method releases all resources held by any managed objects that this references. This method invokes the `Dispose()` method of each referenced object.
diff --git a/xml/System.Diagnostics/EventLog.xml b/xml/System.Diagnostics/EventLog.xml
index 27846c40a9a..b81ffc61b9d 100644
--- a/xml/System.Diagnostics/EventLog.xml
+++ b/xml/System.Diagnostics/EventLog.xml
@@ -1503,8 +1503,9 @@ SVC_UPDATE.EXE
method. `Dispose()` invokes the protected `Dispose(Boolean)` method with the `disposing` parameter set to `true`. invokes `Dispose` with `disposing` set to `false`.
+## Remarks
+
+This method is called by the public `Dispose()` method (and the method, if it has been overridden). `Dispose()` invokes the protected `Dispose(Boolean)` method with the `disposing` parameter set to `true`. `Finalize` invokes `Dispose` with `disposing` set to `false`.
When the `disposing` parameter is true, this method releases all resources held by any managed objects that this references. This method invokes the `Dispose()` method of each referenced object.
diff --git a/xml/System.Diagnostics/TraceListener.xml b/xml/System.Diagnostics/TraceListener.xml
index 341fa6c462b..83e065b9c88 100644
--- a/xml/System.Diagnostics/TraceListener.xml
+++ b/xml/System.Diagnostics/TraceListener.xml
@@ -417,7 +417,7 @@
method and the method. `Dispose` invokes the protected method with the `disposing` parameter set to `true`. invokes `Dispose` with `disposing` set to `false`.
+ This method is called by the public method and the method, if it has been overridden. `Dispose` invokes the protected method with the `disposing` parameter set to `true`. `Finalize` invokes `Dispose` with `disposing` set to `false`.
When the `disposing` parameter is `true`, this method releases all resources held by any managed objects that this references. This method invokes the `Dispose` method of each referenced object.
diff --git a/xml/System.DirectoryServices/DirectoryEntry.xml b/xml/System.DirectoryServices/DirectoryEntry.xml
index c07945c81e5..7f31d92544a 100644
--- a/xml/System.DirectoryServices/DirectoryEntry.xml
+++ b/xml/System.DirectoryServices/DirectoryEntry.xml
@@ -599,17 +599,15 @@ int main()
method and the method. invokes the protected method with the `disposing` parameter set to `true`. invokes with `disposing` set to `false`.
+ This method is called by the public `Dispose()` method and the method, if it has been overridden. `Dispose()` invokes the protected method with the `disposing` parameter set to `true`. `Finalize` invokes `Dispose` with `disposing` set to `false`.
- When the `disposing` parameter is `true`, this method releases all resources that are held by any managed objects that this object references. This method invokes the method of each referenced object.
-
- For more information about the and methods, see [Overriding the Finalize Method](https://docs.microsoft.com/previous-versions/dotnet/netframework-4.0/ddae83kx(v=vs.100)).
+ When the `disposing` parameter is `true`, this method releases all resources that are held by any managed objects that this object references. This method invokes the `Dispose()` method of each referenced object.
]]>
- can be called multiple times by other objects. When overriding , be careful not to reference objects that have been previously disposed of in an earlier call to . For more information about how to implement , see [Implementing a Dispose Method](/dotnet/standard/garbage-collection/implementing-dispose).
+ can be called multiple times by other objects. When overriding , be careful not to reference objects that have been previously disposed of in an earlier call to . For more information about how to implement `Dispose`, see [Implementing a Dispose Method](/dotnet/standard/garbage-collection/implementing-dispose).
diff --git a/xml/System.DirectoryServices/SearchResultCollection.xml b/xml/System.DirectoryServices/SearchResultCollection.xml
index cf5914c7807..9d97275199a 100644
--- a/xml/System.DirectoryServices/SearchResultCollection.xml
+++ b/xml/System.DirectoryServices/SearchResultCollection.xml
@@ -191,7 +191,7 @@
method and the method. invokes the protected method with the `disposing` parameter set to `true`. invokes with the `disposing` parameter set to `false`.
+ This method is called by the public method and the method, if it has been overridden. invokes the protected method with the `disposing` parameter set to `true`. `Finalize` invokes with the `disposing` parameter set to `false`.
When the `disposing` parameter is `true`, this method releases all resources that are held by any managed objects that this references.
diff --git a/xml/System.Drawing.Text/FontCollection.xml b/xml/System.Drawing.Text/FontCollection.xml
index de9f0dc2923..0cea647adb5 100644
--- a/xml/System.Drawing.Text/FontCollection.xml
+++ b/xml/System.Drawing.Text/FontCollection.xml
@@ -138,7 +138,8 @@
method. `Dispose()` invokes the protected `Dispose(Boolean)` method with the `disposing` parameter set to `true`. invokes `Dispose` with `disposing` set to `false`.
+
+This method is called by the public `Dispose()` method (and the method, if it has been overridden). `Dispose()` invokes the protected `Dispose(Boolean)` method with the `disposing` parameter set to `true`. `Finalize` invokes `Dispose` with `disposing` set to `false`.
When the `disposing` parameter is true, this method releases all resources held by any managed objects that this references. This method invokes the `Dispose()` method of each referenced object.
diff --git a/xml/System.Drawing/Brush.xml b/xml/System.Drawing/Brush.xml
index fa0cdc07835..97537995998 100644
--- a/xml/System.Drawing/Brush.xml
+++ b/xml/System.Drawing/Brush.xml
@@ -215,7 +215,8 @@
method. `Dispose()` invokes the protected `Dispose(Boolean)` method with the `disposing` parameter set to `true`. invokes `Dispose` with `disposing` set to `false`.
+
+This method is called by the public `Dispose()` method (and the method, if it has been overridden). `Dispose()` invokes the protected `Dispose(Boolean)` method with the `disposing` parameter set to `true`. `Finalize` invokes `Dispose` with `disposing` set to `false`.
When the `disposing` parameter is true, this method releases all resources held by any managed objects that this references. This method invokes the `Dispose()` method of each referenced object.
diff --git a/xml/System.EnterpriseServices.Internal/AppDomainHelper.xml b/xml/System.EnterpriseServices.Internal/AppDomainHelper.xml
index 8dff226df51..415a7033874 100644
--- a/xml/System.EnterpriseServices.Internal/AppDomainHelper.xml
+++ b/xml/System.EnterpriseServices.Internal/AppDomainHelper.xml
@@ -76,9 +76,7 @@
. Application code should not call this method; an object's method is automatically invoked during garbage collection, unless finalization by the garbage collector has been disabled by a call to the method.
-
- For more information about and , see [Finalize Methods and Destructors](https://docs.microsoft.com/previous-versions/dotnet/netframework-4.0/0s71x931(v%3dvs.100)), [Cleaning Up Unmanaged Resources](/dotnet/standard/garbage-collection/unmanaged), and [Overriding the Finalize Method](https://docs.microsoft.com/previous-versions/dotnet/netframework-4.0/ddae83kx(v=vs.100)).
+ This method overrides . Application code should not call this method; an object's method is automatically invoked during garbage collection, unless finalization by the garbage collector has been disabled by a call to the method.
]]>
diff --git a/xml/System.EnterpriseServices/ServicedComponent.xml b/xml/System.EnterpriseServices/ServicedComponent.xml
index 3096d3a28b8..d56cc51c5fd 100644
--- a/xml/System.EnterpriseServices/ServicedComponent.xml
+++ b/xml/System.EnterpriseServices/ServicedComponent.xml
@@ -295,7 +295,8 @@ regsvcs Calculator.dll
method. `Dispose` invokes the protected `Dispose(Boolean)` method with the `disposing` parameter set to `true`. invokes `Dispose` with `disposing` set to `false`.
+
+This method is called by the public `Dispose()` method (and the method, if it has been overridden). `Dispose()` invokes the protected `Dispose(Boolean)` method with the `disposing` parameter set to `true`. `Finalize` invokes `Dispose` with `disposing` set to `false`.
When the `disposing` parameter is `true`, this method releases all resources held by any managed objects that this references. This method invokes the `Dispose` method of each referenced object.
diff --git a/xml/System.IO.Compression/DeflateStream.xml b/xml/System.IO.Compression/DeflateStream.xml
index 0a09c096f27..99dd42c591c 100644
--- a/xml/System.IO.Compression/DeflateStream.xml
+++ b/xml/System.IO.Compression/DeflateStream.xml
@@ -768,9 +768,9 @@ Copying begins at the current position in the current Deflate stream.
## Remarks
- This method is called by the public method and the method. invokes the protected method with the `disposing` parameter set to `true`. invokes with `disposing` set to `false`.
+ This method is called by the public `Dispose()` method and the method, if it has been overridden. `Dispose()` invokes the protected method with the `disposing` parameter set to `true`. `Finalize` invokes with `disposing` set to `false`.
- When the `disposing` parameter is `true`, this method releases all resources held by any managed objects that this references. This method invokes the method of each referenced object.
+ When the `disposing` parameter is `true`, this method releases all resources held by any managed objects that this references. This method invokes the `Dispose()` method of each referenced object.
]]>
diff --git a/xml/System.IO.Compression/GZipStream.xml b/xml/System.IO.Compression/GZipStream.xml
index 3420610dd76..42e7a91a2c0 100644
--- a/xml/System.IO.Compression/GZipStream.xml
+++ b/xml/System.IO.Compression/GZipStream.xml
@@ -800,9 +800,9 @@ Copying begins at the current position in the current GZip stream.
method and the method. invokes the protected method with the `disposing` parameter set to `true`. invokes with `disposing` set to `false`.
+ This method is called by the public `Dispose()` method and the method, if it has been overridden. `Dispose()` invokes the protected method with the `disposing` parameter set to `true`. `Finalize` invokes with `disposing` set to `false`.
- When the `disposing` parameter is `true`, this method releases all resources held by any managed objects that this references. This method invokes the method of each referenced object.
+ When the `disposing` parameter is `true`, this method releases all resources held by any managed objects that this references. This method invokes the `Dispose()` method of each referenced object.
]]>
diff --git a/xml/System.IO.IsolatedStorage/IsolatedStorageFileStream.xml b/xml/System.IO.IsolatedStorage/IsolatedStorageFileStream.xml
index b0b2015624e..15b11be35d2 100644
--- a/xml/System.IO.IsolatedStorage/IsolatedStorageFileStream.xml
+++ b/xml/System.IO.IsolatedStorage/IsolatedStorageFileStream.xml
@@ -1044,7 +1044,7 @@ Dim source As New IsolatedStorageFileStream(UserName,FileMode.Open,isoFile)
method and the method. invokes the protected method with the `disposing` parameter set to true. invokes with `disposing` set to false.
+ This method is called by the public method and the method, if it has been overridden. invokes the protected method with the `disposing` parameter set to true. `Finalize` invokes with `disposing` set to false.
When the `disposing` parameter is true, this method releases all resources held by any managed objects that this references. This method invokes the method of each referenced object.
diff --git a/xml/System.IO.Packaging/EncryptedPackageEnvelope.xml b/xml/System.IO.Packaging/EncryptedPackageEnvelope.xml
index f52a1ebd84d..0950919203b 100644
--- a/xml/System.IO.Packaging/EncryptedPackageEnvelope.xml
+++ b/xml/System.IO.Packaging/EncryptedPackageEnvelope.xml
@@ -382,8 +382,9 @@
method. `Dispose()` invokes the protected `Dispose(Boolean)` method with the `disposing` parameter set to `true`. invokes `Dispose` with `disposing` set to `false`.
+## Remarks
+
+This method is called by the public `Dispose()` method (and the method, if it has been overridden). `Dispose()` invokes the protected `Dispose(Boolean)` method with the `disposing` parameter set to `true`. `Finalize` invokes `Dispose` with `disposing` set to `false`.
When the `disposing` parameter is true, this method releases all resources held by any managed objects that this references. This method invokes the `Dispose()` method of each referenced object.
diff --git a/xml/System.IO.Packaging/PackageProperties.xml b/xml/System.IO.Packaging/PackageProperties.xml
index aa001cca4a6..8f9ce8ec1ac 100644
--- a/xml/System.IO.Packaging/PackageProperties.xml
+++ b/xml/System.IO.Packaging/PackageProperties.xml
@@ -396,8 +396,9 @@
method. `Dispose()` invokes the protected `Dispose(Boolean)` method with the `disposing` parameter set to `true`. invokes `Dispose` with `disposing` set to `false`.
+## Remarks
+
+This method is called by the public `Dispose()` method (and the method, if it has been overridden). `Dispose()` invokes the protected `Dispose(Boolean)` method with the `disposing` parameter set to `true`. `Finalize` invokes `Dispose` with `disposing` set to `false`.
When the `disposing` parameter is true, this method releases all resources held by any managed objects that this references. This method invokes the `Dispose()` method of each referenced object.
diff --git a/xml/System.IO.Pipes/PipeStream.xml b/xml/System.IO.Pipes/PipeStream.xml
index 5ca90c28937..5b71b01f518 100644
--- a/xml/System.IO.Pipes/PipeStream.xml
+++ b/xml/System.IO.Pipes/PipeStream.xml
@@ -655,7 +655,10 @@
method and the method. invokes the protected method with the `disposing` parameter set to `true`. invokes with `disposing` set to `false`. When the disposing parameter is `true`, this method releases all resources held by any managed objects that this object references. This method invokes the method of each referenced object.
+
+This method is called by the public `Dispose()` method and the method, if it has been overridden. `Dispose()` invokes the protected method with the `disposing` parameter set to `true`. `Finalize` invokes with `disposing` set to `false`.
+
+When the disposing parameter is `true`, this method releases all resources held by any managed objects that this object references. This method invokes the method of each referenced object.
]]>
diff --git a/xml/System.IO.Ports/SerialPort.xml b/xml/System.IO.Ports/SerialPort.xml
index 1b3ceec4d09..b04c08732e5 100644
--- a/xml/System.IO.Ports/SerialPort.xml
+++ b/xml/System.IO.Ports/SerialPort.xml
@@ -1142,9 +1142,9 @@
method and the method. invokes the protected method with the `disposing` parameter set to `true`. invokes with `disposing` set to `false`.
+ This method is called by the public `Dispose()` method and the method, if it has been overridden. `Dispose()` invokes the protected method with the `disposing` parameter set to `true`. `Finalize` invokes with `disposing` set to `false`.
- When the `disposing` parameter is `true`, this method releases all resources held by any managed objects that this references. This method invokes the method of each referenced object.
+ When the `disposing` parameter is `true`, this method releases all resources held by any managed objects that this references. This method invokes the `Dispose()` method of each referenced object.
This method flushes and closes the stream object in the property.
diff --git a/xml/System.IO/BinaryReader.xml b/xml/System.IO/BinaryReader.xml
index 64a5e0df821..4de2bcd830d 100644
--- a/xml/System.IO/BinaryReader.xml
+++ b/xml/System.IO/BinaryReader.xml
@@ -553,7 +553,7 @@
. By default, this method specifies the `disposing` parameter as `true`. specifies the `disposing` parameter as `false`.
+ This method is called by `Dispose` and . By default, this method specifies the `disposing` parameter as `true`. `Finalize` specifies the `disposing` parameter as `false`.
When the `disposing` parameter is `true`, this method releases all resources held by any managed objects that this references. This method invokes the `Dispose` method of each referenced object.
diff --git a/xml/System.IO/BufferedStream.xml b/xml/System.IO/BufferedStream.xml
index 4a74b27adf4..b1a24e26e34 100644
--- a/xml/System.IO/BufferedStream.xml
+++ b/xml/System.IO/BufferedStream.xml
@@ -866,7 +866,7 @@ You should release all resources by specifying `true` for `disposing`. When `dis
If your stream is using an operating system handle to communicate with its source, consider using a subclass of for this purpose.
-This method is called by the public method and the method. invokes the protected `Dispose(Boolean)` method with the `disposing` parameter set to `true`. invokes `Dispose(Boolean)` with `disposing` set to `false`.
+This method is called by the public `Dispose()` method and the method, if it has been overridden. `Dispose()` invokes the protected `Dispose(Boolean)` method with the `disposing` parameter set to `true`. `Finalize` invokes `Dispose(Boolean)` with `disposing` set to `false`.
]]>
diff --git a/xml/System.IO/FileStream.xml b/xml/System.IO/FileStream.xml
index 16a2e20b75a..964597fe126 100644
--- a/xml/System.IO/FileStream.xml
+++ b/xml/System.IO/FileStream.xml
@@ -2260,9 +2260,9 @@ For an example of copying between two streams, see the method and the method. invokes the protected method with the `disposing` parameter set to `true`. invokes with `disposing` set to `false`.
+ This method is called by the public `Dispose()` method and the method, if it has been overridden. `Dispose()` invokes the protected method with the `disposing` parameter set to `true`. `Finalize` invokes with `disposing` set to `false`.
- When the `disposing` parameter is `true`, this method releases all resources held by any managed objects that this references. This method invokes the method of each referenced object.
+ When the `disposing` parameter is `true`, this method releases all resources held by any managed objects that this references. This method invokes the `Dispose()` method of each referenced object.
]]>
diff --git a/xml/System.IO/FileSystemWatcher.xml b/xml/System.IO/FileSystemWatcher.xml
index cf1f4fa28e8..1beadcca30d 100644
--- a/xml/System.IO/FileSystemWatcher.xml
+++ b/xml/System.IO/FileSystemWatcher.xml
@@ -754,9 +754,9 @@
method and the method. invokes the protected method with the `disposing` parameter set to `true`. invokes with `disposing` set to `false`.
+ This method is called by the public `Dispose()` method and the method, if it has been overridden. `Dispose()` invokes the protected method with the `disposing` parameter set to `true`. `Finalize` invokes with `disposing` set to `false`.
- When the `disposing` parameter is `true`, this method releases all resources held by any managed objects that this references. This method invokes the method of each referenced object.
+ When the `disposing` parameter is `true`, this method releases all resources held by any managed objects that this references. This method invokes the `Dispose()` method of each referenced object.
]]>
diff --git a/xml/System.IO/MemoryStream.xml b/xml/System.IO/MemoryStream.xml
index 83b3ccda135..ccb2d0cc344 100644
--- a/xml/System.IO/MemoryStream.xml
+++ b/xml/System.IO/MemoryStream.xml
@@ -1192,9 +1192,9 @@ The stream is unwritable.
method and the method. invokes the protected method with the `disposing` parameter set to `true`. invokes with `disposing` set to `false`.
+ This method is called by the public `Dispose()` method and the method, if it has been overridden. `Dispose()` invokes the protected method with the `disposing` parameter set to `true`. `Finalize` invokes with `disposing` set to `false`.
- When the `disposing` parameter is `true`, this method releases all resources held by any managed objects that this references. This method invokes the method of each referenced object.
+ When the `disposing` parameter is `true`, this method releases all resources held by any managed objects that this references. This method invokes the `Dispose()` method of each referenced object.
]]>
diff --git a/xml/System.IO/Stream.xml b/xml/System.IO/Stream.xml
index 98e6e08664c..ffab1f59222 100644
--- a/xml/System.IO/Stream.xml
+++ b/xml/System.IO/Stream.xml
@@ -1272,7 +1272,7 @@
If your stream is using an operating system handle to communicate with its source, consider using a subclass of for this purpose.
- This method is called by the public method and the method. invokes the protected method with the `disposing` parameter set to `true`. invokes with `disposing` set to `false`.
+ This method is called by the public `Dispose()` method and the method, if it has been overridden. `Dispose()` invokes the protected method with the `disposing` parameter set to `true`. `Finalize` invokes with `disposing` set to `false`.
]]>
diff --git a/xml/System.IO/StreamReader.xml b/xml/System.IO/StreamReader.xml
index eec3825ba80..572f773432c 100644
--- a/xml/System.IO/StreamReader.xml
+++ b/xml/System.IO/StreamReader.xml
@@ -1472,7 +1472,7 @@ Following a call to , any operations on th
method and the method. invokes the protected method with the `disposing` parameter set to true. invokes with `disposing` set to false.
+ This method is called by the public method and the method, if it has been overridden. invokes the protected method with the `disposing` parameter set to true. `Finalize` invokes with `disposing` set to false.
When the `disposing` parameter is `true`, this method releases all resources held by any managed objects that the object references. This method invokes the method of each referenced object.
diff --git a/xml/System.IO/TextReader.xml b/xml/System.IO/TextReader.xml
index b217c134711..9ddb574fa0a 100644
--- a/xml/System.IO/TextReader.xml
+++ b/xml/System.IO/TextReader.xml
@@ -345,7 +345,8 @@
method. By default, this method specifies the `disposing` parameter as `true`. specifies the `disposing` parameter as `false`.
+
+This method is called by the public `Dispose()` method and the method, if it has been overridden. `Dispose()` invokes the protected `Dispose(Boolean)` method with the `disposing` parameter set to `true`. `Finalize` invokes `Dispose` with `disposing` set to `false`.
When the `disposing` parameter is `true`, this method releases all resources held by any managed objects that this references. This method invokes the `Dispose` method of each referenced object.
diff --git a/xml/System.IO/TextWriter.xml b/xml/System.IO/TextWriter.xml
index 170f346828d..2ab5132fcdc 100644
--- a/xml/System.IO/TextWriter.xml
+++ b/xml/System.IO/TextWriter.xml
@@ -493,7 +493,7 @@
. By default, this method specifies the `disposing` parameter as `true`. specifies the `disposing` parameter as `false`.
+ This method is called by `Dispose` and . By default, this method specifies the `disposing` parameter as `true`. `Finalize` specifies the `disposing` parameter as `false`.
When the `disposing` parameter is `true`, this method releases all resources held by any managed objects that this references. This method invokes the `Dispose` method of each referenced object.
diff --git a/xml/System.IO/UnmanagedMemoryAccessor.xml b/xml/System.IO/UnmanagedMemoryAccessor.xml
index 982ea89d3f0..56735ab1fd5 100644
--- a/xml/System.IO/UnmanagedMemoryAccessor.xml
+++ b/xml/System.IO/UnmanagedMemoryAccessor.xml
@@ -455,8 +455,9 @@
method. `Dispose()` invokes the protected `Dispose(Boolean)` method with the `disposing` parameter set to `true`. invokes `Dispose` with `disposing` set to `false`.
+## Remarks
+
+This method is called by the public `Dispose()` method (and the method, if it has been overridden). `Dispose()` invokes the protected `Dispose(Boolean)` method with the `disposing` parameter set to `true`. `Finalize` invokes `Dispose` with `disposing` set to `false`.
When the `disposing` parameter is true, this method releases all resources held by any managed objects that this references. This method invokes the `Dispose()` method of each referenced object.
diff --git a/xml/System.IO/UnmanagedMemoryStream.xml b/xml/System.IO/UnmanagedMemoryStream.xml
index a7949861cfc..e9f55c9a4dc 100644
--- a/xml/System.IO/UnmanagedMemoryStream.xml
+++ b/xml/System.IO/UnmanagedMemoryStream.xml
@@ -709,9 +709,9 @@
method and the method. invokes the protected method with the `disposing` parameter set to `true`. invokes with `disposing` set to `false`.
+ This method is called by the public `Dispose()` method and the method, if it has been overridden. `Dispose()` invokes the protected method with the `disposing` parameter set to `true`. `Finalize` invokes with `disposing` set to `false`.
- When the `disposing` parameter is `true`, this method releases all resources held by any managed objects that this references. This method invokes the method of each referenced object.
+ When the `disposing` parameter is `true`, this method releases all resources held by any managed objects that this references. This method invokes the `Dispose()` method of each referenced object.
]]>
diff --git a/xml/System.Messaging/MessageEnumerator.xml b/xml/System.Messaging/MessageEnumerator.xml
index fc71ae547b4..ff2d458334f 100644
--- a/xml/System.Messaging/MessageEnumerator.xml
+++ b/xml/System.Messaging/MessageEnumerator.xml
@@ -231,7 +231,7 @@
method and the method. `Dispose()` invokes the protected `Dispose(Boolean)` method with the `disposing` parameter set to `true`. invokes `Dispose` with `disposing` set to `false`.
+ This method is called by the public method and the method, if it has been overridden. `Dispose()` invokes the protected `Dispose(Boolean)` method with the `disposing` parameter set to `true`. `Finalize` invokes `Dispose` with `disposing` set to `false`.
When the `disposing` parameter is `true`, this method releases all resources held by any managed objects that this references. This method invokes the `Dispose()` method of each referenced object.
diff --git a/xml/System.Messaging/MessageQueueEnumerator.xml b/xml/System.Messaging/MessageQueueEnumerator.xml
index 781d426c75d..569c4e0ea1d 100644
--- a/xml/System.Messaging/MessageQueueEnumerator.xml
+++ b/xml/System.Messaging/MessageQueueEnumerator.xml
@@ -190,7 +190,7 @@
method and the method. `Dispose` invokes the protected `Dispose(Boolean)` method with the `disposing` parameter set to `true`. invokes `Dispose` with `disposing` set to `false`.
+ This method is called by the public method and the method, if it has been overridden. `Dispose` invokes the protected `Dispose(Boolean)` method with the `disposing` parameter set to `true`. `Finalize` invokes `Dispose` with `disposing` set to `false`.
When the `disposing` parameter is `true`, this method releases all resources held by any managed objects that this references. This method invokes the `Dispose` method of each referenced object.
diff --git a/xml/System.Messaging/MessageQueueTransaction.xml b/xml/System.Messaging/MessageQueueTransaction.xml
index c3799d815c6..afba692202b 100644
--- a/xml/System.Messaging/MessageQueueTransaction.xml
+++ b/xml/System.Messaging/MessageQueueTransaction.xml
@@ -258,7 +258,7 @@
method and the method. `Dispose` invokes the protected `Dispose(Boolean)` method with the `disposing` parameter set to `true`. invokes `Dispose` with `disposing` set to `false`.
+ This method is called by the public method and the method, if it has been overridden. `Dispose` invokes the protected `Dispose(Boolean)` method with the `disposing` parameter set to `true`. `Finalize` invokes `Dispose` with `disposing` set to `false`.
When the `disposing` parameter is `true`, this method releases all resources held by any managed objects that this references. This method invokes the `Dispose` method of each referenced object.
diff --git a/xml/System.Net.Http/HttpClient.xml b/xml/System.Net.Http/HttpClient.xml
index f7863475b14..89a0299be19 100644
--- a/xml/System.Net.Http/HttpClient.xml
+++ b/xml/System.Net.Http/HttpClient.xml
@@ -918,8 +918,9 @@ The is not an absolute URI.
method. `Dispose()` invokes the protected `Dispose(Boolean)` method with the `disposing` parameter set to `true`. invokes `Dispose` with `disposing` set to `false`.
+## Remarks
+
+This method is called by the public `Dispose()` method (and the method, if it has been overridden). `Dispose()` invokes the protected `Dispose(Boolean)` method with the `disposing` parameter set to `true`. `Finalize` invokes `Dispose` with `disposing` set to `false`.
When the `disposing` parameter is `true`, this method releases all resources held by any managed objects that this references. This method invokes the `Dispose()` method of each referenced object.
diff --git a/xml/System.Net.Http/HttpClientHandler.xml b/xml/System.Net.Http/HttpClientHandler.xml
index 748ce9678e4..0353551dab1 100644
--- a/xml/System.Net.Http/HttpClientHandler.xml
+++ b/xml/System.Net.Http/HttpClientHandler.xml
@@ -569,7 +569,8 @@ handler.ServerCertificateCustomValidationCallback = HttpClientHandler.DangerousA
method. `Dispose()` invokes the protected `Dispose(Boolean)` method with the `disposing` parameter set to `true`. invokes `Dispose` with `disposing` set to `false`.
+
+This method is called by the public `Dispose()` method (and the method, if it has been overridden). `Dispose()` invokes the protected `Dispose(Boolean)` method with the `disposing` parameter set to `true`. `Finalize` invokes `Dispose` with `disposing` set to `false`.
When the `disposing` parameter is `true`, this method releases all resources held by any managed objects that this references. This method invokes the `Dispose()` method of each referenced object.
diff --git a/xml/System.Net.Http/HttpContent.xml b/xml/System.Net.Http/HttpContent.xml
index fd54bf9bc5d..0aa0dab9f80 100644
--- a/xml/System.Net.Http/HttpContent.xml
+++ b/xml/System.Net.Http/HttpContent.xml
@@ -535,8 +535,11 @@ Once the operation completes, the returned memory stream represents the HTTP con
method. `Dispose()` invokes the protected `Dispose(Boolean)` method with the `disposing` parameter set to `true`. invokes `Dispose` with `disposing` set to `false`.When the `disposing` parameter is `true`, this method releases all resources held by any managed objects that this references. This method invokes the `Dispose()` method of each referenced object.
+## Remarks
+
+This method is called by the public `Dispose()` method (and the method, if it has been overridden). `Dispose()` invokes the protected `Dispose(Boolean)` method with the `disposing` parameter set to `true`. `Finalize` invokes `Dispose` with `disposing` set to `false`.
+
+When the `disposing` parameter is `true`, this method releases all resources held by any managed objects that this references. This method invokes the `Dispose()` method of each referenced object.
]]>
diff --git a/xml/System.Net.Http/HttpMessageHandler.xml b/xml/System.Net.Http/HttpMessageHandler.xml
index 7d67a69191e..37dd148e39d 100644
--- a/xml/System.Net.Http/HttpMessageHandler.xml
+++ b/xml/System.Net.Http/HttpMessageHandler.xml
@@ -176,8 +176,11 @@
method. `Dispose()` invokes the protected `Dispose(Boolean)` method with the `disposing` parameter set to `true`. invokes `Dispose` with `disposing` set to `false`.When the `disposing` parameter is `true`, this method releases all resources held by any managed objects that this references. This method invokes the `Dispose()` method of each referenced object.
+## Remarks
+
+This method is called by the public `Dispose()` method (and the method, if it has been overridden). `Dispose()` invokes the protected `Dispose(Boolean)` method with the `disposing` parameter set to `true`. `Finalize` invokes `Dispose` with `disposing` set to `false`.
+
+When the `disposing` parameter is `true`, this method releases all resources held by any managed objects that this references. This method invokes the `Dispose()` method of each referenced object.
]]>
diff --git a/xml/System.Net.Http/HttpRequestMessage.xml b/xml/System.Net.Http/HttpRequestMessage.xml
index 549dc3091b1..5c19c853f24 100644
--- a/xml/System.Net.Http/HttpRequestMessage.xml
+++ b/xml/System.Net.Http/HttpRequestMessage.xml
@@ -315,8 +315,11 @@
method. `Dispose()` invokes the protected `Dispose(Boolean)` method with the `disposing` parameter set to `true`. invokes `Dispose` with `disposing` set to `false`.When the `disposing` parameter is `true`, this method releases all resources held by any managed objects that this references. This method invokes the `Dispose()` method of each referenced object.
+## Remarks
+
+This method is called by the public `Dispose()` method (and the method, if it has been overridden). `Dispose()` invokes the protected `Dispose(Boolean)` method with the `disposing` parameter set to `true`. `Finalize` invokes `Dispose` with `disposing` set to `false`.
+
+When the `disposing` parameter is `true`, this method releases all resources held by any managed objects that this references. This method invokes the `Dispose()` method of each referenced object.
]]>
diff --git a/xml/System.Net.Http/HttpResponseMessage.xml b/xml/System.Net.Http/HttpResponseMessage.xml
index be46fb3bb7d..dc88ba69443 100644
--- a/xml/System.Net.Http/HttpResponseMessage.xml
+++ b/xml/System.Net.Http/HttpResponseMessage.xml
@@ -265,9 +265,12 @@
method. `Dispose()` invokes the protected `Dispose(Boolean)` method with the `disposing` parameter set to `true`. invokes `Dispose` with `disposing` set to `false`.When the `disposing` parameter is `true`, this method releases all resources held by any managed objects that this references. This method invokes the `Dispose()` method of each referenced object.
+Disposing a response that's in progress can signal to the server that the response is no longer needed. This signal depends on the implementation or protocol.
+
+This method is called by the public `Dispose()` method (and the method, if it has been overridden). `Dispose()` invokes the protected `Dispose(Boolean)` method with the `disposing` parameter set to `true`. `Finalize` invokes `Dispose` with `disposing` set to `false`.
+
+When the `disposing` parameter is `true`, this method releases all resources held by any managed objects that this references. This method invokes the `Dispose()` method of each referenced object.
]]>
diff --git a/xml/System.Net.Http/MultipartContent.xml b/xml/System.Net.Http/MultipartContent.xml
index 08627b197db..f8236d4d0ad 100644
--- a/xml/System.Net.Http/MultipartContent.xml
+++ b/xml/System.Net.Http/MultipartContent.xml
@@ -359,8 +359,11 @@ This method overrides
method. `Dispose()` invokes the protected `Dispose(Boolean)` method with the `disposing` parameter set to `true`. invokes `Dispose` with `disposing` set to `false`.When the `disposing` parameter is `true`, this method releases all resources held by any managed objects that this references. This method invokes the `Dispose()` method of each referenced object.
+## Remarks
+
+This method is called by the public `Dispose()` method (and the method, if it has been overridden). `Dispose()` invokes the protected `Dispose(Boolean)` method with the `disposing` parameter set to `true`. `Finalize` invokes `Dispose` with `disposing` set to `false`.
+
+When the `disposing` parameter is `true`, this method releases all resources held by any managed objects that this references. This method invokes the `Dispose()` method of each referenced object.
]]>
diff --git a/xml/System.Net.Http/StreamContent.xml b/xml/System.Net.Http/StreamContent.xml
index 39928ccd982..732fd03061c 100644
--- a/xml/System.Net.Http/StreamContent.xml
+++ b/xml/System.Net.Http/StreamContent.xml
@@ -238,8 +238,11 @@ The object calls
method. `Dispose()` invokes the protected `Dispose(Boolean)` method with the `disposing` parameter set to `true`. invokes `Dispose` with `disposing` set to `false`.When the `disposing` parameter is `true`, this method releases all resources held by any managed objects that this references. This method invokes the `Dispose()` method of each referenced object.
+## Remarks
+
+This method is called by the public `Dispose()` method (and the method, if it has been overridden). `Dispose()` invokes the protected `Dispose(Boolean)` method with the `disposing` parameter set to `true`. `Finalize` invokes `Dispose` with `disposing` set to `false`.
+
+When the `disposing` parameter is `true`, this method releases all resources held by any managed objects that this references. This method invokes the `Dispose()` method of each referenced object.
]]>
diff --git a/xml/System.Net.Mail/AlternateView.xml b/xml/System.Net.Mail/AlternateView.xml
index ae70bc32adc..816e8439ac4 100644
--- a/xml/System.Net.Mail/AlternateView.xml
+++ b/xml/System.Net.Mail/AlternateView.xml
@@ -647,8 +647,9 @@
method. `Dispose()` invokes the protected `Dispose(Boolean)` method with the `disposing` parameter set to `true`. invokes `Dispose` with `disposing` set to `false`.
+## Remarks
+
+This method is called by the public `Dispose()` method (and the method, if it has been overridden). `Dispose()` invokes the protected `Dispose(Boolean)` method with the `disposing` parameter set to `true`. `Finalize` invokes `Dispose` with `disposing` set to `false`.
When the `disposing` parameter is true, this method releases all resources held by any managed objects that this references. This method invokes the `Dispose()` method of each referenced object.
diff --git a/xml/System.Net.Mail/AttachmentBase.xml b/xml/System.Net.Mail/AttachmentBase.xml
index 28a25f6c50c..95f334d653e 100644
--- a/xml/System.Net.Mail/AttachmentBase.xml
+++ b/xml/System.Net.Mail/AttachmentBase.xml
@@ -525,8 +525,9 @@
method. `Dispose()` invokes the protected `Dispose(Boolean)` method with the `disposing` parameter set to `true`. invokes `Dispose` with `disposing` set to `false`.
+## Remarks
+
+This method is called by the public `Dispose()` method (and the method, if it has been overridden). `Dispose()` invokes the protected `Dispose(Boolean)` method with the `disposing` parameter set to `true`. `Finalize` invokes `Dispose` with `disposing` set to `false`.
When the `disposing` parameter is true, this method releases all resources held by any managed objects that this references. This method invokes the `Dispose()` method of each referenced object.
diff --git a/xml/System.Net.Mail/MailMessage.xml b/xml/System.Net.Mail/MailMessage.xml
index 4a4547ddcf7..5941cedf6c8 100644
--- a/xml/System.Net.Mail/MailMessage.xml
+++ b/xml/System.Net.Mail/MailMessage.xml
@@ -918,8 +918,9 @@
method. `Dispose()` invokes the protected `Dispose(Boolean)` method with the `disposing` parameter set to `true`. invokes `Dispose` with `disposing` set to `false`.
+## Remarks
+
+This method is called by the public `Dispose()` method (and the method, if it has been overridden). `Dispose()` invokes the protected `Dispose(Boolean)` method with the `disposing` parameter set to `true`. `Finalize` invokes `Dispose` with `disposing` set to `false`.
When the `disposing` parameter is true, this method releases all resources held by any managed objects that this references. This method invokes the `Dispose()` method of each referenced object.
diff --git a/xml/System.Net.NetworkInformation/Ping.xml b/xml/System.Net.NetworkInformation/Ping.xml
index 6328a5aa3fb..96616ff37eb 100644
--- a/xml/System.Net.NetworkInformation/Ping.xml
+++ b/xml/System.Net.NetworkInformation/Ping.xml
@@ -239,7 +239,7 @@
method. The public `Dispose()` method invokes the protected method with the `disposing` parameter set to `true`. invokes `Dispose` with `disposing` set to `false`.
+ This method is called by the public `Dispose()` method and the method, if it has been overridden. The public `Dispose()` method invokes the protected method with the `disposing` parameter set to `true`. `Finalize` invokes `Dispose` with `disposing` set to `false`.
When the `disposing` parameter is `true`, this method releases all resources held by any managed objects that this object references. This method invokes the `Dispose()` method of each referenced object.
diff --git a/xml/System.Net.PeerToPeer.Collaboration/Peer.xml b/xml/System.Net.PeerToPeer.Collaboration/Peer.xml
index efbeadddac4..ed51c9bbbdb 100644
--- a/xml/System.Net.PeerToPeer.Collaboration/Peer.xml
+++ b/xml/System.Net.PeerToPeer.Collaboration/Peer.xml
@@ -603,7 +603,7 @@
Multiple invitations may be outstanding at any given time. If the method is called when an asynchronous operation identified by the `userToken` is not in existence, an exception is thrown. The `userToken` object must be provided since it is used to track a specific asynchronous call. This host application-supplied object is unique for each invite request.
- When this method is used, the event can still be raised, but the Cancelled property on the associated object will be set to `true.`
+ When this method is used, the event can still be raised, but the Cancelled property on the associated object will be set to `true`.
Calling this method requires a of .
diff --git a/xml/System.Net.Security/AuthenticatedStream.xml b/xml/System.Net.Security/AuthenticatedStream.xml
index cca2128a93d..8a1ce28977f 100644
--- a/xml/System.Net.Security/AuthenticatedStream.xml
+++ b/xml/System.Net.Security/AuthenticatedStream.xml
@@ -160,8 +160,9 @@ The following example demonstrates displaying the properties of an authenticated
method. `Dispose()` invokes the protected `Dispose(Boolean)` method with the `disposing` parameter set to `true`. invokes `Dispose` with `disposing` set to `false`.
+## Remarks
+
+This method is called by the public `Dispose()` method (and the method, if it has been overridden). `Dispose()` invokes the protected `Dispose(Boolean)` method with the `disposing` parameter set to `true`. `Finalize` invokes `Dispose` with `disposing` set to `false`.
When the `disposing` parameter is true, this method releases all resources held by any managed objects that this references. This method invokes the `Dispose()` method of each referenced object.
diff --git a/xml/System.Net.Security/NegotiateStream.xml b/xml/System.Net.Security/NegotiateStream.xml
index a522ba7cd4e..4c262eb752a 100644
--- a/xml/System.Net.Security/NegotiateStream.xml
+++ b/xml/System.Net.Security/NegotiateStream.xml
@@ -2797,8 +2797,9 @@ The following method is called when the operation completes.
method. `Dispose()` invokes the protected `Dispose(Boolean)` method with the `disposing` parameter set to `true`. invokes `Dispose` with `disposing` set to `false`.
+## Remarks
+
+This method is called by the public `Dispose()` method (and the method, if it has been overridden). `Dispose()` invokes the protected `Dispose(Boolean)` method with the `disposing` parameter set to `true`. `Finalize` invokes `Dispose` with `disposing` set to `false`.
When the `disposing` parameter is true, this method releases all resources held by any managed objects that this references. This method invokes the `Dispose()` method of each referenced object.
diff --git a/xml/System.Net.Security/SslStream.xml b/xml/System.Net.Security/SslStream.xml
index f952b449004..75320cc1f06 100644
--- a/xml/System.Net.Security/SslStream.xml
+++ b/xml/System.Net.Security/SslStream.xml
@@ -2789,8 +2789,9 @@
method. `Dispose()` invokes the protected `Dispose(Boolean)` method with the `disposing` parameter set to `true`. invokes `Dispose` with `disposing` set to `false`.
+## Remarks
+
+This method is called by the public `Dispose()` method (and the method, if it has been overridden). `Dispose()` invokes the protected `Dispose(Boolean)` method with the `disposing` parameter set to `true`. `Finalize` invokes `Dispose` with `disposing` set to `false`.
When the `disposing` parameter is true, this method releases all resources held by any managed objects that this references. This method invokes the `Dispose()` method of each referenced object.
diff --git a/xml/System.Net.Sockets/NetworkStream.xml b/xml/System.Net.Sockets/NetworkStream.xml
index 15d695132dd..856d85e18b2 100644
--- a/xml/System.Net.Sockets/NetworkStream.xml
+++ b/xml/System.Net.Sockets/NetworkStream.xml
@@ -1054,7 +1054,8 @@ The Close method frees both unmanaged and managed resources associated with the
method. `Dispose` invokes the protected `Dispose(Boolean)` method with the `disposing` parameter set to `true`. invokes `Dispose` with `disposing` set to `false`.
+
+This method is called by the public `Dispose()` method (and the method, if it has been overridden). `Dispose()` invokes the protected `Dispose(Boolean)` method with the `disposing` parameter set to `true`. `Finalize` invokes `Dispose` with `disposing` set to `false`.
When the `disposing` parameter is `true`, this method releases all resources held by any managed objects that this references. This method invokes the `Dispose` method of each referenced object.
diff --git a/xml/System.Net.Sockets/Socket.xml b/xml/System.Net.Sockets/Socket.xml
index e3336c8047d..9639e2e9af4 100644
--- a/xml/System.Net.Sockets/Socket.xml
+++ b/xml/System.Net.Sockets/Socket.xml
@@ -4662,7 +4662,8 @@ This method populates the instance with data ga
method. `Dispose()` invokes the protected `Dispose(Boolean)` method with the `disposing` parameter set to `true`. invokes `Dispose` with `disposing` set to `false`.
+
+This method is called by the public `Dispose()` method (and the method, if it has been overridden). `Dispose()` invokes the protected `Dispose(Boolean)` method with the `disposing` parameter set to `true`. `Finalize` invokes `Dispose` with `disposing` set to `false`.
When the `disposing` parameter is `true`, this method releases all resources held by any managed objects that this references. This method invokes the `Dispose()` method of each referenced object.
diff --git a/xml/System.Net.Sockets/SocketAsyncEventArgs.xml b/xml/System.Net.Sockets/SocketAsyncEventArgs.xml
index 3b670324b32..ee721e83c9b 100644
--- a/xml/System.Net.Sockets/SocketAsyncEventArgs.xml
+++ b/xml/System.Net.Sockets/SocketAsyncEventArgs.xml
@@ -794,8 +794,9 @@
method. `Dispose()` invokes the protected `Dispose(Boolean)` method with the `disposing` parameter set to `true`. invokes `Dispose` with `disposing` set to `false`.
+## Remarks
+
+This method is called by the public `Dispose()` method (and the method, if it has been overridden). `Dispose()` invokes the protected `Dispose(Boolean)` method with the `disposing` parameter set to `true`. `Finalize` invokes `Dispose` with `disposing` set to `false`.
When the `disposing` parameter is `true`, this method releases all resources held by any managed objects that this references. This method invokes the `Dispose()` method of each referenced object.
diff --git a/xml/System.Net.Sockets/TcpClient.xml b/xml/System.Net.Sockets/TcpClient.xml
index a4032a7e94e..fab0f005ff9 100644
--- a/xml/System.Net.Sockets/TcpClient.xml
+++ b/xml/System.Net.Sockets/TcpClient.xml
@@ -1680,7 +1680,7 @@ The `Available` property is a way to determine whether data is queued for readin
method. `Dispose()` invokes this method with the `disposing` parameter set to `true`. `Finalize` invokes this method with `disposing` set to `false`.
+ This method is called by the public `Dispose()` method and the method, if it has been overridden. `Dispose()` invokes this method with the `disposing` parameter set to `true`. `Finalize` invokes this method with `disposing` set to `false`.
When the `disposing` parameter is `true`, this method releases all resources held by any managed objects that this references. It does this by invoking the `Dispose()` method of each referenced object.
diff --git a/xml/System.Net.Sockets/UdpClient.xml b/xml/System.Net.Sockets/UdpClient.xml
index b1114170d74..d5f9522b83f 100644
--- a/xml/System.Net.Sockets/UdpClient.xml
+++ b/xml/System.Net.Sockets/UdpClient.xml
@@ -1402,8 +1402,9 @@
method. `Dispose()` invokes the protected `Dispose(Boolean)` method with the `disposing` parameter set to `true`. invokes `Dispose` with `disposing` set to `false`.
+## Remarks
+
+This method is called by the public `Dispose()` method (and the method, if it has been overridden). `Dispose()` invokes the protected `Dispose(Boolean)` method with the `disposing` parameter set to `true`. `Finalize` invokes `Dispose` with `disposing` set to `false`.
When the `disposing` parameter is true, this method releases all resources held by any managed objects that this references. This method invokes the `Dispose()` method of each referenced object.
diff --git a/xml/System.Net/HttpWebResponse.xml b/xml/System.Net/HttpWebResponse.xml
index 9809ef7efa3..d420d2aa1d4 100644
--- a/xml/System.Net/HttpWebResponse.xml
+++ b/xml/System.Net/HttpWebResponse.xml
@@ -661,8 +661,9 @@ The contents of the response from the Internet resource are returned as a
method. `Dispose()` invokes the protected `Dispose(Boolean)` method with the `disposing` parameter set to `true`. invokes `Dispose` with `disposing` set to `false`.
+## Remarks
+
+This method is called by the public `Dispose()` method (and the method, if it has been overridden). `Dispose()` invokes the protected `Dispose(Boolean)` method with the `disposing` parameter set to `true`. `Finalize` invokes `Dispose` with `disposing` set to `false`.
When the `disposing` parameter is `true`, this method releases all resources held by any managed objects that this references. This method invokes the `Dispose()` method of each referenced object.
diff --git a/xml/System.Net/WebResponse.xml b/xml/System.Net/WebResponse.xml
index 9e6dc61e7b7..1a15c736864 100644
--- a/xml/System.Net/WebResponse.xml
+++ b/xml/System.Net/WebResponse.xml
@@ -511,8 +511,9 @@
method. `Dispose()` invokes the protected `Dispose(Boolean)` method with the `disposing` parameter set to `true`. invokes `Dispose` with `disposing` set to `false`.
+## Remarks
+
+This method is called by the public `Dispose()` method (and the method, if it has been overridden). `Dispose()` invokes the protected `Dispose(Boolean)` method with the `disposing` parameter set to `true`. `Finalize` invokes `Dispose` with `disposing` set to `false`.
When the `disposing` parameter is `true`, this method releases all resources held by any managed objects that this references. This method invokes the `Dispose()` method of each referenced object.
diff --git a/xml/System.Printing.IndexedProperties/PrintProperty.xml b/xml/System.Printing.IndexedProperties/PrintProperty.xml
index 0c3d9ec5126..95f13a03e2c 100644
--- a/xml/System.Printing.IndexedProperties/PrintProperty.xml
+++ b/xml/System.Printing.IndexedProperties/PrintProperty.xml
@@ -163,7 +163,7 @@
method. `Dispose()` invokes the protected `Dispose(Boolean)` method with the unnamed Boolean parameter set to `true`. invokes `Dispose` with the parameter set to `false`.
+ This method is called by the public `Dispose()` method and the method, if it has been overridden. `Dispose()` invokes the protected `Dispose(Boolean)` method with the unnamed Boolean parameter set to `true`. `Finalize` invokes `Dispose` with the parameter set to `false`.
When the Boolean parameter is `true`, this method releases all resources held by any managed objects that this references. This method invokes the `Dispose()` method of each referenced object.
diff --git a/xml/System.Printing.IndexedProperties/PrintPropertyDictionary.xml b/xml/System.Printing.IndexedProperties/PrintPropertyDictionary.xml
index 0348ded4590..0e3de4472c2 100644
--- a/xml/System.Printing.IndexedProperties/PrintPropertyDictionary.xml
+++ b/xml/System.Printing.IndexedProperties/PrintPropertyDictionary.xml
@@ -267,7 +267,7 @@
method and the method. invokes the protected method with the unnamed Boolean parameter set to `true`. invokes with the parameter set to `false`.
+ This method is called by the public method and the method, if it has been overridden. invokes the protected method with the unnamed Boolean parameter set to `true`. `Finalize` invokes with the parameter set to `false`.
When the Boolean parameter is `true`, this method releases all the resources that are held by any managed objects that this references. This method invokes the `Dispose()` method of each referenced object.
diff --git a/xml/System.Printing/PrintJobInfoCollection.xml b/xml/System.Printing/PrintJobInfoCollection.xml
index d99495c0adb..e6471a1e1ed 100644
--- a/xml/System.Printing/PrintJobInfoCollection.xml
+++ b/xml/System.Printing/PrintJobInfoCollection.xml
@@ -149,7 +149,7 @@
method. `Dispose()` invokes the protected `Dispose(Boolean)` method with the unnamed Boolean parameter set to `true`. invokes `Dispose` with the parameter set to `false`.
+ This method is called by the public `Dispose()` method and the method, if it has been overridden. `Dispose()` invokes the protected `Dispose(Boolean)` method with the unnamed Boolean parameter set to `true`. `Finalize` invokes `Dispose` with the parameter set to `false`.
When the Boolean parameter is true, this method releases all resources held by any managed objects that this references. This method invokes the `Dispose()` method of each referenced object.
diff --git a/xml/System.Printing/PrintQueueCollection.xml b/xml/System.Printing/PrintQueueCollection.xml
index fb9fabdce1b..7a211d404b7 100644
--- a/xml/System.Printing/PrintQueueCollection.xml
+++ b/xml/System.Printing/PrintQueueCollection.xml
@@ -225,7 +225,7 @@
method. `Dispose()` invokes the protected `Dispose(Boolean)` method with the unnamed Boolean parameter set to `true`. invokes `Dispose` with the parameter set to `false`.
+ This method is called by the public `Dispose()` method and the method, if it has been overridden. `Dispose()` invokes the protected `Dispose(Boolean)` method with the unnamed Boolean parameter set to `true`. `Finalize` invokes `Dispose` with the parameter set to `false`.
When the Boolean parameter is `true`, this method releases all resources that are held by any managed objects that this references. This method invokes the `Dispose()` method of each referenced object.
diff --git a/xml/System.Printing/PrintQueueStream.xml b/xml/System.Printing/PrintQueueStream.xml
index 446a17702b4..5da01bbae5e 100644
--- a/xml/System.Printing/PrintQueueStream.xml
+++ b/xml/System.Printing/PrintQueueStream.xml
@@ -339,7 +339,7 @@
method. `Dispose()` invokes the protected `Dispose(Boolean)` method with the unnamed Boolean parameter set to `true`. invokes `Dispose` with the unnamed Boolean parameter set to `false`.
+ This method is called by the method. `Dispose()` invokes the protected `Dispose(Boolean)` method with the unnamed Boolean parameter set to `true`. `Finalize` invokes `Dispose` with the unnamed Boolean parameter set to `false`.
When the unnamed Boolean parameter is `true`, this method releases all resources that are held by any managed objects that this references. This method invokes the `Dispose()` method of each referenced object.
diff --git a/xml/System.Printing/PrintSystemObject.xml b/xml/System.Printing/PrintSystemObject.xml
index 8cd8ce428c9..488eb5c4d04 100644
--- a/xml/System.Printing/PrintSystemObject.xml
+++ b/xml/System.Printing/PrintSystemObject.xml
@@ -259,7 +259,7 @@
method. `Dispose()` invokes the protected `Dispose(Boolean)` method with the unnamed Boolean parameter set to `true`. invokes `Dispose` with the parameter set to `false`.
+ This method is called by the public `Dispose()` method and the method, if it has been overridden. `Dispose()` invokes the protected `Dispose(Boolean)` method with the unnamed Boolean parameter set to `true`. `Finalize` invokes `Dispose` with the parameter set to `false`.
When the Boolean parameter is `true`, this method releases all resources held by any managed objects that this references. This method invokes the `Dispose()` method of each referenced object.
diff --git a/xml/System.Printing/PrintSystemObjectPropertiesChangedEventArgs.xml b/xml/System.Printing/PrintSystemObjectPropertiesChangedEventArgs.xml
index 978317acb2f..d57dff36dee 100644
--- a/xml/System.Printing/PrintSystemObjectPropertiesChangedEventArgs.xml
+++ b/xml/System.Printing/PrintSystemObjectPropertiesChangedEventArgs.xml
@@ -151,7 +151,7 @@
method. `Dispose()` invokes the protected `Dispose(Boolean)` method with the unnamed Boolean parameter set to `true`. invokes `Dispose` with the parameter set to `false`.
+ This method is called by the method. `Dispose()` invokes the protected `Dispose(Boolean)` method with the unnamed Boolean parameter set to `true`. `Finalize` invokes `Dispose` with the parameter set to `false`.
When the Boolean parameter is `true`, this method releases all resources that are held by any managed objects that this references. This method invokes the `Dispose()` method of each referenced object.
diff --git a/xml/System.Printing/PrintSystemObjectPropertyChangedEventArgs.xml b/xml/System.Printing/PrintSystemObjectPropertyChangedEventArgs.xml
index e7313ab0fbe..1515e0f3d5f 100644
--- a/xml/System.Printing/PrintSystemObjectPropertyChangedEventArgs.xml
+++ b/xml/System.Printing/PrintSystemObjectPropertyChangedEventArgs.xml
@@ -151,7 +151,7 @@
method. `Dispose()` invokes the protected `Dispose(Boolean)` method with the unnamed Boolean parameter set to `true`. invokes `Dispose` with the parameter set to `false`.
+ This method is called by the method. `Dispose()` invokes the protected `Dispose(Boolean)` method with the unnamed Boolean parameter set to `true`. `Finalize` invokes `Dispose` with the parameter set to `false`.
When the Boolean parameter is `true`, this method releases all resources held by any managed objects that this references. This method invokes the `Dispose()` method of each referenced object.
diff --git a/xml/System.Printing/PrintSystemObjects.xml b/xml/System.Printing/PrintSystemObjects.xml
index fb92828aee9..e5c5f79bd0d 100644
--- a/xml/System.Printing/PrintSystemObjects.xml
+++ b/xml/System.Printing/PrintSystemObjects.xml
@@ -154,7 +154,7 @@
method and the method. invokes the protected method with the unnamed Boolean parameter set to `true`. invokes with the parameter set to `false`.
+ This method is called by the public method and the method, if it has been overridden. invokes the protected method with the unnamed Boolean parameter set to `true`. `Finalize` invokes with the parameter set to `false`.
When the Boolean parameter is `true`, this method releases all resources held by any managed objects that this references. This method invokes the `Dispose()` method of each referenced object.
diff --git a/xml/System.Resources/ResXResourceReader.xml b/xml/System.Resources/ResXResourceReader.xml
index a10b7332d24..0903f6034b0 100644
--- a/xml/System.Resources/ResXResourceReader.xml
+++ b/xml/System.Resources/ResXResourceReader.xml
@@ -533,7 +533,7 @@
method or the method. invokes this method with the `disposing` parameter set to `true`. invokes this method with `disposing` set to `false`.
+ This method can be called by either the method or the method. invokes this method with the `disposing` parameter set to `true`. `Finalize` invokes this method with `disposing` set to `false`.
When the `disposing` parameter is `true`, this method releases all resources held by any managed objects that this references. This method invokes the `Dispose` method of each referenced object.
diff --git a/xml/System.Resources/ResXResourceWriter.xml b/xml/System.Resources/ResXResourceWriter.xml
index 7920fcd1cc5..56632923a7b 100644
--- a/xml/System.Resources/ResXResourceWriter.xml
+++ b/xml/System.Resources/ResXResourceWriter.xml
@@ -849,7 +849,7 @@
## Remarks
The method calls the method, if necessary, before releasing managed and unmanaged system resources.
- This method is called by the public method and the method. `Dispose()` invokes the protected `Dispose(Boolean)` method with the `disposing` parameter set to `true`. invokes `Dispose` with `disposing` set to `false`.
+ This method is called by the public method and the method, if it has been overridden. `Dispose()` invokes the protected `Dispose(Boolean)` method with the `disposing` parameter set to `true`. `Finalize` invokes `Dispose` with `disposing` set to `false`.
When the `disposing` parameter is `true`, this method releases all resources held by any managed objects that this references. This method invokes the `Dispose()` method of each referenced object.
diff --git a/xml/System.Security.Cryptography/AsymmetricAlgorithm.xml b/xml/System.Security.Cryptography/AsymmetricAlgorithm.xml
index 4f1f64368da..f9863d5647e 100644
--- a/xml/System.Security.Cryptography/AsymmetricAlgorithm.xml
+++ b/xml/System.Security.Cryptography/AsymmetricAlgorithm.xml
@@ -503,7 +503,7 @@ This method is obsolete in .NET 5 and later versions.
method, if it has been overridden. `Dispose()` invokes the protected `Dispose(Boolean)` method with the `disposing` parameter set to `true`. `Finalize` invokes `Dispose` with `disposing` set to `false`.
When the `disposing` parameter is `true`, this method releases all resources held by any managed objects that this references. This method invokes the `Dispose()` method of each referenced object.
diff --git a/xml/System.Security.Cryptography/CryptoStream.xml b/xml/System.Security.Cryptography/CryptoStream.xml
index 2f4b9a68866..58567e65b02 100644
--- a/xml/System.Security.Cryptography/CryptoStream.xml
+++ b/xml/System.Security.Cryptography/CryptoStream.xml
@@ -701,7 +701,7 @@ Copying begins at the current position in the current stream, and does not reset
method, if it has been overridden. `Dispose()` invokes the protected `Dispose(Boolean)` method with the disposing parameter set to `true`. `Finalize` invokes `Dispose` with disposing set to `false`.
When the `disposing` parameter is `true`, this method releases all resources held by any managed objects that this references. This method invokes the `Dispose()` method of each referenced object.
diff --git a/xml/System.Security.Cryptography/DeriveBytes.xml b/xml/System.Security.Cryptography/DeriveBytes.xml
index a48ada0bb25..0692cb63407 100644
--- a/xml/System.Security.Cryptography/DeriveBytes.xml
+++ b/xml/System.Security.Cryptography/DeriveBytes.xml
@@ -227,7 +227,8 @@
method, if it has been overridden). `Dispose()` invokes the protected `Dispose(Boolean)` method with the `disposing` parameter set to `true`. `Finalize` invokes `Dispose` with `disposing` set to `false`.
When the `disposing` parameter is `true`, this method releases all resources held by any managed objects that this references. This method invokes the `Dispose()` method of each referenced object.
diff --git a/xml/System.Security.Cryptography/ECDiffieHellmanPublicKey.xml b/xml/System.Security.Cryptography/ECDiffieHellmanPublicKey.xml
index f6ad498d355..54bca2aa1f2 100644
--- a/xml/System.Security.Cryptography/ECDiffieHellmanPublicKey.xml
+++ b/xml/System.Security.Cryptography/ECDiffieHellmanPublicKey.xml
@@ -261,8 +261,9 @@
- If `disposing` equals `false`, the method has been called by the runtime from inside the finalizer, and you should not reference managed resources. Only unmanaged resources can be disposed.
If you need to provide cleanup code for managed and unmanaged resources that an object created, you should override this method.
-
- This method is called by the public `Dispose()` method and the method. `Dispose()` invokes the protected `Dispose(Boolean)` method with the `disposing` parameter set to `true`. invokes `Dispose` with `disposing` set to `false`.
+
+
+This method is called by the public `Dispose()` method (and the method, if it has been overridden). `Dispose()` invokes the protected `Dispose(Boolean)` method with the `disposing` parameter set to `true`. `Finalize` invokes `Dispose` with `disposing` set to `false`.
When the `disposing` parameter is true, this method releases all resources held by any managed objects that this references. This method invokes the `Dispose()` method of each referenced object.
diff --git a/xml/System.Security.Cryptography/FromBase64Transform.xml b/xml/System.Security.Cryptography/FromBase64Transform.xml
index a11e0eb6d73..fda90e70c51 100644
--- a/xml/System.Security.Cryptography/FromBase64Transform.xml
+++ b/xml/System.Security.Cryptography/FromBase64Transform.xml
@@ -444,7 +444,7 @@
method, if it has been overridden. `Dispose()` invokes the protected `Dispose(Boolean)` method with the disposing parameter set to `true`. `Finalize` invokes `Dispose` with disposing set to `false`.
When the `disposing` parameter is `true`, this method releases all resources held by any managed objects that this references. This method invokes the `Dispose()` method of each referenced object.
diff --git a/xml/System.Security.Cryptography/HMAC.xml b/xml/System.Security.Cryptography/HMAC.xml
index 4eaaa391ec3..dd5c135d9b3 100644
--- a/xml/System.Security.Cryptography/HMAC.xml
+++ b/xml/System.Security.Cryptography/HMAC.xml
@@ -378,7 +378,7 @@ This method is obsolete in .NET 5 and later versions.
method, if it has been overridden. `Dispose()` invokes the protected `Dispose(Boolean)` method with the `disposing` parameter set to `true`. `Finalize` invokes `Dispose` with `disposing` set to `false`.
When the `disposing` parameter is `true`, this method releases all resources held by any managed objects that this references. This method invokes the `Dispose()` method of each referenced object.
diff --git a/xml/System.Security.Cryptography/HashAlgorithm.xml b/xml/System.Security.Cryptography/HashAlgorithm.xml
index ba396bdc211..80e9a53c6b1 100644
--- a/xml/System.Security.Cryptography/HashAlgorithm.xml
+++ b/xml/System.Security.Cryptography/HashAlgorithm.xml
@@ -788,7 +788,7 @@ This method is obsolete in .NET 5 and later versions.
method, if it has been overridden. `Dispose()` invokes the protected `Dispose(Boolean)` method with the `disposing` parameter set to `true`. `Finalize` invokes `Dispose` with `disposing` set to `false`.
When the `disposing` parameter is `true`, this method releases all resources held by any managed objects that this references. This method invokes the `Dispose()` method of each referenced object.
diff --git a/xml/System.Security.Cryptography/KeyedHashAlgorithm.xml b/xml/System.Security.Cryptography/KeyedHashAlgorithm.xml
index 594a1c8034c..b1d6ac4d37c 100644
--- a/xml/System.Security.Cryptography/KeyedHashAlgorithm.xml
+++ b/xml/System.Security.Cryptography/KeyedHashAlgorithm.xml
@@ -350,7 +350,7 @@ This method supports a number of algorithms, including MD5, SHA-1, SHA-256, and
method, if it has been overridden. `Dispose()` invokes the protected `Dispose(Boolean)` method with the `disposing` parameter set to `true`. `Finalize` invokes `Dispose` with `disposing` set to `false`.
When the `disposing` parameter is `true`, this method releases all resources held by any managed objects that this references. This method invokes the `Dispose()` method of each referenced object.
diff --git a/xml/System.Security.Cryptography/MACTripleDES.xml b/xml/System.Security.Cryptography/MACTripleDES.xml
index 406d9f56b24..d9f119a2474 100644
--- a/xml/System.Security.Cryptography/MACTripleDES.xml
+++ b/xml/System.Security.Cryptography/MACTripleDES.xml
@@ -204,7 +204,7 @@
method, if it has been overridden. `Dispose()` invokes the protected `Dispose(Boolean)` method with the disposing parameter set to `true`. `Finalize` invokes `Dispose` with disposing set to `false`.
When the `disposing` parameter is `true`, this method releases all resources held by any managed objects that this references. This method invokes the `Dispose()` method of each referenced object.
diff --git a/xml/System.Security.Cryptography/PasswordDeriveBytes.xml b/xml/System.Security.Cryptography/PasswordDeriveBytes.xml
index c3078ec56ef..72a5de516c0 100644
--- a/xml/System.Security.Cryptography/PasswordDeriveBytes.xml
+++ b/xml/System.Security.Cryptography/PasswordDeriveBytes.xml
@@ -779,7 +779,8 @@
method, if it has been overridden). `Dispose()` invokes the protected `Dispose(Boolean)` method with the `disposing` parameter set to `true`. `Finalize` invokes `Dispose` with `disposing` set to `false`.
When the `disposing` parameter is `true`, this method releases all resources held by any managed objects that this references. This method invokes the `Dispose()` method of each referenced object.
diff --git a/xml/System.Security.Cryptography/RandomNumberGenerator.xml b/xml/System.Security.Cryptography/RandomNumberGenerator.xml
index 91ac414b19e..5964f1e6620 100644
--- a/xml/System.Security.Cryptography/RandomNumberGenerator.xml
+++ b/xml/System.Security.Cryptography/RandomNumberGenerator.xml
@@ -370,7 +370,7 @@ To create a random number generator, call the @System.Security.Cryptography.Rand
method, if it has been overridden. `Dispose()` invokes the protected `Dispose(Boolean)` method with the `disposing` parameter set to `true`. `Finalize` invokes `Dispose` with `disposing` set to `false`.
When the `disposing` parameter is `true`, this method releases all resources held by any managed objects that this references. This method invokes the `Dispose()` method of each referenced object.
diff --git a/xml/System.Security.Cryptography/Rfc2898DeriveBytes.xml b/xml/System.Security.Cryptography/Rfc2898DeriveBytes.xml
index f90683a26b2..9af8e2f6add 100644
--- a/xml/System.Security.Cryptography/Rfc2898DeriveBytes.xml
+++ b/xml/System.Security.Cryptography/Rfc2898DeriveBytes.xml
@@ -738,7 +738,8 @@ For more information about PBKDF2, see [RFC 2898](https://www.rfc-editor.org/inf
method, if it has been overridden). `Dispose()` invokes the protected `Dispose(Boolean)` method with the `disposing` parameter set to `true`. `Finalize` invokes `Dispose` with `disposing` set to `false`.
When the `disposing` parameter is `true`, this method releases all resources held by any managed objects that this references. This method invokes the `Dispose()` method of each referenced object.
diff --git a/xml/System.Security.Cryptography/SymmetricAlgorithm.xml b/xml/System.Security.Cryptography/SymmetricAlgorithm.xml
index bc4d853039e..0c2954f6897 100644
--- a/xml/System.Security.Cryptography/SymmetricAlgorithm.xml
+++ b/xml/System.Security.Cryptography/SymmetricAlgorithm.xml
@@ -1287,7 +1287,7 @@ This method's behavior is defined by method, if it has been overridden. `Dispose()` invokes the protected `Dispose(Boolean)` method with the `disposing` parameter set to `true`. `Finalize` invokes `Dispose` with `disposing` set to `false`.
When the `disposing` parameter is `true`, this method releases all resources held by any managed objects that this references. This method invokes the `Dispose()` method of each referenced object.
diff --git a/xml/System.Security.Cryptography/ToBase64Transform.xml b/xml/System.Security.Cryptography/ToBase64Transform.xml
index 937beceb925..d45ce8de331 100644
--- a/xml/System.Security.Cryptography/ToBase64Transform.xml
+++ b/xml/System.Security.Cryptography/ToBase64Transform.xml
@@ -399,7 +399,7 @@
method, if it has been overridden. `Dispose()` invokes the protected `Dispose(Boolean)` method with the disposing parameter set to `true`. `Finalize` invokes `Dispose` with disposing set to `false`.
When the `disposing` parameter is `true`, this method releases all resources held by any managed objects that this references. This method invokes the `Dispose()` method of each referenced object.
@@ -613,7 +613,7 @@
method, if it has been overridden. `Dispose()` invokes the protected `Dispose(Boolean)` method with the disposing parameter set to `true`. `Finalize` invokes `Dispose` with disposing set to `false`.
When the disposing parameter is `true`, this method releases all resources held by any managed objects that this references. This method invokes the `Dispose()` method of each referenced object.
diff --git a/xml/System.Security.Cryptography/TripleDESCng.xml b/xml/System.Security.Cryptography/TripleDESCng.xml
index 5f3df9b7aad..825c3414ab1 100644
--- a/xml/System.Security.Cryptography/TripleDESCng.xml
+++ b/xml/System.Security.Cryptography/TripleDESCng.xml
@@ -584,7 +584,7 @@
method, if it has been overridden. `Dispose()` invokes the protected `Dispose(Boolean)` method with the `disposing` parameter set to `true`. `Finalize` invokes `Dispose` with `disposing` set to `false`.
When the `disposing` parameter is `true`, this method releases all resources held by any managed objects that this references. This method invokes the `Dispose()` method of each referenced object.
diff --git a/xml/System.Security.Principal/WindowsIdentity.xml b/xml/System.Security.Principal/WindowsIdentity.xml
index 0705dfc58cf..ab222c11cce 100644
--- a/xml/System.Security.Principal/WindowsIdentity.xml
+++ b/xml/System.Security.Principal/WindowsIdentity.xml
@@ -945,8 +945,9 @@
method. `Dispose()` invokes the protected `Dispose(Boolean)` method with the `disposing` parameter set to `true`. invokes `Dispose` with `disposing` set to `false`.
+## Remarks
+
+This method is called by the public `Dispose()` method (and the method, if it has been overridden). `Dispose()` invokes the protected `Dispose(Boolean)` method with the `disposing` parameter set to `true`. `Finalize` invokes `Dispose` with `disposing` set to `false`.
When the `disposing` parameter is `true`, this method releases all resources held by any managed objects that this references. This method invokes the `Dispose()` method of each referenced object.
diff --git a/xml/System.Security.Principal/WindowsImpersonationContext.xml b/xml/System.Security.Principal/WindowsImpersonationContext.xml
index e30431781c4..d36fc6440f1 100644
--- a/xml/System.Security.Principal/WindowsImpersonationContext.xml
+++ b/xml/System.Security.Principal/WindowsImpersonationContext.xml
@@ -148,8 +148,9 @@
method. `Dispose()` invokes the protected `Dispose(Boolean)` method with the `disposing` parameter set to `true`. invokes `Dispose` with `disposing` set to `false`.
+## Remarks
+
+This method is called by the public `Dispose()` method (and the method, if it has been overridden). `Dispose()` invokes the protected `Dispose(Boolean)` method with the `disposing` parameter set to `true`. `Finalize` invokes `Dispose` with `disposing` set to `false`.
When the `disposing` parameter is true, this method releases all resources held by any managed objects that this references. This method invokes the `Dispose()` method of each referenced object.
diff --git a/xml/System.Security.RightsManagement/CryptoProvider.xml b/xml/System.Security.RightsManagement/CryptoProvider.xml
index 28ac853178a..286d7f1fa7b 100644
--- a/xml/System.Security.RightsManagement/CryptoProvider.xml
+++ b/xml/System.Security.RightsManagement/CryptoProvider.xml
@@ -369,8 +369,9 @@
method. `Dispose()` invokes the protected `Dispose(Boolean)` method with the `disposing` parameter set to `true`. invokes `Dispose` with `disposing` set to `false`.
+## Remarks
+
+This method is called by the public `Dispose()` method (and the method, if it has been overridden). `Dispose()` invokes the protected `Dispose(Boolean)` method with the `disposing` parameter set to `true`. `Finalize` invokes `Dispose` with `disposing` set to `false`.
When the `disposing` parameter is true, this method releases all resources held by any managed objects that this references. This method invokes the `Dispose()` method of each referenced object.
diff --git a/xml/System.Security.RightsManagement/SecureEnvironment.xml b/xml/System.Security.RightsManagement/SecureEnvironment.xml
index 28f70f746ca..bf82fe5cfb7 100644
--- a/xml/System.Security.RightsManagement/SecureEnvironment.xml
+++ b/xml/System.Security.RightsManagement/SecureEnvironment.xml
@@ -279,7 +279,7 @@
method and the method. invokes the protected method with the `disposing` parameter set to `true`. invokes `Dispose` with `disposing` set to `false`.
+ This method is called by the public method and the method, if it has been overridden. invokes the protected method with the `disposing` parameter set to `true`. `Finalize` invokes `Dispose` with `disposing` set to `false`.
When the `disposing` parameter is `true`, this method releases all resources held by any managed objects that this references. This method invokes the `Dispose()` method of each referenced object.
diff --git a/xml/System.ServiceProcess/ServiceController.xml b/xml/System.ServiceProcess/ServiceController.xml
index 8a9e4e2fc84..0447b53b32c 100644
--- a/xml/System.ServiceProcess/ServiceController.xml
+++ b/xml/System.ServiceProcess/ServiceController.xml
@@ -679,8 +679,9 @@
method. `Dispose()` invokes the protected `Dispose(Boolean)` method with the `disposing` parameter set to `true`. invokes `Dispose` with `disposing` set to `false`.
+## Remarks
+
+This method is called by the public `Dispose()` method (and the method, if it has been overridden). `Dispose()` invokes the protected `Dispose(Boolean)` method with the `disposing` parameter set to `true`. `Finalize` invokes `Dispose` with `disposing` set to `false`.
When the `disposing` parameter is true, this method releases all resources held by any managed objects that this references. This method invokes the `Dispose()` method of each referenced object.
diff --git a/xml/System.Web.ClientServices/ClientFormsIdentity.xml b/xml/System.Web.ClientServices/ClientFormsIdentity.xml
index 5807d9e6076..1241e9ff913 100644
--- a/xml/System.Web.ClientServices/ClientFormsIdentity.xml
+++ b/xml/System.Web.ClientServices/ClientFormsIdentity.xml
@@ -254,8 +254,9 @@
method. `Dispose()` invokes the protected `Dispose(Boolean)` method with the `disposing` parameter set to `true`. invokes `Dispose` with `disposing` set to `false`.
+## Remarks
+
+This method is called by the public `Dispose()` method (and the method, if it has been overridden). `Dispose()` invokes the protected `Dispose(Boolean)` method with the `disposing` parameter set to `true`. `Finalize` invokes `Dispose` with `disposing` set to `false`.
When the `disposing` parameter is true, this method releases all resources held by any managed objects that this references. This method invokes the `Dispose()` method of each referenced object.
diff --git a/xml/System.Web.Security/ActiveDirectoryMembershipProvider.xml b/xml/System.Web.Security/ActiveDirectoryMembershipProvider.xml
index 13550410db3..17aa8f3019d 100644
--- a/xml/System.Web.Security/ActiveDirectoryMembershipProvider.xml
+++ b/xml/System.Web.Security/ActiveDirectoryMembershipProvider.xml
@@ -373,7 +373,7 @@
In order to use the method, you must set these additional attributes in your application's configuration file:
-- `requiresQuestionAndAnswer` must be `true.`
+- `requiresQuestionAndAnswer` must be `true`.
- `attributeMapPasswordQuestion` and `attributeMapPasswordAnswer` must be mapped to attributes in the Active Directory schema.
diff --git a/xml/System.Web.UI.Design.WebControls/RegexEditorDialog.xml b/xml/System.Web.UI.Design.WebControls/RegexEditorDialog.xml
index 4ed4e94c438..1accc048b2e 100644
--- a/xml/System.Web.UI.Design.WebControls/RegexEditorDialog.xml
+++ b/xml/System.Web.UI.Design.WebControls/RegexEditorDialog.xml
@@ -176,7 +176,7 @@
method and the method. invokes the protected method with the `disposing` parameter set to `true`. invokes `Dispose` with `disposing` set to `false`.
+ This method is called by the public `Dispose()` method and the method, if it has been overridden. `Dispose()` invokes the protected method with the `disposing` parameter set to `true`. `Finalize` invokes `Dispose` with `disposing` set to `false`.
When the `disposing` parameter is `true`, this method releases all resources held by any managed objects that this references. This method invokes the `Dispose()` method of each referenced object.
diff --git a/xml/System.Web.UI.Design.WebControls/XmlDesigner.xml b/xml/System.Web.UI.Design.WebControls/XmlDesigner.xml
index 00899d61c09..31e2e03ea65 100644
--- a/xml/System.Web.UI.Design.WebControls/XmlDesigner.xml
+++ b/xml/System.Web.UI.Design.WebControls/XmlDesigner.xml
@@ -85,7 +85,7 @@
> [!NOTE]
> Always call before you release your last reference to the . Otherwise, the resources it is using will not be freed until the garbage collector calls the object's `Finalize` method.
- The method is called by the public `Dispose()` method and the method. The `Dispose()` invokes the protected `Dispose(Boolean)` method with `disposing` set to `true`. The invokes `Dispose` with `disposing` set to `false`.
+ The method is called by the public `Dispose()` method and the method, if it has been overridden. The `Dispose()` invokes the protected `Dispose(Boolean)` method with `disposing` set to `true`. The `Finalize` invokes `Dispose` with `disposing` set to `false`.
When `disposing` is `true`, the method releases all resources that are held by any managed objects that this references. The method invokes the `Dispose()` method of each referenced object.
diff --git a/xml/System.Web.UI.Design/ExtenderControlDesigner.xml b/xml/System.Web.UI.Design/ExtenderControlDesigner.xml
index 2560061c72d..60d6f334c27 100644
--- a/xml/System.Web.UI.Design/ExtenderControlDesigner.xml
+++ b/xml/System.Web.UI.Design/ExtenderControlDesigner.xml
@@ -77,7 +77,8 @@
method. `Dispose` invokes the protected `Dispose(Boolean)` method with the `disposing` parameter set to `true`. invokes `Dispose` with `disposing` set to `false`.
+
+This method is called by the public `Dispose()` method (and the method, if it has been overridden). `Dispose()` invokes the protected `Dispose(Boolean)` method with the `disposing` parameter set to `true`. `Finalize` invokes `Dispose` with `disposing` set to `false`.
When the `disposing` parameter is `true`, this method releases all resources that are held by any managed objects that this references. This method invokes the `Dispose` method of each referenced object.
diff --git a/xml/System.Web.UI.Design/HtmlControlDesigner.xml b/xml/System.Web.UI.Design/HtmlControlDesigner.xml
index b9d10704165..1e382e6a440 100644
--- a/xml/System.Web.UI.Design/HtmlControlDesigner.xml
+++ b/xml/System.Web.UI.Design/HtmlControlDesigner.xml
@@ -189,8 +189,9 @@
method. `Dispose()` invokes the protected `Dispose(Boolean)` method with the `disposing` parameter set to `true`. invokes `Dispose` with `disposing` set to `false`.
+## Remarks
+
+This method is called by the public `Dispose()` method (and the method, if it has been overridden). `Dispose()` invokes the protected `Dispose(Boolean)` method with the `disposing` parameter set to `true`. `Finalize` invokes `Dispose` with `disposing` set to `false`.
When the `disposing` parameter is `true`, this method releases all resources held by any managed objects that this references. This method invokes the `Dispose()` method of each referenced object.
diff --git a/xml/System.Web.UI.Design/TemplateEditingVerb.xml b/xml/System.Web.UI.Design/TemplateEditingVerb.xml
index ac92d28bb30..9e47260ae21 100644
--- a/xml/System.Web.UI.Design/TemplateEditingVerb.xml
+++ b/xml/System.Web.UI.Design/TemplateEditingVerb.xml
@@ -208,7 +208,7 @@
method. `Dispose` invokes the protected `Dispose(Boolean)` method with `disposing` set to `true`. invokes `Dispose` with `disposing` set to `false`.
+ This method is called by the public `Dispose` method and the method, if it has been overridden. `Dispose` invokes the protected `Dispose(Boolean)` method with `disposing` set to `true`. `Finalize` invokes `Dispose` with `disposing` set to `false`.
When `disposing` is `true`, this method releases all resources held by any managed objects that this references. This method invokes the `Dispose` method of each referenced object.
diff --git a/xml/System.Web.UI.WebControls/CreateUserWizard.xml b/xml/System.Web.UI.WebControls/CreateUserWizard.xml
index 34f5f37f0a7..326a1b52838 100644
--- a/xml/System.Web.UI.WebControls/CreateUserWizard.xml
+++ b/xml/System.Web.UI.WebControls/CreateUserWizard.xml
@@ -78,7 +78,7 @@
2. Create the user in the data store that the represents.
-3. Disable the user in the store if the property is set to `true.`
+3. Disable the user in the store if the property is set to `true`.
You can extend the control to accept additional information by adding additional fields, or by adding additional steps before or after the provided templates in the and properties.
@@ -1718,7 +1718,7 @@ Creates the hierarchy of child controls that make up the control.
|------------------------|------------------|------------------------|
|`UserName`|Any control that implements , including , or a custom or third-party control.|Required|
|`Password`|Any control that implements , including