MySQL Bugs: #58418: Wrong description of Rpl_semi_sync_master

Bug #58418	Wrong description of Rpl_semi_sync_master_status
Submitted:	23 Nov 2010 13:16	Modified:	24 Nov 2010 8:03
Reporter:	Mario Beck	Email Updates:
Status:	Closed	Impact on me:	None
Category:	MySQL Server: Documentation	Severity:	S3 (Non-critical)
Version:	5.5	OS:	Any
Assigned to:	Paul DuBois	CPU Architecture:	Any
Tags:	Rpl_semi_sync_master_status, semisynchronous replication

Description:
The description of the new status variable Rpl_semi_sync_master_status is misleading:

How to repeat:
Look at two locations:
http://dev.mysql.com/doc/refman/5.5/en/server-status-variables.html#statvar_Rpl_semi_sync_...
http://dev.mysql.com/doc/refman/5.5/en/replication-semisync-interface.html

It says:

 Rpl_semi_sync_master_status

Whether semisynchronous replication currently is operational on the master. The value is ON if the plugin has been enabled and a commit acknowledgment has not occurred. It is OFF if the plugin is not enabled or the master has fallen back to asynchronous replication due to commit acknowledgment timeout.

Suggested fix:
The value is ON if ... and a commit acknowledgement has occurred. (NOT is wrong here).
Or
... and a commit acknowledgement TIMEOUT has not occurred.

It is misleading in both locations of the documentation.

Thank you for the report.

Verified as described. I'd vote for "and a commit acknowledgement TIMEOUT has not occurred."

Thank you for your bug report. This issue has been addressed in the documentation. The updated documentation will appear on our website shortly, and will be included in the next release of the relevant products.

I've removed the word "not" in this sentence, for both instances where it occured: "The value is 1 if the plugin has been enabled and a commit acknowledgment has occurred." -Stefan