[SCM] soundscaperenderer/master: note on upstream location

[zmoelnig-guest at users.alioth.debian.org]

The following commit has been merged in the master branch:
commit 6c16f315d46d4f1748e3bcf4e86787d614de507d
Author: IOhannes m zmölnig <zmoelnig at umlautQ.umlaeute.mur.at>
Date:   Mon Mar 10 11:31:03 2014 +0100

    note on upstream location
    
    why we track github rather than the official "upstream-downloads"

diff --git a/debian/README.source b/debian/README.source
new file mode 100644
index 0000000..ad96532
--- /dev/null
+++ b/debian/README.source
@@ -0,0 +1,24 @@
+sources for soundscape renderer (SSR)
+-------------------------------------
+
+download location
+-----------------
+SSR can be downloaded both from
+ - http://spatialaudio.net/ssr/download/
+and via a "tagged release" from
+ - https://github.com/SoundScapeRenderer/
+
+While releases from the two locations *should* be the same,
+in practice it seems that they are not.
+noteable differences:
+ - github releases do not have autotools files pregenerated
+ - github releases do not have the manual pdf precompiled
+ - spatialaudio releases lack the source code for the manual pdf
+
+ - github releases include complete APF-tree
+ - spatialautio releases only include APF headers
+ - github releases include MEX-files
+
+In order to be able to (re)generate the manual pdf, the Debian package tracks
+the github release tags rather than the downloadable files from
+spatialaudio.net.

-- 
soundscaperenderer packaging