[devscripts] 01/01: uscan: update manpage

[Osamu Aoki]

This is an automated email from the git hooks/post-receive script.

osamu pushed a commit to branch master
in repository devscripts.

commit 7f07b7bcca004144368d4b14634373c44e4e96b4
Author: Osamu Aoki <osamu at debian.org>
Date:   Fri Mar 31 02:33:36 2017 +0900

    uscan: update manpage
---
 debian/changelog |  9 +++++++++
 scripts/uscan.pl | 18 +++++++++++++++---
 2 files changed, 24 insertions(+), 3 deletions(-)

diff --git a/debian/changelog b/debian/changelog
index 0c32aaa..bf47423 100644
--- a/debian/changelog
+++ b/debian/changelog
@@ -1,3 +1,12 @@
+devscripts (2.17.6) UNRELEASED; urgency=medium
+
+  [ Osamu Aoki ]
+  * uscan:
+    + Update manpage on the github.com behavior and the alternative
+      shorthand form.  (Closes: #836507, #859089)
+
+ -- Osamu Aoki <osamu at debian.org>  Fri, 31 Mar 2017 02:03:30 +0900
+
 devscripts (2.17.5) unstable; urgency=medium
 
   * Create GNUPGHOME in /tmp to fix CI failures due to long path names.
diff --git a/scripts/uscan.pl b/scripts/uscan.pl
index 8bd5273..fb13afd 100755
--- a/scripts/uscan.pl
+++ b/scripts/uscan.pl
@@ -885,7 +885,16 @@ watch file:
       Text-CSV_XS-(.+)\.tar\.gz \
       debian uupdate
 
-can be rewritten in an alternative shorthand form:
+can be rewritten in an alternative shorthand form only with a single string
+covering URL and filename:
+
+  version=4
+  opts="pgpsigurlmangle=s%$%.sig%" \
+      http://www.cpan.org/modules/by-module/Text/Text-CSV_XS-(.+)\.tar\.gz \
+      debian uupdate
+
+In version=4, initial white spaces are dropped.  Thus, this alternative
+shorthand form can also be written as:
 
   version=4
   opts="pgpsigurlmangle=s%$%.sig%" \
@@ -893,8 +902,8 @@ can be rewritten in an alternative shorthand form:
       Text-CSV_XS-(.+)\.tar\.gz \
       debian uupdate
 
-Please note that I<matching-pattern> of the first example doesn't have
-directory and the subtle difference of a space before the tailing B<\>.
+Please note that the subtle difference of a space before the tailing B<\>
+between the first and the last examples.
 
 =head2 HTTP site (funny version)
 
@@ -1066,6 +1075,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

-- 
Alioth's /usr/local/bin/git-commit-notice on /srv/git.debian.org/git/collab-maint/devscripts.git