Bug #29243 Replication compatibility page for MySQL 5.1 contains contradictions

• Submitted: 20 Jun 2007 15:45
• Modified: 26 Jul 2007 15:29
• Reporter: Harrison Fisk
• Status: Closed
• Category: Server: Docs
• Severity: S3 (Non-critical)
• Version: 5.1.18 manual
• OS: Any
• Assigned to: MC Brown
• Tags: compatibility, Docs, documentation, replication
• Triage: D4 (Minor)

[20 Jun 2007 15:45] Harrison Fisk

Description:
The manual page at http://dev.mysql.com/doc/refman/5.1/en/replication-compatibility.html
has some contradictory statements regarding if MySQL 5.1 can be a master for MySQL 5.0.

It first reads:

"Replication works correctly between MySQL 5.0 and 5.1 masters and slaves in any
combination..."

This implies that MySQL 5.1 can be a master for MySQL 5.0.

Then later on it reads:

"In general, slaves running MySQL 5.1.x can be used with older masters (even those
running MySQL 3.23, 4.0, or 4.1), but not the reverse."

This says that MySQL 5.1 can not be a master to older versions (which would include
5.0).

I think the second sentence should say masters older than 5.0, assuming the first
statement is true.

How to repeat:
RTFM at http://dev.mysql.com/doc/refman/5.1/en/replication-compatibility.html

Suggested fix:
Find out which statement is true and make them co-exist correctly.

[20 Jun 2007 15:52] Andrei Elkin

"Replication works correctly between MySQL 5.0 and 5.1 masters and slaves in any
combination..." - that's a possibility when newer master does not generate newer
replication events than older slave is unaware of.

[26 Jul 2007 15:29] MC Brown

I've removed the conflicting material. We are working on a more detailed
compatibility/upgrade matrix for replication.