Hi John, Am Donnerstag, den 19.12.2013, 09:05 -0800 schrieb John MacFarlane: > I plan to put out a new pandoc release in the next couple weeks. I'd be > happy to fix any issues that are causing problems for Debian packaging. > Just explain to me clearly what those issues are (e.g. which javascript > code you're talking about).
Jonas may amend this if I miss anything, but the general idea is: * Ship all files required at run time (i.e. do not rely on the ability to download files when the user runs the program). * Include a “source” version of all files. For Javascript, this is usually the commented, unminimized version, but if it was created from a different file (e.g. compiles from a different programming language), include that source. * If you include a minimized version of the script, include the source, even if you download the minimized version from somewhere and would usually not bother about the source? * Ideally, do any processing steps (e.g. minification) at build time. If that is not feasible, verify that you really have the source for the given file (e.g. by manually doing the minification), and document the building process. * Ideally use a minimizer available in Debian. yui-compressor is available, node-uglify is available, the uglify-script in jquery/build is not avilable (too lazy to find out why). If this sound too buerocratic, then ask yourself the question “If my users want to change any functionality of may package, can they do that, and can they build the modified code, without external, possibly non-free tools”. All the bullet points turn out to be necessary conditions. The Debian package maintainer can still chose to replace a file that you shipped by an equivalent in an existing Debian package (e.g. libjquery-js), to avoid code duplication. But that is nothing you have to worry about. Thanks for taking Distribution issues seriously! Greetings, Joachim -- Joachim "nomeata" Breitner Debian Developer nome...@debian.org | ICQ# 74513189 | GPG-Keyid: 4743206C JID: nome...@joachim-breitner.de | http://people.debian.org/~nomeata
signature.asc
Description: This is a digitally signed message part