Provided by: pkg-components_0.10_all bug


       uscan-components - wrapper around uscan for package and components


       uscan-components [options]


       "uscan-components" is a wrapper around "uscan" for packages using "dh_components". Firstly
       it will check that both the package and all the components have watch files; and will
       return an error if they do not.  Then it will run uscan on the main watch file. If that
       downloads something it will run uscan on each of the components. It accepts a number of
       uscan options all of which are passed onto to each invocation of uscan.


           By default the current versions of the various components will be downloaded.  This
           resolves into --force-download and either --download-current-version or
           --upstream-version for the main and component tarballs respectively.  The current
           versions of the components are stored in the files:
           "debian/components/"comp"/version".  If the --upgrade option is applied then instead
           the latest version will be requested and the version files updated accordingly.

           This option calls "uupdate -f" to create a buildable source package directory.

           If set no actual uscan will not actually be called but those that might be will be

           Prints a brief help message and exits.

           Prints the manual page and exits.

           These options simulate the verbosity flag being passed to "uscan".  The actual
           invocations must always be verbose as the information is required to correctly rename
           the component files. However the output is not passed back to the user if verbosity is
           turned off.

       --user-agent, --useragent
           All of the these arguments are passed straight to each uscan invocation.


       For each component the watch file is assumed to be in
       "debian/components/"component"/watch" and the component version is maintained in




       Nicholas Bamber <>