Document return value of ExecuteNonQuery. Fixes #1136

Author: bgrainger

docs/content/api/MySqlConnector/MySqlCommand/ExecuteNonQuery.md

@@ -36,6 +36,7 @@ weight: 30
 
 * Fix `Use Compression = True` when running under .NET 6.0: [#1120](https://github.com/mysql-net/MySqlConnector/issues/1120).
 * Fix calculation of affected rows (the return value of `ExecuteNonQuery`) for compound statements: [#1096](https://github.com/mysql-net/MySqlConnector/issues/1096).
+  * **Breaking** For a stored procedure, the return value of `ExecuteNonQuery` will be the number of rows affected by the last statement in the procedure, or zero if the last statement was a `SELECT`.
 * Use a better `FormatException` message when a GUID can't be read: [#1114](https://github.com/mysql-net/MySqlConnector/issues/1114).
 * Use cryptographic one-shot operations on .NET 5.0 and later.
 * Performance: Use `SkipLocalsInit` where possible.

docs/content/api/MySqlConnector/MySqlCommand/ExecuteNonQueryAsync.md

@@ -97,7 +97,13 @@ private MySqlCommand(MySqlCommand other)
 	/// <inheritdoc/>
 	public override void Cancel() => Connection?.Cancel(this, m_commandId, true);
 
-	/// <inheritdoc/>
+	/// <summary>
+	/// Executes this command on the associated <see cref="MySqlConnection"/>.
+	/// </summary>
+	/// <returns>The number of rows affected.</returns>
+	/// <remarks>For UPDATE, INSERT, and DELETE statements, the return value is the number of rows affected by the command.
+	/// For stored procedures, the return value is the number of rows affected by the last statement in the stored procedure,
+	/// or zero if the last statement is a SELECT. For all other types of statements, the return value is -1.</remarks>
 	public override int ExecuteNonQuery() => ExecuteNonQueryAsync(IOBehavior.Synchronous, CancellationToken.None).GetAwaiter().GetResult();
 
 	/// <inheritdoc/>
@@ -271,6 +277,14 @@ protected override DbTransaction? DbTransaction
 	protected override DbDataReader ExecuteDbDataReader(CommandBehavior behavior) =>
 		ExecuteReaderAsync(behavior, IOBehavior.Synchronous, CancellationToken.None).GetAwaiter().GetResult();
 
+	/// <summary>
+	/// Executes this command asynchronously on the associated <see cref="MySqlConnection"/>.
+	/// </summary>
+	/// <param name="cancellationToken">A token to cancel the asynchronous operation.</param>
+	/// <returns>A task representing the asynchronous operation.</returns>
+	/// <remarks>For UPDATE, INSERT, and DELETE statements, the return value is the number of rows affected by the command.
+	/// For stored procedures, the return value is the number of rows affected by the last statement in the stored procedure,
+	/// or zero if the last statement is a SELECT. For all other types of statements, the return value is -1.</remarks>
 	public override Task<int> ExecuteNonQueryAsync(CancellationToken cancellationToken) =>
 		ExecuteNonQueryAsync(AsyncIOBehavior, cancellationToken);
 

docs/content/api/MySqlConnector/MySqlCommandType.md

@@ -204,6 +204,13 @@ public override bool HasRows
 	}
 
 	public override bool IsClosed => Command is null;
+
+	/// <summary>
+	/// Gets the number of rows changed, inserted, or deleted by execution of the SQL statement.
+	/// </summary>
+	/// <remarks>For UPDATE, INSERT, and DELETE statements, the return value is the number of rows affected by the command.
+	/// For stored procedures, the return value is the number of rows affected by the last statement in the stored procedure,
+	/// or zero if the last statement is a SELECT. For all other types of statements, the return value is -1.</remarks>
 	public override int RecordsAffected => RealRecordsAffected is ulong recordsAffected ? checked((int) recordsAffected) : -1;
 
 	public override int GetOrdinal(string name) => GetResultSet().GetOrdinal(name);