Description: Add initial POD for tv_grab_tr grabber
Forwarded: not-needed
Author: Nick Morrott <knowledgejunkie@gmail.com>
Last-Update: 2015-06-22

--- a/grab/tr/tv_grab_tr
+++ b/grab/tr/tv_grab_tr
@@ -1,12 +1,6 @@
 #!/usr/bin/perl -w
 
-=pod
-
-Your documentation here... Copy from tv_grab_cz for example.
-
-=cut
-
-my $_version 	= '$Id: tv_grab_tr,v 1.3 2014/07/30 15:54:55 bilbo_uk Exp $';
+my $_version 	= '$Id: tv_grab_tr,v 1.5 2015/06/22 19:54:08 knowledgejunkie Exp $';
 
 eval 'exec /usr/bin/perl -w -S $0 ${1+"$@"}'
     if 0; # not running under some shell
@@ -55,7 +49,7 @@ my $warnings = 0;
 # ------------------------------------------------------------------------------------------------------------------------------------- #
 # Grabber details
 my $VERSION 			= $_version;
-my $GRABBER_NAME 		= 'tv_grab_tr_digiturk';
+my $GRABBER_NAME 		= 'tv_grab_tr';
 my $GRABBER_DESC 		= 'Trkiye - Digiturk (www.digiturk.com.tr)';
 my $GRABBER_URL 		= 'http://wiki.xmltv.org/index.php/XMLTVProject';
 my $ROOT_URL			= 'http://www.digiturk.com.tr/';
@@ -629,4 +623,98 @@ sub initialise_ua {
 		$ua->env_proxy;
 		#
 		return $ua;
-}
\ No newline at end of file
+}
+
+=pod
+
+=head1 NAME
+
+tv_grab_tr - Grab TV listings for Turkey.
+
+=head1 SYNOPSIS
+
+tv_grab_tr --help
+
+tv_grab_tr --configure [--config-file FILE]
+
+tv_grab_tr [--config-file FILE]
+           [--days N] [--offset N]
+           [--output FILE] [--quiet] [--debug]
+
+tv_grab_tr --list-channels [--config-file FILE]
+           [--output FILE] [--quiet] [--debug]
+
+tv_grab_tr --version
+
+tv_grab_tr --capabilities
+
+tv_grab_tr --description
+
+
+=head1 DESCRIPTION
+
+Output TV listings in XMLTV format for many stations
+available in Turkey. Data is downloaded from Digiturk.
+
+First you must run B<tv_grab_tr --configure> to choose which stations
+you want to receive.
+
+Then running B<tv_grab_tr> with no arguments will get listings for
+your chosen stations including today.
+
+=head1 OPTIONS
+
+B<--help> Print a help message and exit.
+
+B<--configure> Prompt for which stations to download and write the
+configuration file.
+
+B<--list-channels> Output a list of all channels that data is available
+for. The list is in xmltv-format.
+
+B<--config-file FILE> Set the name of the configuration file, the
+default is B<~/.xmltv/tv_grab_tr.conf>.  This is the file written by
+B<--configure> and read when grabbing.
+
+B<--output FILE> When grabbing, write output to FILE rather than
+standard output.
+
+B<--days N> When grabbing, grab N days.
+
+B<--offset N> Start grabbing at today + N days.
+
+B<--quiet> Only print error-messages on STDERR.
+
+B<--debug> Provide more information on progress to STDERR to help in
+debugging.
+
+B<--capabilities> Show which capabilities the grabber supports. For more
+information, see L<http://wiki.xmltv.org/index.php/XmltvCapabilities>
+
+B<--version> Show the version of the grabber.
+
+B<--description> Show a brief description of the grabber.
+
+=head1 ERROR HANDLING
+
+If the grabber fails to download listings data for a channel, it will print an
+error message to STDERR and continue with the next configured channel.
+
+=head1 ENVIRONMENT VARIABLES
+
+The environment variable HOME can be set to change where configuration
+files are stored. All configuration is stored in $HOME/.xmltv/. On Windows,
+it might be necessary to set HOME to a path without spaces in it.
+
+=head1 CREDITS
+
+Grabber written by Dig Lam, dig -dot- lam -at- gmail -dot- com
+This documentation copied from tv_grab_uk by Ed Avis,
+ed -at- membled -dot- com.
+
+=head1 BUGS
+
+None known.
+
+=cut
+
