tv_sort(1p) [debian man page]

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

NAME

       tv_sort - Sort XMLTV listings files by date, and add stop times.

SYNOPSIS

       tv_sort [--help] [--by-channel] [--output FILE] [FILE...]

DESCRIPTION

       Read XMLTV data and write out the same data sorted in date order.  Where stop times of programmes are missing, guess them from the start
       time of the next programme on the same channel. For the last programme of a channel, no stop time can be added.

       Tv_sort also performs some sanity checks such as making sure no two programmes on the same channel overlap.

       --output FILE write to FILE rather than standard output

       --by-channel sort first by channel id, then by date within each
		       channel.

       --duplicate-error If the input contains the same programme more than once,
			    consider this as an error. Default is to silently
			    ignore duplicate entries.

       The time sorting is by start time, then by stop time.  Without --by-channel, if start times and stop times are equal then two programmes
       are sorted by internal channel id.  With --by-channel, channel id is compared first and then times.

       You can think of tv_sort as converting XMLTV data into a canonical form, useful for diffing two files.

EXAMPLES

       At a typical Unix shell or Windows command prompt:

       tv_sort <in.xml >out.xml
       tv_sort in.xml --output out.xml

       These are different ways of saying the same thing.

AUTHOR

       Ed Avis, ed@membled.com

perl v5.14.2							    2006-03-02							       TV_SORT(1p)

Summarize(3pm)						User Contributed Perl Documentation					    Summarize(3pm)

NAME

       XMLTV::Summarize - Perl extension to summarize XMLTV data

SYNOPSIS

	   # First get some data from the XMLTV module, eg:
	   use XMLTV;
	   my $data = XMLTV::parsefile('tv_sorted.xml');
	   my ($encoding, $credits, $ch, $progs) = @$data;

	   # Now turn the sorted programmes into a printable summary.
	   use XMLTV::Summarize qw(summarize);
	   foreach (summarize($ch, $progs)) {
	       if (not ref) {
		   print "
Day: $_

";
	       }
	       else {
		   my ($start, $stop, $title, $sub_title, $channel) = @$_;
		   print "programme starts at $start, ";
		   print "stops at $stop, " if defined $stop;
		   print "has title $title ";
		   print "and episode title $sub_title" if defined $sub_title;
		   print ", on channel $channel.
";
	       }
	   }

DESCRIPTION

       This module processes programme and channel data from the XMLTV module to help produce a human-readable summary or TV guide.  It takes care
       of choosing the correct language (based on the LANG environment variable) and of looking up the name of channels from their id.

       There is one public routine, "summarize()".  This takes (references to) a channels hash and a programmes list, the same format as those
       returned by the XMLTV module.  It returns a list of 'summary' elements where each element is a list of five items: start time, stop time,
       title, 'sub-title', and channel name.  The stop time and sub-title may be undef.

       The times are formatted as hh:mm, with a timezone appended when the timezone changes in the middle of listings.	For the titles and channel
       name, the shortest string that is in an acceptable language is chosen.

       The list of acceptable languages normally contains just one element, taken from LANG, but you can set it manually as
       @XMLTV::Summarize::PREF_LANGS if wished.

AUTHOR

       Ed Avis, ed@membled.com

SEE ALSO

       XMLTV(1).

perl v5.14.2							    2004-01-03							    Summarize(3pm)