Bug #3566 Online documentation vis a vis versions
Submitted: 26 Apr 2004 11:48 Modified: 18 Aug 2005 15:12
Reporter: Scott Hockett Email Updates:
Status: Closed Impact on me:
None 
Category:MySQL Server: Documentation Severity:S4 (Feature request)
Version:4.0 OS:
Assigned to: Stefan Hinz CPU Architecture:Any

[26 Apr 2004 11:48] Scott Hockett
Description:
Online documentation (http://dev.mysql.com/doc/mysql/en/index.html) appears to be up-to-date as of the current alpha (4.1) release, though I would imagine that most current implementations are some variation of 4.0.

I find the online documentation to be quite useful, but on several occasions recently, I have found myself trying to use a capability added in version 4.1 on a v 4.0.x DB.  A quick check of the documentation is of little help, though sometimes a version-related note is included on a higher-level page.

How to repeat:
Try to figure out from http://dev.mysql.com/doc/mysql/en/EXISTS_and_NOT_EXISTS_subqueries.html why a query using a "where not exists..." subquery type of approach does not work on a 4.0.15 or 4.0.16 impementation.

Granted, the parent page (http://dev.mysql.com/doc/mysql/en/Subqueries.html) and http://dev.mysql.com/doc/mysql/en/Rewriting_subqueries.html provide enough information to ascertain the problem eventually.  But it would be awfully nice if such information were available more directly (particularly since, by using the "Search the MySQL Manual" feature, one can have a tendency to proceed directly to the page of interest, rather than proceeding step-by-step from more-general to more-specific pages).

Suggested fix:
It would be wonderful if you could either (1) provide 4.0.x and 4.1 documentation separately or (2) indicate within the content (or better yet as an attribute of the content) as-of which version a particular capability/feature was added or significantly changed.
[18 Aug 2005 15:12] Stefan Hinz
The documentation should be as up to date as can be now.