1 files changed, 20 insertions, 0 deletions
diff --git a/debian/README.source b/debian/README.source
new file mode 100644
index 0000000..e2a53fa
--- /dev/null
+++ b/debian/README.source
@@ -0,0 +1,20 @@
+
+* As requested by ftpmaster, the upstream tarball is repacked to
+  remove minified javascript files.
+
+* Since removing just the minified javascript files would leave the
+  rest of them broken, we are removing the entire pre-rendered HTML
+  documentation. There is no loss of information, since the entire
+  documentation (including the problematic javascript files) is
+  regenerated during build.
+
+* Repackaging of the upstream tarball is done with uscan. The list of
+  excluded files is specified in the Files-Excluded paragraph in
+  debian/copyright. To retrieve and repack the latest upstream
+  tarball, run
+
+  # PERL_LWP_SSL_VERIFY_HOSTNAME=0 uscan --repack
+
+  (Deactivating hostname verification isn't a problem because the
+  upstream tarball is GPG signed, but necessary to work around
+  bug #749225.)