Automatic port of System.Data.Common docs (dotnet#4885)

Co-authored-by: carlossanlop <[email protected]>

Author: carlossanlop

xml/System.Data.Common/DbTransaction.xml

@@ -507,8 +507,8 @@
         <Parameter Name="savepointName" Type="System.String" Index="0" FrameworkAlternate="net-5.0" />
       </Parameters>
       <Docs>
-        <param name="savepointName">To be added.</param>
-        <summary>To be added.</summary>
+        <param name="savepointName">The name of the savepoint to release.</param>
+        <summary>Destroys a savepoint previously defined in the current transaction. This allows the system to reclaim some resources before the transaction ends.</summary>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -534,10 +534,10 @@
         <Parameter Name="cancellationToken" Type="System.Threading.CancellationToken" Index="1" FrameworkAlternate="net-5.0" />
       </Parameters>
       <Docs>
-        <param name="savepointName">To be added.</param>
-        <param name="cancellationToken">To be added.</param>
-        <summary>To be added.</summary>
-        <returns>To be added.</returns>
+        <param name="savepointName">The name of the savepoint to release.</param>
+        <param name="cancellationToken">An optional token to cancel the asynchronous operation. The default value is <see cref="P:System.Threading.CancellationToken.None" />.</param>
+        <summary>Destroys a savepoint previously defined in the current transaction. This allows the system to reclaim some resources before the transaction ends.</summary>
+        <returns>A <see cref="T:System.Threading.Tasks.Task" /> representing the asynchronous operation.</returns>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -605,8 +605,8 @@
         <Parameter Name="savepointName" Type="System.String" Index="0" FrameworkAlternate="net-5.0" />
       </Parameters>
       <Docs>
-        <param name="savepointName">To be added.</param>
-        <summary>To be added.</summary>
+        <param name="savepointName">The name of the savepoint to roll back to.</param>
+        <summary>Rolls back all commands that were executed after the specified savepoint was established.</summary>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -674,10 +674,10 @@
         <Parameter Name="cancellationToken" Type="System.Threading.CancellationToken" Index="1" FrameworkAlternate="net-5.0" />
       </Parameters>
       <Docs>
-        <param name="savepointName">To be added.</param>
-        <param name="cancellationToken">To be added.</param>
-        <summary>To be added.</summary>
-        <returns>To be added.</returns>
+        <param name="savepointName">The name of the savepoint to roll back to.</param>
+        <param name="cancellationToken">An optional token to cancel the asynchronous operation. The default value is <see cref="P:System.Threading.CancellationToken.None" />.</param>
+        <summary>Rolls back all commands that were executed after the specified savepoint was established.</summary>
+        <returns>A <see cref="T:System.Threading.Tasks.Task" /> representing the asynchronous operation.</returns>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -703,8 +703,8 @@
         <Parameter Name="savepointName" Type="System.String" Index="0" FrameworkAlternate="net-5.0" />
       </Parameters>
       <Docs>
-        <param name="savepointName">To be added.</param>
-        <summary>To be added.</summary>
+        <param name="savepointName">The name of the savepoint to be created.</param>
+        <summary>Creates a savepoint in the transaction. This allows all commands that are executed after the savepoint was established to be rolled back, restoring the transaction state to what it was at the time of the savepoint.</summary>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -730,10 +730,10 @@
         <Parameter Name="cancellationToken" Type="System.Threading.CancellationToken" Index="1" FrameworkAlternate="net-5.0" />
       </Parameters>
       <Docs>
-        <param name="savepointName">To be added.</param>
-        <param name="cancellationToken">To be added.</param>
-        <summary>To be added.</summary>
-        <returns>To be added.</returns>
+        <param name="savepointName">The name of the savepoint to be created.</param>
+        <param name="cancellationToken">An optional token to cancel the asynchronous operation. The default value is <see cref="P:System.Threading.CancellationToken.None" />.</param>
+        <summary>Creates a savepoint in the transaction. This allows all commands that are executed after the savepoint was established to be rolled back, restoring the transaction state to what it was at the time of the savepoint.</summary>
+        <returns>A <see cref="T:System.Threading.Tasks.Task" /> representing the asynchronous operation.</returns>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -756,8 +756,10 @@
         <ReturnType>System.Boolean</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added.</summary>
-        <value>To be added.</value>
+        <summary>Gets a value that indicates whether this <see cref="T:System.Data.Common.DbTransaction" /> instance supports database savepoints.
+            If <see langword="false" />, the methods <see cref="M:System.Data.Common.DbTransaction.SaveAsync(System.String,System.Threading.CancellationToken)" />, <see cref="M:System.Data.Common.DbTransaction.RollbackAsync(System.String,System.Threading.CancellationToken)" /> and <see cref="M:System.Data.Common.DbTransaction.ReleaseAsync(System.String,System.Threading.CancellationToken)" /> as well as their synchronous counterparts are expected to throw <see cref="T:System.NotSupportedException" />.</summary>
+        <value>
+          <see langword="true" /> if this <see cref="T:System.Data.Common.DbTransaction" /> instance supports database savepoints; otherwise, <see langword="false" />.</value>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>