{"id":1122,"date":"2008-01-31T09:09:12","date_gmt":"2008-01-31T17:09:12","guid":{"rendered":"http:\/\/coalface.mcslp.com\/2008\/01\/31\/mysql-documentation-and-debianubuntu\/"},"modified":"2008-01-31T09:09:12","modified_gmt":"2008-01-31T17:09:12","slug":"mysql-documentation-and-debianubuntu","status":"publish","type":"post","link":"https:\/\/planet.mcb.guru\/?p=1122","title":{"rendered":"MySQL Documentation and Debian\/Ubuntu"},"content":{"rendered":"<p>We&#8217;ve got a lot of queries recently on the MySQL docs team address about the documentation (particularly man pages) for MySQL on Debian\/Ubuntu. <\/p>\n<p>The source of the original problem was reported as a <a href=\"https:\/\/bugs.launchpad.net\/debian\/+source\/mysql-dfsg-5.0\/+bug\/121441\/+viewstatus\">Debian bug<\/a>. The assumption from the reading of the license in this instance is that you are not allowed to distribute MySQL documentation unless you&#8217;ve asked first, and that the documentation is not released under the GPL license. <\/p>\n<p>The original license was misunderstood in this respect. <\/p>\n<p>In fact, the license as originally quoted in that bug <b>does<\/b> allow you to provide the documentation if you are providing the MySQL software. <\/p>\n<p>In addition, regardless of how you interpret the license, all of our documentation, including installable man pages, has been available on <a href=\"http:\/\/dev.mysql.com\/doc\/\">http:\/\/dev.mysql.com\/doc<\/a>. You can find online HTML, offline HTML, PDF, CHM and the man pages for all of our reference manuals (on a version by version basis), along with the main HTML\/PDF formats for all of the remaining documentation. <\/p>\n<p>We have never tried to limit the availability of the documentation (that&#8217;s why we provide it in so many formats).<\/p>\n<p>However, as soon as this issue was reported on to us by the folks at Debian we agreed with our legal department to put the man pages under a GPL license. This affects only the man pages, but gets round the misunderstanding above by allowing the man pages to be distributed under the same GPL license as the software. <\/p>\n<p>Why did we only change our man page license?<\/p>\n<p>MySQL documentation is updated and released very often, in fact as often<br \/>\nas ten times per day. Allowing anyone to create static copies of an<br \/>\narbitrary documentation release would lead to many outdated copies on<br \/>\nthe &#8216;Net. This is bad for users doing Google searches for MySQL<br \/>\ndocumentation, and bad for us (we&#8217;ve seen complaints about &#8220;our&#8221; 5.0.0<br \/>\nManual being badly outdated when MySQL 5.1.20 was out). We appreciate<br \/>\nanyone <b>mirroring<\/b> the MySQL Dev Zone which contains all MySQL<br \/>\ndocumentation.<\/p>\n<p>So where does that leave the man pages in Debian\/Ubuntu? <\/p>\n<p>I&#8217;m pleased to say that the new 5.0.51-1 package for MySQL that has gone into the latest Debian release (actually, in December). That means that MySQL and the corresponding man pages should appear already in the latest Debian &#8220;unstable&#8221; branch, and the next major Debian release should include everything you need. <\/p>\n<p>Thanks to  Christian Hammers (Debian) and Norbert Tretkowski (Ubuntu) for their help on getting this all sorted!<\/p>\n","protected":false},"excerpt":{"rendered":"<p>We&#8217;ve got a lot of queries recently on the MySQL docs team address about the documentation (particularly man pages) for MySQL on Debian\/Ubuntu.<br \/>\nThe source of the original problem was reported as a Debian bug. The assumption from the reading of the license in this instance is that you are not allowed to distribute MySQL [&#8230;]<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[],"tags":[36],"_links":{"self":[{"href":"https:\/\/planet.mcb.guru\/index.php?rest_route=\/wp\/v2\/posts\/1122"}],"collection":[{"href":"https:\/\/planet.mcb.guru\/index.php?rest_route=\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/planet.mcb.guru\/index.php?rest_route=\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/planet.mcb.guru\/index.php?rest_route=\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/planet.mcb.guru\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=1122"}],"version-history":[{"count":0,"href":"https:\/\/planet.mcb.guru\/index.php?rest_route=\/wp\/v2\/posts\/1122\/revisions"}],"wp:attachment":[{"href":"https:\/\/planet.mcb.guru\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=1122"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/planet.mcb.guru\/index.php?rest_route=%2Fwp%2Fv2%2Fcategories&post=1122"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/planet.mcb.guru\/index.php?rest_route=%2Fwp%2Fv2%2Ftags&post=1122"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}