MySQL Bugs: #55853: InnoDB Plugin 1.0.10 Documentation

Bug #55853	InnoDB Plugin 1.0.10 Documentation
Submitted:	9 Aug 2010 17:57	Modified:	18 Oct 2010 19:04
Reporter:	Maxim Volkov	Email Updates:
Status:	Closed	Impact on me:	None
Category:	MySQL Server: Documentation	Severity:	S3 (Non-critical)
Version:	1.0.10	OS:	Other (Online documentation)
Assigned to:	John Russell	CPU Architecture:	Any
Tags:	documentation, InnoDB plugin

Description:
We need documentation on InnoDB 1.0.10 plugin.

After over two weeks of MySQL 5.1.49 release this page still does not reflect changes in InnoDB Plugin. 

http://dev.mysql.com/doc/innodb-plugin/1.0/en/innodb-changes.html

Why? Will it ever be updated? Is that part of new Oracle strategy?

How to repeat:
Go to http://dev.mysql.com/doc/innodb-plugin/1.0/en/innodb-changes.html

Suggested fix:
Update documentation

Thank you for the bug report.

Please, read carefully the page you quoted, especially this part:

"With the closer integration of InnoDB into the MySQL server starting in MySQL 5.1, you can find recent InnoDB change log entries in MySQL Change History in the MySQL Reference Manual."

Also:

"The complete change history of the InnoDB Plugin can be viewed in the file ChangeLog that is included in the source and binary distributions."

Well... A grep through the source code for 5.1.49 reveals that ChangeLog to InnoDB Plugin mapping stopped at about the same time as web documentation (v. 1.0.8): 

-----------------------------------------------------------------------------
grep -rn "InnoDB Plugin 1.0" .
./Docs/mysql.info:96324:     For information about these features, see InnoDB Plugin 1.0 for
./Docs/mysql.info:248924:     For information about these features, see InnoDB Plugin 1.0 for
./storage/innodb_plugin/ChangeLog:196:  InnoDB Plugin 1.0.7 released
./storage/innodb_plugin/ChangeLog:389:  InnoDB Plugin 1.0.6 released
./storage/innodb_plugin/ChangeLog:705:  InnoDB Plugin 1.0.4 released
./storage/innodb_plugin/ChangeLog:1085: InnoDB Plugin 1.0.3 released
./storage/innodb_plugin/ChangeLog:1372: InnoDB Plugin 1.0.2 released
./storage/innodb_plugin/ChangeLog:1790: InnoDB Plugin 1.0.1 released
./storage/innodb_plugin/ChangeLog:1861: InnoDB Plugin 1.0.0 released
./storage/innodb_plugin/log/log0recv.c:1009:                            older than InnoDB Plugin 1.0.4. */
./storage/innodb_plugin/log/log0recv.c:1032:                            older than InnoDB Plugin 1.0.4. */
--------------------------------------------------------------------------

 I've looked ChangeLog file in the source code before submitting the original bug and here is the only reference there to InnoDB Plugin 1.0.10

   ------------------------------------------------------------
    revno: 3351.14.150
    committer: Vasil Dimov <vasil.dimov@oracle.com>
    branch nick: mysql-5.1-innodb
    timestamp: Fri 2010-06-18 10:00:01 +0300
    message:
      Increment InnoDB Plugin version from 1.0.9 to 1.0.10, after
      1.0.9 has been released with MySQL 5.1.48.
    ------------------------------------------------------------

And it looks like is not only me who gets confused -> http://bugs.mysql.com/bug.php?id=55521

Could you please provide and exact place where the information can be found?

Well... A grep through the source code for 5.1.49 reveals that ChangeLog to InnoDB Plugin mapping stopped at about the same time as web documentation (v. 1.0.8): 

-----------------------------------------------------------------------------
grep -rn "InnoDB Plugin 1.0" .
./Docs/mysql.info:96324:     For information about these features, see InnoDB Plugin 1.0 for
./Docs/mysql.info:248924:     For information about these features, see InnoDB Plugin 1.0 for
./storage/innodb_plugin/ChangeLog:196:  InnoDB Plugin 1.0.7 released
./storage/innodb_plugin/ChangeLog:389:  InnoDB Plugin 1.0.6 released
./storage/innodb_plugin/ChangeLog:705:  InnoDB Plugin 1.0.4 released
./storage/innodb_plugin/ChangeLog:1085: InnoDB Plugin 1.0.3 released
./storage/innodb_plugin/ChangeLog:1372: InnoDB Plugin 1.0.2 released
./storage/innodb_plugin/ChangeLog:1790: InnoDB Plugin 1.0.1 released
./storage/innodb_plugin/ChangeLog:1861: InnoDB Plugin 1.0.0 released
./storage/innodb_plugin/log/log0recv.c:1009:                            older than InnoDB Plugin 1.0.4. */
./storage/innodb_plugin/log/log0recv.c:1032:                            older than InnoDB Plugin 1.0.4. */
--------------------------------------------------------------------------

 I've looked ChangeLog file in the source code before submitting the original bug and here is the only reference there to InnoDB Plugin 1.0.10

   ------------------------------------------------------------
    revno: 3351.14.150
    committer: Vasil Dimov <vasil.dimov@oracle.com>
    branch nick: mysql-5.1-innodb
    timestamp: Fri 2010-06-18 10:00:01 +0300
    message:
      Increment InnoDB Plugin version from 1.0.9 to 1.0.10, after
      1.0.9 has been released with MySQL 5.1.48.
    ------------------------------------------------------------

And it looks like is not only me who gets confused -> http://bugs.mysql.com/bug.php?id=55521

Could you please provide an exact place where the information can be found?

I should have been clearer. The information in the Changelog is up to date, it just does not contain a 1.0.10 reference. Likewise, http://dev.mysql.com/doc/innodb-plugin/1.0/en/innodb-changes.html won't be updated anymore, since those are now part of the MySQL Change History in the MySQL Reference Manual.

In the InnoDB Plugin manual, I put the link to the Ref Man changelog under a separate heading to make it more visible.

In the Ref Man changelog for 5.1.49:

http://dev.mysql.com/doc/refman/5.1/en/news-5-1-49.html

I put an "InnoDB Storage Engine" tag next to the InnoDB-related entries to group them together and make them stand out better.  Will spread that convention to the other 5.1 and 5.5 changelog sections.