[devscripts] 02/04: uscan: update manpage (repack and compress)

[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 a626d76d7530d9b4ae9892589b6691402ec53494
Author: Osamu Aoki <osamu at debian.org>
Date:   Sun Nov 15 01:37:50 2015 +0900

    uscan: update manpage (repack and compress)
    
    Fix #648632
---
 scripts/uscan.pl | 28 +++++++++++++++++-----------
 1 file changed, 17 insertions(+), 11 deletions(-)

diff --git a/scripts/uscan.pl b/scripts/uscan.pl
index 8b6f432..20ba396 100755
--- a/scripts/uscan.pl
+++ b/scripts/uscan.pl
@@ -297,7 +297,10 @@ Set the name of the secondary source tarball as I<<
 Set the compression I<method> when the tarball is repacked. (persistent)
 
 Available I<method> values are B<xz>, B<gzip> (alias B<gz>), B<bzip2> (alias
-B<bz2>), and B<lzma>.
+B<bz2>), and B<lzma>.  The default is B<gzip>.
+
+If the debian source format is not in the old 1.0, setting this to B<xz> should
+help reduce the package size when the package is repacked.
 
 Please note the repack of the upstream tarballs happen only if one of the
 following condition is satisfied:
@@ -611,14 +614,6 @@ The upstream tarball href corresponding to the newest (uversionmangled)
 candidate upstream version newer than the (dversionmangled) last upstream
 version is selected.
 
-If the B<filenamemangle> rule exists, the downloaded tarball filename is
-generated by applying this rule to the selected href. (This rule may not be as
-significant for the modern use case of B<uscan>.  B<mk-origtargz> takes care
-the proper renaming of the source tarballs into <spkg>_<oversion>.orig.tar.gz
-based on the source package name in F<debian/changelog> without relying on the
-filename of the remote URL.  Now, B<uupdate> is invoked by B<uscan> with
-B<--find> option and is not expected to rename the downloaded tarball anymore.)
-
 If the selected upstream tarball href is the relative URL, it is converted to
 the absolute URL using the base URL of the web page.  If the B<< <base href="
 >> I< ... > B<< "> >> tag exists in the web page, the selected upstream tarball
@@ -629,6 +624,17 @@ If the B<downloadurlmangle> rule exists, the selected upstream tarball href is
 normalized by applying this rule to it. (This is useful for some sites with the
 obfuscated download URL.)
 
+If the B<filenamemangle> rule exists, the downloaded tarball filename is
+generated by applying this rule to the selected href if I<matching-pattern> can
+extract the latest upstream version I<< <uversion> >> from the selected href
+string. Otherwise, generate the upstream tarball filename from its full URL
+string and set the missing I<< <uversion> >> from the generated upstream
+tarball filename.
+
+Without the B<filenamemangle> rule, the default upstream tarball filename is
+generated by taking the last component of the URL and removing everything after
+any '?' or '#'.
+
 B<uscan> downloads the selected upstream tarball to the parent B<../>
 directory.  For example, the downloaded file may be:
 
@@ -1408,8 +1414,8 @@ equivalent to the B<--destdir> option.
 =item B<USCAN_REPACK>
 
 If this is set to yes, then after having downloaded a bzip tar, lzma tar, xz
-tar, or zip archive, uscan will repack it to a gzip tar. This is equivalent to
-the B<--repack> option.
+tar, or zip archive, uscan will repack it to the specified compression (see
+B<--compression>). This is equivalent to the B<--repack> option.  
 
 =item B<USCAN_EXCLUSION>
 

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