debian man page for tv_split

TV_SPLIT(1p)						User Contributed Perl Documentation					      TV_SPLIT(1p)

NAME
       tv_split - Split XMLTV listings into separate files by date and channel.

SYNOPSIS
       tv_split --output TEMPLATE [FILE...]

DESCRIPTION
       Read XMLTV 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.

       The TEMPLATE is a filename but substitutions are applied: first %channel is replaced with the id of a programme's channel, and then
       Date::Manip substitutions (which broadly follow date(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.

       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.

EXAMPLE
       Use "tv_split --output %channel-%Y%m%d.xml" to separate standard input into separate files for each day and channel.  The files will be
       created with names like bbc1.bbc.co.uk-20020330.xml.

SEE ALSO
       Date::Manip(3).

AUTHOR
       Ed Avis, ed@membled.com.

perl v5.14.2							    2004-01-20							      TV_SPLIT(1p)