xmltv/grab/uk_guardian tv_grab_uk_guardian, 1.7, 1.8 CHANGELOG, 1.6, NONE DISCLAIMER, 1.1, NONE INSTALL, 1.1, NONE TODO, 1.1, NONE

Update of /cvsroot/xmltv/xmltv/grab/uk_guardian
In directory sfp-cvs-1.v30.ch3.sourceforge.com:/tmp/cvs-serv23256

Modified Files:
	tv_grab_uk_guardian 
Removed Files:
	CHANGELOG DISCLAIMER INSTALL TODO 
Log Message:
remove non-standard files

Index: tv_grab_uk_guardian
===================================================================
RCS file: /cvsroot/xmltv/xmltv/grab/uk_guardian/tv_grab_uk_guardian,v
retrieving revision 1.7
retrieving revision 1.8
diff -C2 -d -r1.7 -r1.8
*** tv_grab_uk_guardian	9 Jan 2014 08:16:01 -0000	1.7
--- tv_grab_uk_guardian	20 Jan 2014 14:17:47 -0000	1.8
***************
*** 5,8 ****
--- 5,10 ----
  # This code is distributed under the GNU General Public License v2 (GPLv2) .
  #
+ #   For extended help information run
+ #         tv_grab_uk_guardian  --info
  # 
  
***************
*** 71,76 ****
  #print Dumper($conf); exit;
  
! # options.pm hi-jacks the --help arg and creates its own POD synopsis!  This means we can't tell people about our added
! #  parameters.  I would posit that's a bug.  Let's allow '--info' to replace it.
  if ($opt->{'info'}) {
  	use Pod::Usage;
--- 73,77 ----
  #print Dumper($conf); exit;
  
! # options.pm hi-jacks the --help arg and creates its own POD synopsis.  We'll use --info instead.
  if ($opt->{'info'}) {
  	use Pod::Usage;
***************
*** 634,662 ****
  tv_grab_uk_guardian - Grab TV listings for UK from The Guardian website.
  
- =head1 SYNOPSIS
- 
- tv_grab_uk_guardian --help
- 
- tv_grab_uk_guardian --info
-   
- tv_grab_uk_guardian --version
- 
- tv_grab_uk_guardian --capabilities
- 
- tv_grab_uk_guardian --description
- 
- tv_grab_uk_guardian [--config-file FILE]
-            [--days N] [--offset N]
-            [--output FILE] [--quiet] [--debug]
- 
- tv_grab_uk_guardian --configure [--config-file FILE]
- 
- tv_grab_uk_guardian --configure-api [--stage NAME]
-            [--config-file FILE]
-            [--output FILE]
- 
- tv_grab_uk_guardian --list-channels [--config-file FILE]
-            [--output FILE] [--quiet] [--debug]
- 
  =head1 DESCRIPTION
  
--- 635,638 ----
***************
*** 672,705 ****
  =head1 OPTIONS
  
! B<--configure> Prompt for which channels to download and write the
! configuration file.
! 
! B<--config-file FILE> Set the name of the configuration file, the
! default is B<~/.xmltv/tv_grab_uk_guardian.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 rather than all available days.
  
! B<--offset N> Start grabbing at today + N days.  N may be negative.
  
! B<--quiet> Suppress the progress-bar normally shown on standard error.
  
! B<--debug> Provide more information on progress to stderr to help in
! debugging.
  
! B<--list-channels> Write output giving <channel> elements for every
! channel available (ignoring the config file), but no programmes.
  
! 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<--help> Print a help message and exit.
  
! B<--info> Print this help page and exit.
  
  =head1 ERROR HANDLING
--- 648,671 ----
  =head1 OPTIONS
  
! Please see tv_grab_uk_guardian  --help
  
! =head1 INSTALLATION
  
! The file F<tv_grab_uk_guardian.map.conf> has two purposes.  Firstly you can map the channel ids used by the site into something more meaningful to your PVR. E.g.
  
!       map==bbc-1-south==BBC 1	
  
! will change "bbc-1-south" to "BBC 1" in the output XML.
  
! Note: the lines are of the form "map=={channel id}=={my name}".
  
! The second purpose is to likewise translate genre names.  So if your PVR doesn"t have a category for "Science Fiction" but uses "Sci-fi" instead, then you can specify
  
!       cat==Science Fiction==Sci-fi
  
! and the output XML will have "Sci-fi".
  
  
! IMPORTANT: the downloaded "tv_grab_uk_guardian.map.conf" contains example lines to illustrate the format - you should edit this file to suit your own purposes!
  
  =head1 ERROR HANDLING
***************
*** 720,723 ****
--- 686,712 ----
  For information on supported channels, see http://tvlistings.guardian.co.uk/text-only/all-channels/
  
+ =head1 XMLTV VALIDATION
+ 
+ B<tv_validate_grabber> may report an error similar to:
+ 
+       "Line 5 Invalid channel-id BBC 1"
+ 	
+ This is a because ValidateFile.pm insists the channel-id adheres to RFC2838 despite the xmltv.dtd only saying "preferably" not "SHOULD".  
+ (Having channel ids of the form "bbc1.bbc.co.uk" will be rejected by many PVRs since they require the data to match their own list.)
+ 
+ It may also report:
+ 
+       "tv_sort failed on the concatenated data. Probably due to overlapping data between days."
+ 	
+ Both these errors can be ignored.
+ 
+ =head1 DISCLAIMER
+ 
+ The Guardian website"s license for these data does not allow non-personal use.
+ 
+ Certainly any commercial use of listings data obtained by using this grabber will breach copyright law, but if you are just using the data for your own personal use then you are probably fine.
+ 
+ By using this grabber you aver you are using the listings data for your own personal use only and you absolve the author(s) from any liability under copyright law or otherwise.
+ 
  =head1 AUTHOR
  

--- CHANGELOG DELETED ---

--- TODO DELETED ---

--- INSTALL DELETED ---

--- DISCLAIMER DELETED ---


------------------------------------------------------------------------------
CenturyLink Cloud: The Leader in Enterprise Cloud Services.
Learn Why More Businesses Are Choosing CenturyLink Cloud For
Critical Workloads, Development Environments & Everything In Between.
Get a Quote or Start a Free Trial Today. 
http://pubads.g.doubleclick.net/gampad/clk?id=119420431&iu=/4140/ostg.clktrk