My SQL Dump

MySQL musings by a self professed MySQL Geek

Previous Entry Add to Memories Share Next Entry
When is the MySQL 5.4 documentation going to be online, and GPL?
swanhart
I went looking for the MySQL 5.4 documentation today, but alas I could not find it. In particular, I went looking for the list of changes between 5.1.34 and 5.4.1.

If 5.4.1 is beta then it should definitely have documentation, at least in beta form. This is especially true in light of the Sun MySQL conference keynote kind of dangling a carrot on a stick, as it were, with a question to the audience about opening the docs up under the GPL. The comments system also needs updated too. I think that if public comments are available on the web site, then those comments should have a rating system attached so that crappy, wrong and useless manual comments can easily be filtered. But I digress.

So, Sun, when are going to release all the MySQL documents under the GPL? Is it going to be in the MySQL 5.4 time frame, or in some far off hazy future? And why are there no 5.4 documents available online, when the binaries are already available for download?

I appreciate the timing of the release of the binaries with the conference, but for me, some documentation about changes and information about how to get the most out of the new release would be beneficial.

In particular I have questions about the new BKA algorithm, any new or changed my.cnf parameters related to the performance changes, and a quick overview of all the new features and changes since MySQL 5.1.

That isn't too much to ask, is it?

Justin,
Did you check the dev zone? There is both an article and a link to the docs.
http://dev.mysql.com/tech-resources/articles/mysql-54.html
http://dev.mysql.com/doc/mysql-5.4-features/en/index.html

As for the GPL, why? The MySQL documentation has never been GPL, and there is no current expectation to release it under a free license. The reason is to protect the integrity of the documentation. Whether is a good or bad idea, it's been like it since the very beginning.

Regarding the list of changes, I think it slipped through the cracks, but I have alerted the documentation team about it. If you want to know what has changed, you can use the log in Launchpad (https://code.launchpad.net/~mysql/mysql-server/mysql-5.4)

Giuseppe

The biggest argument for GPL docs is drizzle. It is a fork, but it can't use (or even modify and use) the existing documentation, which is disappointing at best.

I don't normally blog about drizzle, because I don't have an environment which would benefit from it. Heck, I don't have /any/ environment any more since I'm not a full time DBA these days.

As for the dev zone, I would expect that the MySQL Version links (blue background, white text) on the left hand side of the page clearly include 5.4. When I do a text search (with the find option in the browser) for "5.4" the only link on the page is to the "feature summary".

Thanks for the links though, that is exactly the information I was looking for. I guess I'm just used to navigating the site in a very specific way, mostly because I still avoid the full text search on the site.



But Karen said...

(Anonymous)

2009-04-28 10:49 am (UTC)

@datacharmer: Giuseppe, I was surprised too, since its always been so, but during Karen's keynote Kaj asked whether the docs could be published under a free license (GFDL) and Karen said something like "consider it done". So I'm interested to see it too.

henrik

You are viewing swanhart