As some of you have noticed (and reported) we are having trouble with the CHM builds we do of the various MySQL Reference Manuals. This is something that we are looking into, but the reasons and issues behind it are complex. One of the basic reasons if the sheer complexity and size of the documents are now building – there are thousands of files in a standard HTML build, constituting more than 2,500 pages of material. Unfortunately, the final part of the build process, using Microsoft’s own HTML Help Compiler is something we have no control over, and Microsoft no longer support the product. Sometimes it produces a perfectly fine CHM from the source material. Sometimes, using the exact same material, it produces a build that is corrupt in some way. The CHM building process is automatic – I improved it a couple of years ago to be automated as much as possible using a Windows Powershell script that performs nearly all of the work and verifies the build process. But Microsoft’s tool will report a successful build even if the build actually produces a corrupt CHM file. Identifying a corrupt build is difficult; some of the CHM builds open fine on Windows but not in Linux CHM readers, some the other way round, some that don’t work in anything but which reported a completely fine build. We are looking at different ways of addressing the issues, including creating simplified output (removing some of the more esoteric stuff), and releasing CHMs less often that have been manually checked. I’ll let you know the progress, but until then, we’re going to be highlighting the CHM build issue on the download page.
Technology Communications Expert
Passionate about documentation and communicating information to users in a way which ensures readers know and understand the information that is being presented. I use different technology to present consistent factual content in multiple formats to make it easy to find and understand the information you need.
Top Posts & Pages
- MySQL Documentation and Debian/Ubuntu
- About MCslp Projects
- Percona Live 2013, MySQL, Continuent and an ever-healthy Ecosystem
- Optimizing AIX 7 performance: Part 1, 2 and 3
- David Sklar, Essential PHP Tools: Modules, Extensions, and Accelerators
- Take advantage of using libevent and libev
- Optimizing AIX 7 memory performance
- Tip: Couchbase Server Monitoring
- Controlling OS X volume through Cron
Tagsapple appledeveloperconnection articles books commentary computerworld couchbase couchdb databases developmentenvironments eclipse foss freesoftwaremagazine general grids hardware ibmdeveloperworks interviews java linux linuxtoday linuxworldmagazine macosx microsoft mysql mysqlconf09 opensource presentations programming rational reviews scripting serverwatch sitenews software solaris sunsolaris systemadministration technology theappleblog unix virtualization webdevelopment webservices xml
Error: Twitter did not respond. Please wait a few minutes and refresh this page.