.\" Automatically generated by Pod::Man 4.07 (Pod::Simple 3.32)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" Set up some character translations and predefined strings.  \*(-- will
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
.\" double quote, and \*(R" will give a right double quote.  \*(C+ will
.\" give a nicer C++.  Capital omega is used to do unbreakable dashes and
.\" therefore won't be available.  \*(C` and \*(C' expand to `' in nroff,
.\" nothing in troff, for use with C<>.
.tr \(*W-
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
.ie n \{\
.    ds -- \(*W-
.    ds PI pi
.    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
.    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
.    ds L" ""
.    ds R" ""
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds -- \|\(em\|
.    ds PI \(*p
.    ds L" ``
.    ds R" ''
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.if !\nF .nr F 0
.if \nF>0 \{\
.    de IX
.    tm Index:\\$1\t\\n%\t"\\$2"
..
.    if !\nF==2 \{\
.        nr % 0
.        nr F 2
.    \}
.\}
.\"
.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
.\" Fear.  Run.  Save yourself.  No user-serviceable parts.
.    \" fudge factors for nroff and troff
.if n \{\
.    ds #H 0
.    ds #V .8m
.    ds #F .3m
.    ds #[ \f1
.    ds #] \fP
.\}
.if t \{\
.    ds #H ((1u-(\\\\n(.fu%2u))*.13m)
.    ds #V .6m
.    ds #F 0
.    ds #[ \&
.    ds #] \&
.\}
.    \" simple accents for nroff and troff
.if n \{\
.    ds ' \&
.    ds ` \&
.    ds ^ \&
.    ds , \&
.    ds ~ ~
.    ds /
.\}
.if t \{\
.    ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
.    ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
.    ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
.    ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
.    ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
.    ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
.\}
.    \" troff and (daisy-wheel) nroff accents
.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
.ds 8 \h'\*(#H'\(*b\h'-\*(#H'
.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
.ds ae a\h'-(\w'a'u*4/10)'e
.ds Ae A\h'-(\w'A'u*4/10)'E
.    \" corrections for vroff
.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
.    \" for low resolution devices (crt and lpr)
.if \n(.H>23 .if \n(.V>19 \
\{\
.    ds : e
.    ds 8 ss
.    ds o a
.    ds d- d\h'-1'\(ga
.    ds D- D\h'-1'\(hy
.    ds th \o'bp'
.    ds Th \o'LP'
.    ds ae ae
.    ds Ae AE
.\}
.rm #[ #] #H #V #F C
.\" ========================================================================
.\"
.IX Title "USCAN-COMPONENTS 1p"
.TH USCAN-COMPONENTS 1p "2018-09-09" "perl v5.24.1" "User Contributed Perl Documentation"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH "NAME"
uscan\-components \- wrapper around uscan for package and components
.SH "SYNOPSIS"
.IX Header "SYNOPSIS"
\&\fBuscan-components\fR [\fIoptions\fR]
.SH "DESCRIPTION"
.IX Header "DESCRIPTION"
\&\f(CW\*(C`uscan\-components\*(C'\fR is a wrapper around \f(CW\*(C`uscan\*(C'\fR for packages using
\&\f(CW\*(C`dh_components\*(C'\fR. 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.
.SH "OPTIONS"
.IX Header "OPTIONS"
.IP "\fB\-\-upgrade\fR" 4
.IX Item "--upgrade"
.PD 0
.IP "\fB\-\-no\-upgrade\fR" 4
.IX Item "--no-upgrade"
.PD
By default the current versions of the various components will be downloaded.
This resolves into \fB\-\-force\-download\fR and either \fB\-\-download\-current\-version\fR
or \fB\-\-upstream\-version\fR for the main and component tarballs respectively.
The current versions of the components are stored in the files:
\&\f(CW\*(C`debian/components/\*(C'\fR\fIcomp\fR\f(CW\*(C`/version\*(C'\fR.
If the \fB\-\-upgrade\fR option is applied then instead the latest version will
be requested and the version files updated accordingly.
.IP "\fB\-\-update\fR" 4
.IX Item "--update"
.PD 0
.IP "\fB\-\-no\-update\fR" 4
.IX Item "--no-update"
.PD
This option calls \f(CW\*(C`uupdate \-f\*(C'\fR to create a buildable source package directory.
.IP "\fB\-\-dry\-run\fR" 4
.IX Item "--dry-run"
If set no actual uscan will not actually be called but those that might be
will be listed.
.IP "\fB\-\-help\fR" 4
.IX Item "--help"
Prints a brief help message and exits.
.IP "\fB\-\-man\fR" 4
.IX Item "--man"
Prints the manual page and exits.
.IP "\fB\-\-verbose\fR" 4
.IX Item "--verbose"
.PD 0
.IP "\fB\-\-no\-verbose\fR" 4
.IX Item "--no-verbose"
.PD
These options simulate the verbosity flag being passed to \f(CW\*(C`uscan\*(C'\fR.
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.
.IP "\fB\-\-report\fR" 4
.IX Item "--report"
.PD 0
.IP "\fB\-\-report\-status\fR" 4
.IX Item "--report-status"
.IP "\fB\-\-pasv\fR" 4
.IX Item "--pasv"
.IP "\fB\-\-no\-pasv\fR" 4
.IX Item "--no-pasv"
.IP "\fB\-\-timeout\fR" 4
.IX Item "--timeout"
.IP "\fB\-\-debug\fR" 4
.IX Item "--debug"
.IP "\fB\-\-user\-agent\fR, \fB\-\-useragent\fR" 4
.IX Item "--user-agent, --useragent"
.PD
All of the these arguments are passed straight to each uscan invocation.
.SH "FILES"
.IX Header "FILES"
For each component the watch file is assumed to be in
\&\f(CW\*(C`debian/components/\*(C'\fR\fIcomponent\fR\f(CW\*(C`/watch\*(C'\fR and the component
version is maintained in \f(CW\*(C`debian/components/\*(C'\fR\fIcomponent\fR\f(CW\*(C`/version\*(C'\fR.
.SH "SEE ALSO"
.IX Header "SEE ALSO"
\&\fIuscan\fR\|(1)
.SH "AUTHOR"
.IX Header "AUTHOR"
Nicholas Bamber <nicholas@periapt.co.uk>