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

--- a/grab/dk_dr/tv_grab_dk_dr
+++ b/grab/dk_dr/tv_grab_dk_dr
@@ -30,7 +30,7 @@
 #   Per Baekgaard <baekgaard@b4net.dk> 2009-08-13 20:39 CEST
 #      - Minor changes supporting the released version on dr.dk
 #
-#   Morten Grouleff (morten@grouleff.com) 
+#   Morten Grouleff (morten@grouleff.com)
 #      - Rewritten to use the new JSON api instead of screenscraping from the html.
 #

@@ -544,3 +544,71 @@ for (my $c=0; $c<$opt->{'days'}; $c++) {
     }
 }
 $writer->end();
+
+=pod
+
+=head1 NAME
+
+tv_grab_dk_dr - Grab TV listings for Denmark.
+
+=head1 SYNOPSIS
+
+tv_grab_dk_dr --help
+
+tv_grab_dk_dr --configure [--config-file FILE] [--gui OPTION]
+
+tv_grab_dk_dr [--config-file FILE] [--output FILE] [--days N]
+[--offset N] [--quiet]
+
+tv_grab_dk_dr --capabilities
+
+tv_grab_dk_dr --version
+
+=head1 DESCRIPTION
+
+Output TV listings for several channels available in Denmark.  The
+data comes from dr.dk. The grabber now uses a JSON API to retrieve data
+and no longer relies on parsing HTML.
+
+First run B<tv_grab_dk_dr --configure> to choose, which channels you want
+to download. Then running B<tv_grab_dk_dr> with no arguments will output
+listings in XML format to standard output.
+
+B<--configure> Prompt for which channels, and write the configuration file.
+
+B<--config-file FILE> Set the name of the configuration file, the
+default is B<~/.xmltv/tv_grab_dk_dr.conf>.  This is the file written by
+B<--configure> and read when grabbing.
+
+B<--gui OPTION> Use this option to enable a graphical interface to be used.
+OPTION may be 'Tk', or left blank for the best available choice.
+Additional allowed values of OPTION are 'Term' for normal terminal output
+(default) and 'TermNoProgressBar' to disable the use of Term::ProgressBar.
+
+B<--output FILE> Write to FILE rather than standard output.
+
+B<--days N> Grab N days.  The default is one week.
+
+B<--offset N> Start N days in the future.  The default is to start
+from today.
+
+B<--quiet> Suppress the progress messages normally written to standard
+error.
+
+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.
+
+=head1 SEE ALSO
+
+L<xmltv(5)>.
+
+=head1 AUTHOR
+
+This version of tv_grab_dk_dr was written by Morten Grouleff <morten at grouleff dot com>
+
+=cut
+
