.\" 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_SPLIT 1p"
.TH TV_SPLIT 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_split \- Split XMLTV listings into separate files by date and
channel.
.SH "SYNOPSIS"
.IX Header "SYNOPSIS"
tv_split \-\-output \s-1TEMPLATE\s0 [\s-1FILE...\s0]
.SH "DESCRIPTION"
.IX Header "DESCRIPTION"
Read \s-1XMLTV\s0 listings and split them into some number of output files.
The output file chosen for each programme is given by substitutions on
the filename template supplied.  You can split listings by time and by
channel.
.PP
The \s-1TEMPLATE\s0 is a filename but substitutions are applied: first
\&\f(CW%channel\fR is replaced with the id of a programme's channel, and
then Date::Manip substitutions (which broadly follow \fIdate\fR\|(1))
are applied based on the start time of each programme.  In this way
each programme is written to a particular output file.  When an output
file is created it will also contain all the channel elements from the
input.
.PP
One or more input files can be given; if more than one then they are
concatenated in the same way as tv_cat.  If no input files are
given then standard input is read.
.SH "EXAMPLE"
.IX Header "EXAMPLE"
Use \f(CW\*(C`tv_split \-\-output %channel\-%Y%m%d.xml\*(C'\fR to separate standard
input into separate files for each day and channel.  The files will be
created with names like \fBbbc1.bbc.co.uk\-20020330.xml\fR.
.SH "SEE ALSO"
.IX Header "SEE ALSO"
\&\fIDate::Manip\fR\|(3).
.SH "AUTHOR"
.IX Header "AUTHOR"
Ed Avis, ed@membled.com.