Bug #77721 Section should be more clear about 5.5 and 5.6 versions
Submitted: 14 Jul 2015 17:52 Modified: 11 Aug 2015 15:07
Reporter: Stefan Lasiewski Email Updates:
Status: Closed Impact on me:
None 
Category:MySQL Server: Documentation Severity:S3 (Non-critical)
Version:5.1+ OS:Any
Assigned to: Jon Stephens CPU Architecture:Any

[14 Jul 2015 17:52] Stefan Lasiewski
Description:
The page "17.4.2 Replication Compatibility Between MySQL Versions" at https://dev.mysql.com/doc/refman/5.6/en/replication-compatibility.html says the following:

> MySQL supports replication from one major version to the next higher major version. For example, you can replicate from a master running MySQL 4.1 to a slave running MySQL 5.0, from a master running MySQL 5.0 to a slave running MySQL 5.1, and so on. 

There are a few problems with this:

* These are the 5.6 docs. This page should mention MySQL 5.5 and 5.6.
* The doc should be more clear that replication between 5.1 and 5.6 is not supported. The phrases "MySQL supports replication from one major version to the next higher major version." and  "from a master running MySQL 5.0 to a slave running MySQL 5.1" makes it sound like replication is supported between any MySQL 5.x version, because version "5" is the major version, while ".x" is the *release level*

How to repeat:
Visit https://dev.mysql.com/doc/refman/5.6/en/replication-compatibility.html and read the first paragraph, which says:

> MySQL supports replication from one major version to the next higher major version. For example, you can replicate from a master running MySQL 4.1 to a slave running MySQL 5.0, from a master running MySQL 5.0 to a slave running MySQL 5.1, and so on. 

Suggested fix:
Rephrasing like this would be more appropriate:

"For example, you can replicate from a master running MySQL 5.1 to a slave running MySQL 5.5, from a master running MySQL 5.5 to a slave running MySQL 5.6, and so on. Replicating from a master running 5.1 to a slave running 5.6 is not supported."

The MySQL 5.7 docs at https://dev.mysql.com/doc/refman/5.7/en/replication-compatibility.html are a little more clear then the 5.6 docs:

> MySQL supports replication from one major version to the next higher major version. For example, you can replicate from a master running MySQL 5.0 to a slave running MySQL 5.1, from a master running MySQL 5.1 to a slave running MySQL 5.5, and so on.
[14 Jul 2015 18:34] MySQL Verification Team
Thank you for the bug report.
[11 Aug 2015 13:18] Jon Stephens
Assigning this one to myself.
[11 Aug 2015 15:07] Jon Stephens
Thank you for your bug report. This issue has been addressed in the documentation. The updated documentation will appear on our website shortly.