Bug #67400 Please provide the documentation source in the tarball
Submitted: 28 Oct 2012 16:07 Modified: 26 Feb 2013 13:04
Reporter: Sandro Tosi Email Updates:
Status: Closed Impact on me:
None 
Category:Connector / Python Severity:S3 (Non-critical)
Version:1.0.7 OS:Any
Assigned to: Geert Vanderkelen CPU Architecture:Any

[28 Oct 2012 16:07] Sandro Tosi
Description:
Hello,
I'm the Debian packager for MySQL Connector/Python and we have an internal policy that requires to rebuild the documentation from the "editing preferred format" (the file you'd want to edit and that will allow to regenerate the doc in all formats).

I noticed that in the tarball the docs is provided in 3 formats: HTML, PDF and TXT.

From the mentioned policy above, currently I'm allowed to ship in the packages only the TXT format (given the others are unlikely to be the source format).

What I'd like to ask you is to ship the source "code" for the documentation in the tarball, so that I'll be able to rebuild (so please add also compilation details :) ) the doc in HTML+PDF format and then ship them in the packages, which are more user friendly than just TXT.

Thanks for considering,
Sandro

How to repeat:
No doc source in the downloadable tarball.
[14 Dec 2012 17:25] Sveta Smirnova
Thank you for the feature request.

I set this to "Verified", but I am not sure our documentation license allows us to ship source code for everybody. Anyway, this would be considered.