[devscripts] 01/01: uscan: clarify the importance of version=4

[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 57ea0c53772767beb3e44697562ef821ceb9dfd4
Author: Osamu Aoki <osamu at debian.org>
Date:   Fri Jan 12 20:08:03 2018 +0900

    uscan: clarify the importance of version=4
    
    Although the current uscan manpage had clearly stated in its "HISTORY AND
    UPGRADING" as:
    
     Version 4
         devscripts version 2.15.10: The first incarnation of watch files
         supporting multiple upstream tarballs.
    
         The syntax of the watch file is relaxed to allow more spaces for
         readability.
    
         If you have a custom script in place of uupdate, you may also
         encounter problems updating from Version 3.
    
         ·   uscan invokes the custom script as "script --upstream-version
             version".
    
         ·   uscan invokes the standard uupdate as "uupdate --find
             --upstream-version version".
    
         Restriction for --dehs is lifted by redirecting other output to
         STDERR when it is activated.
    
    People seem to expect Version 3 to be relaxed to allow more spaces.
    
    So I am adding link and emphasizing the importance of version=4 in earlier
    section.  After all uscan manpage is too long to read.
    
    Signed-off-by: Osamu Aoki <osamu at debian.org>
---
 debian/changelog | 1 +
 scripts/uscan.pl | 5 ++++-
 2 files changed, 5 insertions(+), 1 deletion(-)

diff --git a/debian/changelog b/debian/changelog
index 0c44070..639dec7 100644
--- a/debian/changelog
+++ b/debian/changelog
@@ -18,6 +18,7 @@ devscripts (2.18.1) UNRELEASED; urgency=medium
 
   [ Osamu Aoki ]
   * uupdate: bash completion fix by Julian Gilbey.  Closes: #834006 
+  * uscan: clarify importance of version=4.  Closes: #505857
 
  -- Mattia Rizzolo <mattia at debian.org>  Wed, 03 Jan 2018 14:31:54 +0100
 
diff --git a/scripts/uscan.pl b/scripts/uscan.pl
index dd6b24c..1377b85 100755
--- a/scripts/uscan.pl
+++ b/scripts/uscan.pl
@@ -138,7 +138,10 @@ of the space before the tailing single B<\> is significant.)
 
 =back
 
-This is required.
+This is a required line and the recommended version number.
+
+If you use "B<version=3>" instead here, many features may not work as
+documented here.  See L<HISTORY AND UPGRADING>.
 
 =item * The following non-comment lines (watch lines) specify the rules for the
 selection of the candidate upstream tarball URLs and are in one of the

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