Showing entries 41 to 50 of 66
« 10 Newer Entries | 10 Older Entries »
Displaying posts with tag: documentation (reset)
When is the MySQL 5.4 documentation going to be online, and GPL?

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 …

[Read more]
Google Summer of Code: Help improve MySQL documentation!

MySQL is participating in Google Summer of Code 2009 (GSoC for short), and so is the MySQL documentation team. We've just put our ideas on this page; you might want to have a look if you're interested in applying for a GSoc project.

One of the projects is purely technical and doesn't involve writing any documentation, but rather improving the technique that goes on behind the scenery.

The other project does involve writing documentation, but it's mostly (if not exclusively) about creating examples for the Connectors & APIs chapter of the MySQL Reference Manual, so you don't have to be a Pulitzer award winner to contribute, but you should …

[Read more]
MySQL documentation available on docs.sun.com now

We're proud to announce that significant parts of the MySQL documentation are available on docs.sun.com now, including the MySQL 5.0 Manual, the MySQL 5.1 Manual, the MySQL 6.0 Manual, and the MySQL Enterprise Monitor documentation.

Big deal? Well, certainly for us, the MySQL Documentation Team. This marks a big step forward towards making MySQL visible as software offered by Sun Microsystems. The reason for publishing our documentation in two places (the MySQL Developer Zone and the Sun documentation home) is to make MySQL more visible and the docs easily accessible for Sun customers who are used to finding documentation in the "traditional" place on docs.sun.com.  At the same time, we were anxious not to break anything for MySQL …

[Read more]
Yet another replication trap



When I filed Bug#39197 replication breaks with large load with InnoDB, flush logs, and slave stop/start, I genuinely thought that it was a serious problem. I was a bit puzzled, to tell the truth, because the scenario that I was using seemed common enough for this bug to be found already.

Anyway, it was verified independently, but there was a catch. The script in the master was using SET storage_engine=InnoDB to create the tables necessary for the test. That looked good enough to me. The script was indeed creating InnoDB tables on the master. The trouble was that the "SET" command is not replicated. Thus the …

[Read more]
MySQL Enterprise Monitor documentation public now

The MySQL Enterprise Monitor continuously monitors MySQL servers and alerts to potential problems before they impact the system. It helps eliminating security vulnerabilities, improves replication, optimizes performance, and more. Its newest feature, Quan (Query Analyzer), helps identify queries that could be tuned to improve performance. Quan enables database administrators to do the work that would otherwise require hours in just minutes, or even seconds, and it provides ongoing statistical information about the performance of your queries.

MySQL Enterprise Monitor is a commercial offering by Sun Microsystems, and so was the documentation. To help anyone (even if they're not customers) get a better and complete understanding of what exactly MySQL Enterprise Monitor is about and what it can do, we've decided to make its full documentation publicly available. This has been done now, and the docs are part of the MySQL Manual now; see: …

[Read more]
Recommended Reading (Business, Engineering)


As part of an internal programme at Sun, I am a “SEED mentor” for another Sun employee (not a former employee of MySQL, but what we Sun Dolphins call Sun Classics). He is called Alok and lives in Bangalore, and sadly, our schedules crossed so that I couldn’t meet him when I was at our Bangalore offices in July. So I am mentoring someone I’ve met only over phone — but we’re getting along just fine.

Two of the topics we’ve discussed recently are blogging and books. So after hanging up after our 9 CET 12:30 Indian time mentoring session, I got the idea to combine the two: write a blog entry about the books I recommended Alok.

One thing Alok is contemplating at the moment is the degree to which he should spend time on developing his business skills vs his engineering skills. That’s a familiar topic for many of us in …

[Read more]
Using the MySQL Doc source tree

I’ve mentioned a number of times that the documentation repositories that we use to build the docs are freely available, and so they are, but how do you go about using them?

More and more people are getting interested in being able to work with the MySQL docs, judging by the queries we get, and internally we sometimes get specialized requests.

There are some limitations - although you can download and access the docs and generate your own versions in various formats, you are not allowed to distribute or supply that iinformation, it can only be employed for personal use. The reasons and disclaimer for that are available on the main page for each of the docs, such as the one on the 5.1 Manual.

Those issues aside, if you want to use and generate your own docs from the Subversion source tree then you’ll need the following:

[Read more]
MySQL Reference Manual Search

Martin Brown’s blog shows a pretty good way of navigating the MySQL Reference Manual. It’s worth noting, however, that finding the different topics has been a lot easier since mysql.com started using a Google appliance for its search.

I use the documentation all the time and have been doing so for years (I won’t claim that I can remember +2000 pages worth of ever-changing content). A few years back, I stopped using the search box on dev.mysql.com because the result sets were enormous, with lots of unrelated references. My technique was to do a Google site search:

For replication use the expression: replication site:http://dev.mysql.com/doc/refman/5.0/en/index.html

The …

[Read more]
MySQL manual gets improved searching

Hooray! The MySQL reference manual has a new search system. It now uses a Google Appliance and the results should be a lot better. The old system was not very helpful. It used to break config variables into multiple words and search on them individually and give a billion results I didn’t care about. I’ve just tried to search for some things like key_buffer_size and got results I think are very useful.

I love the MySQL manual. It is a great example of quality software documentation. As someone recently mentioned, it is not released under a Free license though — that would be a great improvement, too!

When did this change happen, by the way? Maybe it’s been there for a while and I just missed it because I grew accustomed to using Google search instead.

Edit: I actually would suggest a …

[Read more]
It Lives!

When I was on the MySQL Documentation team one thing started to become apparent to me: the MySQL Reference Manual was exactly what it claimed to be: a document better suited to referencing than teaching new users. I make very good use of it because I know MySQL, I know what it can do, and all I want is the right syntax for what I am trying to use it for.

I saw a need for a User Guide, something well suited to new users who were not experienced with MySQL and potentially with DBMSes in general. As a side project I started working on a chapter of what could eventually be a MySQL produced user guide, lacking the depth of the reference manual but more suitable for newer users. This first chapter was on Indexing and while I think it showed promise, I left MySQL AB shortly after completing it.

Fast forward to today, where I see a blog post by Colin Charles

[Read more]
Showing entries 41 to 50 of 66
« 10 Newer Entries | 10 Older Entries »