Bug #43164 '.ARM' file is deprecated in MySQL 5.1, but documention still mentions it
Submitted: 25 Feb 2009 3:54 Modified: 5 Mar 2009 19:42
Reporter: Meiji KIMURA Email Updates:
Status: Closed Impact on me:
None 
Category:MySQL Server: Documentation Severity:S3 (Non-critical)
Version:5.1.x OS:Any
Assigned to: Paul Dubois CPU Architecture:Any
Triage: Needs Triage: D4 (Minor)

[25 Feb 2009 3:54] Meiji KIMURA
Description:
When I create a table with 'engine=archive', MySQL 5.0 made three files like this,

.FRM
.ARZ
.ARM

But from MySQL 5.1.x, '.ARM' is deplicated after this commit.

http://lists.mysql.com/commits/23453

But the manual for MySQL 5.1 still mentioned about '.ARM' like this,

'The data and metadata files have extensions of .ARZ and .ARM, respectively. An .ARN file may appear during optimization operations.'

http://dev.mysql.com/doc/refman/5.1/en/archive-storage-engine.html

I think this change is an incompatible change, but I could not find this on incompatible changes list.

Some people were embarrassed like this,
http://forums.mysql.com/read.php?112,230528,230528

How to repeat:
See this like about .ARM file.

http://dev.mysql.com/doc/refman/5.1/en/archive-storage-engine.html

Suggested fix:
Please mention that '.ARM' was deplicated from MySQL 5.1.x.

Please add this fact to proper release note as an incompatible change.

http://dev.mysql.com/doc/refman/5.1/en/news-5-1-x.html
[5 Mar 2009 19:42] Paul Dubois
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.

Looks like this change occurred in MySQL 5.1.15.  I've added a note to the 5.1.15 changelog and modified the ARCHIVE section in the 5.1/6.0 manuals accordingly.