
Contributions from other developers are welcome, instead of making an
NMU, please consider joining pkg-voip

Whether you are making an NMU or adding yourself in the pkg-voip
team, please make sure any changes you make are tagged and pushed into the
Git repository on alioth before you upload.

uscan
-----

Upstream tags releases with multiple names, e.g. 5.0.5 and 5.0.5-api,
this isn't good for the default uscan configuration.  The regex pattern
in debian/watch has been tweaked to only accept versions ending with a
digit.  Use

   uscan --force-download

to ensure it really downloads.

PostgreSQL or MySQL?
--------------------

upstream provides alternate versions of certain files for MySQL
and PostgreSQL.  Therefore, these are distributed in two
different binary packages.  The user must install only one of these
packages as otherwise files would be overwritten by the other package.
This could be improved upstream to make the choice of database
configurable in a more flexible manner.

apidoc
------

In theory, the apidoc tree should be installed under /usr/share/doc,
possibly as a -doc package.

However, it includes a PHP file, so it is installed in the location
for web content.  Maybe the Makefile could invoke PHP to create
static content so that it can be browsed offline.

Removed JavaScript
------------------

There is a lot of minified JavaScript under apidoc/html/vendor.
For simplicity, it has simply been removed as the package functions
correctly without the apidoc tree.  Most of the dependencies are
actually available as packages, it is necessary to either package
the remaining dependencies or change the upstream code to stop using
some of them.

These are the JavaScript libraries identified in apidoc/html/vendor:

  Available in Debian:
     bootstrap
     jquery.min.js
     lodash.min.js
       https://lodash.com/
       https://packages.debian.org/sid/web/libjs-lodash
     prettify
       https://github.com/google/code-prettify
       https://packages.debian.org/sid/libjs-prettify
     require.min.js
       http://github.com/jrburke/requirejs
       https://packages.qa.debian.org/r/requirejs.html
     path-to-regexp
       https://github.com/pillarjs/path-to-regexp
       https://packages.qa.debian.org/n/node-path-to-regexp.html

  Soon available in Debian:
     diff_match_patch.min.js
       https://code.google.com/p/google-diff-match-patch/
       ITP: http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=837746
         uploaded 2016-09-14

  Not yet available in Debian:
     handlebars.min.js
       https://github.com/wycats/handlebars.js/
       https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=779303
       https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=830987
     polyfill.js
       appears to be concatenated examples taken from these pages:
       https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object/keys
       https://developer.mozilla.org/en/docs/Web/JavaScript/Reference/Global_Objects/Array/indexOf

