Bug #53771 Synchronize the 5.5. manual with what is happening re: InnoDB plugin
Submitted: 19 May 2010 0:45 Modified: 20 May 2010 20:53
Reporter: Roel Van de Paar (OCA) Email Updates:
Status: Closed Impact on me:
None 
Category:MySQL Server: Documentation Severity:S3 (Non-critical)
Version:5.5 OS:Any
Assigned to: John Russell
Triage: Needs Triage: D4 (Minor)

[19 May 2010 0:45] Roel Van de Paar
Description:
"Since we are unifying the InnoDB within MySQL using the best and fastest technology, we are phasing out the "Plugin" versus "Built-In"  distinction; MySQL 5.5 comes with the latest and greatest InnoDB 1.1."

"At this year's MySQL Conference & Expo, you'll hear about the InnoDB Plugin 1.0.7, the first production-ready (GA) release of the InnoDB Plugin. Most of the enhancements listed here are from InnoDB 1.1, which is part of MySQL 5.5 and thus is still in beta. Download MySQL 5.5 and try them out."

Source: http://dev.mysql.com/tech-resources/articles/introduction-to-mysql-55.html

But (** highlight added): 

"13.7. InnoDB **Plugin** **1.1** (Early Adopter Release)"

Source: http://dev.mysql.com/doc/refman/5.5/en/innodb-plugin-5-5.html

How to repeat:
See 5.5. docs

Suggested fix:
Streamline
[19 May 2010 0:57] Roel Van de Paar
Suggestion to fix this/make it easier to understand: simply remove the word "Plugin" and call it "InnoDB 1.1" everywhere. That seems to work well in the article. "Plugin" (or build-in) for 5.0/5.1, "InnoDB 1.1" for 5.5, no plugin needed.

Also, any links referencing this section may need updating:

"For information about these features, see Section 13.7, “InnoDB Plugin 1.1 (Early Adopter Release)”."

Source: http://dev.mysql.com/doc/refman/5.5/en/innodb.html
[19 May 2010 0:58] Roel Van de Paar
The only question is whether there will ever be a then-newer InnoDB Plugin which provides more functionality than the then-current InnoDB v1.1 (or v1.x)

Maybe the internal InnoDB versioning needs to be reviewed. Maybe it needs to match the plugin version.
[20 May 2010 20:53] John Russell
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.

Whoops, this "canned answer" deleted my extra comments. Since the Plugin manual has already been streamlined like you suggest, please confirm if you see any other instances that need to be changed.  Some references to 'Plugin' are unavoidable due to historical discussions, particularly the 5.1 era when Plugin and built-in coexist.