Changes between Version 73 and Version 74 of FAQ

Timestamp:

Sep 30, 2013, 6:44:07 PM (10 years ago)

Author:

Max

Comment:

--

FAQ

@@ -22 +22 @@
 The [wiki:shepherd_logic] wiki page contains a more complete technical description of the various stages of Shepherd and how it works.
 
+By default, Shepherd prints the EPG to STDOUT and to the file ''~/.shepherd/output.xmltv''.
 
 === How can I get help or ask a few questions? ===
@@ -79 +80 @@
 === Is there a log file somewhere? ===
 Yes, in the ''log/'' subdirectory of your Shepherd installation (usually ''~/.shepherd/log/'').
-
-
-=== What is autorefresh? ===
-When it's been more than 4 hours but less than 22 hours since the last run, Shepherd will switch into autorefresh mode, gathering data for the current day only. It will output the result via STDOUT, as usual, and create the file ~/.shepherd/refresh.xmltv. This allows Shepherd to catch last-minute schedule changes. It tends to complete very quickly (for Shepherd), since even the slower grabbers are usually able to quickly verify if there have been any time or title changes since they last ran.
-
-If you don't wish Shepherd to enter autorefresh mode, send the --noautorefresh option.
-
-Shepherd will '''not''' enter autorefresh mode if you specify a number of --days, since this would require overriding your preference. But if you are happy for Shepherd to override it during autorefreshes only, send --allowautorefresh.
-
-Autorefresh does not touch the default output.xmltv file, so functions such as '''--refill-mythtv''' will use your last full successful run, not any subsequent autorefresh. You may wish to override this if you want to be able to rely on output.xmltv always containing the latest data, regardless of whether it's a single day's data or a week's. If so, use '''--output'''. For example, to always output into output.xmltv, even autorefreshes:
-{{{
-tv_grab_au --output ~/.shepherd/output.xmltv
-}}}
-In that case, you would probably want to set it as a default option, i.e.:
-{{{
-tv_grab_au --component-set shepherd:output=output.xmltv
-}}}
-Or to refill MythTV will the latest autorefresh data, rather than the latest full run:
-{{{
-tv_grab_au --refill-mythtv --output ~/.shepherd/refresh.xmltv
-}}}
 
 
@@ -272 +252 @@
 {{{
 tv_grab_au --grabwith oztivo,sbsnews_website
+}}}
+
+
+=== What is autorefresh? ===
+When it's been more than 4 hours but less than 22 hours since the last run, Shepherd will switch into autorefresh mode, gathering data for the current day only. It will output the result via STDOUT, as usual, and create the file ~/.shepherd/refresh.xmltv. This allows Shepherd to catch last-minute schedule changes. It tends to complete very quickly (for Shepherd), since even the slower grabbers are usually able to quickly verify if there have been any time or title changes since they last ran.
+
+If you don't wish Shepherd to enter autorefresh mode, send the --noautorefresh option.
+
+Shepherd will '''not''' enter autorefresh mode if you specify a number of --days, since this would require overriding your preference. But if you are happy for Shepherd to override it during autorefreshes only, send --allowautorefresh.
+
+Autorefresh does not touch the default output.xmltv file, so functions such as '''--refill-mythtv''' will use your last full successful run, not any subsequent autorefresh. You may wish to override this if you want to be able to rely on output.xmltv always containing the latest data, regardless of whether it's a single day's data or a week's. If so, use '''--output'''. For example, to always output into output.xmltv, even autorefreshes:
+{{{
+tv_grab_au --output ~/.shepherd/output.xmltv
+}}}
+In that case, you would probably want to set it as a default option, i.e.:
+{{{
+tv_grab_au --component-set shepherd:output=output.xmltv
+}}}
+Or to refill MythTV will the latest autorefresh data, rather than the latest full run:
+{{{
+tv_grab_au --refill-mythtv --output ~/.shepherd/refresh.xmltv
 }}}