.\" 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
.    \}
.\}
.\" ========================================================================
.\"
.IX Title "TV_GRAB_COMBINER 1p"
.TH TV_GRAB_COMBINER 1p "2017-01-24" "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"
tv_grab_combiner \- Grab listings by combining data from several grabbers.
.SH "SYNOPSIS"
.IX Header "SYNOPSIS"
tv_grab_combiner \-\-help
.PP
tv_grab_combiner \-\-configure [\-\-config\-file \s-1FILE\s0]
.PP
tv_grab_combiner [\-\-config\-file \s-1FILE\s0]
                 [\-\-days N] [\-\-offset N]
                 [\-\-output \s-1FILE\s0] [\-\-quiet]
.SH "DESCRIPTION"
.IX Header "DESCRIPTION"
Output \s-1TV\s0 and listings in \s-1XMLTV\s0 format by combining data from several
other grabbers.
.PP
First you must run \fBtv_grab_combiner \-\-configure\fR to choose which grabbers
you want to grab data with and how these grabbers should be configured.
.PP
Then you can run \fBtv_grab_combiner\fR with the \-\-days and \-\-offset options
to grab data. Omitting these options will use the default values for these
parameters for each grabber. Since these defaults differs between grabbers,
you might end up with data for different periods of time for different
channels.
.SH "OPTIONS"
.IX Header "OPTIONS"
\&\fB\-\-configure\fR Prompt for which grabbers to use, how these grabbers shall
be configured and write the configuration file.
.PP
\&\fB\-\-config\-file \s-1FILE\s0\fR Set the name of the configuration file, the
default is \fB~/.xmltv/tv_grab_combiner.conf\fR.  This is the file written by
\&\fB\-\-configure\fR and read when grabbing.
.PP
\&\fB\-\-output \s-1FILE\s0\fR When grabbing, write output to \s-1FILE\s0 rather than
standard output.
.PP
\&\fB\-\-days N\fR When grabbing, grab N days rather than 5.
.PP
\&\fB\-\-offset N\fR Start grabbing at today + N days.  N may be negative.
.PP
\&\fB\-\-quiet\fR Suppress the progress-bar normally shown on standard error.
.PP
\&\fB\-\-version\fR Show the version of the grabber.
.PP
\&\fB\-\-help\fR Print a help message and exit.
.SH "ERROR HANDLING"
.IX Header "ERROR HANDLING"
If any of the called grabbers exit with an error, tv_grab_combiner will
exit with a status code of 1 to indicate that the data is incomplete. If any
grabber produces output that is not well-formed xml, the output from that
grabber will be ignored and tv_grab_combiner will exit with a status code of 1.
.SH "ENVIRONMENT VARIABLES"
.IX Header "ENVIRONMENT VARIABLES"
The environment variable \s-1HOME\s0 can be set to change where configuration
files are stored. All configuration is stored in \f(CW$HOME\fR/.xmltv/.
.SH "AUTHOR"
.IX Header "AUTHOR"
Mattias Holmlund, mattias \-at\- holmlund \-dot\- se.
.SH "BUGS"
.IX Header "BUGS"