[Python-modules-commits] [notebook] 01/01: Add README.source

[Gordon Ball]

This is an automated email from the git hooks/post-receive script.

chronitis-guest pushed a commit to branch master
in repository notebook.

commit 7a02ebf91226090a4568038961bbe8299a935930
Author: Gordon Ball <gordon at chronitis.net>
Date:   Thu Oct 20 19:41:09 2016 +0200

    Add README.source
---
 debian/README.source | 23 +++++++++++++++++++++++
 1 file changed, 23 insertions(+)

diff --git a/debian/README.source b/debian/README.source
new file mode 100644
index 0000000..32554ff
--- /dev/null
+++ b/debian/README.source
@@ -0,0 +1,23 @@
+jupyter-notebook packaging
+--------------------------
+
+The upstream tarball from github is used instead of the pypi tarball, since the
+latter does not contain required source (eg, less files) but does contain
+bundled JS libraries and minified source which would in any case need removing.
+
+There are two testsuites - one in python testing server responses and one in
+javascript using browser emulation to test the web application. The former is
+run during build, but the latter requires phantomjs and casperjs (unpackaged)
+so is not currently run. (The <nocheck> option is supported, which should
+significantly shorten the build-depends).
+
+All javascript except google-caja are symlinked from libjs-* packages, both
+during build and for the binary package. Google-caja (HTML and CSS sanitizer)
+javascript files are included in debian/missing-source. These files come from
+[1], which appears to have been set up by the jupyter team to provide a
+bower-installable javascript package containing files picked from upstream [2].
+The relevant files are concat'd and minified during build, and all appear to
+contain Apache-2.0 grants.
+
+[1]: https://github.com/minrk/google-caja-bower
+[2]: https://github.com/google/caja

-- 
Alioth's /usr/local/bin/git-commit-notice on /srv/git.debian.org/git/python-modules/packages/notebook.git