[SCM] unicap/master: Added README.source explaining on how to get the sources

[umlaeute at users.alioth.debian.org]

The following commit has been merged in the master branch:
commit 7af82b5af722dfbb2af60903f49628a97f2e83eb
Author: IOhannes m zmölnig <zmoelnig at umlautQ.umlaeute.mur.at>
Date:   Tue Oct 3 15:37:14 2017 +0200

    Added README.source explaining on how to get the sources

diff --git a/debian/README.source b/debian/README.source
new file mode 100644
index 0000000..a4961a1
--- /dev/null
+++ b/debian/README.source
@@ -0,0 +1,27 @@
+unicap for Debian
+=================
+
+# obtaining upstream sources
+Traditionally, the Debian "unicap" package contains the "libunicap" component
+of the unicap project.
+Now, upstream no longer provides downloadable files for the various unicap
+components.  Instead, everything was moved into a single big repository on
+GitHub, with the components being subdirectories.
+
+Each component uses different release cycles and versions.
+However, due to the way GitHub works, one cannot download a single component
+from a full repository.
+Additionally, recent releases have not been tagged yet.
+
+For the time being, the upstream source is manually extracted from the
+repository, with something like:
+
+~~~
+git clone https://github.com/unicap/unicap.git
+cd unicap
+SHA=$(git log -1 --pretty=format:%h libunicap)
+DATE=$(git log -1 --pretty=format:%cd --date=format:'%Y%m%d' ${SHA})
+tar cvzf libunicap-0.9.12+repack.git${DATE}.0.${SHA}.tar.gz  libunicap
+~~~
+
+ -- IOhannes m zmölnig (Debian/GNU) <umlaeute at debian.org>  Tue, 03 Oct 2017 11:37:52 +0200

-- 
unicap packaging