tarball contains only minified versions of javascript libraries

[Piotr Ożarowski]

Hi,

Could you please add sources (i.e. not only minified versions) for below files in the tarball?

• doc/_static/jquery.js
• doc/_static/underscore.js

I rebuild docs in Debian anyway, but we distribute original tarball as well and hence need all the sources (I can rebuild the tarball to remove all generated docs, but I'd prefer to keep the original tarball)

[Mike Bayer]

This has come up before but it seems like it wasnt a SQLAlchemy ticket.

1. searchindex.js is not source code, it's a data file. nobody wrote this file.

2. jquery.js/underscore.js come directly from Sphinx. Isn't there a debian package for Sphinx? and if so, why isn't this a Sphinx issue? I'd rather not have to start re-implementing sphinx's source code in my own package.

[Mike Bayer]

the minified versions also have copyright in them. What's the problem here?

[Piotr Ożarowski]

I know all of these files are generated by Sphinx and I didn't see a problem with that, but I guess I will have to repackage the tarball and remove these files to make everyone happy.

[Mike Bayer]

I'd like to raise the issue with sphinx. can you describe the situation fully so that we can give them the rationale ?

[Piotr Ożarowski]

minified versions of libraries are considered non-free in Debian (and AFAICT also f.e. in RedHat/Fedora) so not minifying (at least by default, or adding a switch to disable it) in sphinx-build would be great

[Mike Bayer]

re: https://bitbucket.org/birkenfeld/sphinx/issue/1434/provide-non-minified-options-for-jqueryjs

[Mike Bayer]

sphinx isn't responding to me, so this one will just have to sit out there until someday when someone replies.

[Mike Bayer]

based on the discussion over there it's looking pretty doubtful SQLA's .tar.gz can be packaged as-is into a debian package. It might be helpful if there were some tool that folks could use to package all of my tar.gzs, which are all in the identical format (mako, alembic, dogpile, sqla, etc.) into debian-acceptable packages.

If something changes over there and there's action we can take here, then please reopen.

[Piotr Ożarowski]

I added a comment in sphinx-1434 and hope you reconsider

[Mike Bayer]

if they add a conf.py flag I'll certainly include it. but what else can I do ?

[Mike Bayer]

also what is the definitive answer on the issues of, "redundant source code is not allowed, use symlinks", etc. ?

[Piotr Ożarowski]

perfect solution for us is a tarball with sources only, but if you want to include pregenerated docs as well, it's acceptable

in other words: please use minifiedjs=False once it's available

[Mike Bayer]

will do, can you ping me on that as I'm not necessarily following that issue

[Piotr Ożarowski]

I will, thanks