Bug#859089: [uscan] Please document Github's disparity between "tags" and "releases" re. Git submodules

[Chris Lamb]

Source: devscripts
Version: 2.17.5
Severity: wishlist
Tags: wishlist
User: devscripts at packages.debian.org
Usertags: uscan

Hi,

The folllowing file includes git submodules (under externals/):

  https://github.com/vrana/adminer/releases/download/v4.3.0/adminer-4.3.0.tar.gz

… whilst this one does not:

  https://github.com/vrana/adminer/archive/v4.3.0.tar.gz

This is either a bug in Github itself or something that needs documenting
in uscan.

Patch attached (for the latter…!)


Regards,

-- 
      ,''`.
     : :'  :     Chris Lamb
     `. `'`      lamby at debian.org / chris-lamb.co.uk
       `-
-------------- next part --------------
diff --git a/scripts/uscan.pl b/scripts/uscan.pl
index 8bd5273..1661981 100755
--- a/scripts/uscan.pl
+++ b/scripts/uscan.pl
@@ -1066,6 +1066,9 @@ B<filenamemangle>:
       https://github.com/<user>/<project>/tags \
       (?:.*?/)?v?(\d[\d.]*)\.tar\.gz debian uupdate
 
+Note that the "tags" downloads do not include Git submodules in the .tar.gz
+whilst the "releases" do.
+
 =head2 PyPI
 
 For PyPI based projects, pypi.debian.net runs a redirector which allows a