]> git.ipfire.org Git - thirdparty/tvheadend.git/commitdiff
mdhelp: add debugging, timeshift, status_subscription help docs mdhelp: update/add...
authorMark Clarkstone <hello@markclarkstone.co.uk>
Wed, 11 May 2016 08:06:15 +0000 (09:06 +0100)
committerJaroslav Kysela <perex@perex.cz>
Wed, 11 May 2016 19:09:23 +0000 (21:09 +0200)
14 files changed:
docs/class/debugging.md [new file with mode: 0644]
docs/class/timeshift.md [new file with mode: 0644]
docs/markdown/epg.md
docs/markdown/status_subscriptions.md
src/timeshift.c
src/tvhlog.c
src/webui/static/img/doc/configchannellist.png
src/webui/static/img/doc/debuggingtab.png [new file with mode: 0644]
src/webui/static/img/doc/epg.png
src/webui/static/img/doc/epg2.png
src/webui/static/img/doc/epg3.png
src/webui/static/img/doc/statussubscriptions.png [new file with mode: 0644]
src/webui/static/img/doc/timeshifttab.png [new file with mode: 0644]
src/webui/static/img/overall_screenshot.png

diff --git a/docs/class/debugging.md b/docs/class/debugging.md
new file mode 100644 (file)
index 0000000..b1739fd
--- /dev/null
@@ -0,0 +1,82 @@
+This tab is used to configure various debugging options in tvheadend.
+
+!['Debugging tab'](static/img/doc/debuggingtab.png)
+
+Changes to any of these settings must be confirmed by pressing the 
+*[Apply configuration]* button before taking effect.
+
+Note that settings are not saved to a storage. Any change is available 
+only while Tvheadend is running, and will be lost on a restart. 
+To change the default behaviour permanently, use command line options 
+such as `-l,` `–debug`, `–trace`.
+
+Depending on your distribution, the default command-line configuration 
+is usually stored in the `/etc/sysconfig` tree or an init script. 
+You may also be able to change `/etc/default/tvheadend` to add additional 
+command-line parameters.
+
+---
+
+###Menu Bar/Buttons
+
+The following functions are available:
+
+Button     | Function
+-----------|---------
+**Apply configuration (run-time only)**   | Apply the entered debugging settings.
+<tvh_include>inc/common_button_table_end</tvh_include>
+
+---
+
+###Subsystems
+
+The following options can be passed to tvheadend to provide detailed debugging 
+information while the application is running.
+
+```
+all
+access
+bouquet
+capmt
+cwc
+descrambler
+diseqc
+dvbcam
+dvr
+eit
+en50221
+epg
+epggrab
+fastscan
+fsmonitor
+gtimer
+htsp
+httpc
+idnode
+linuxdvb
+main
+mkv
+mpegts
+opentv
+parser
+pass
+psi
+satip
+satips
+scanfile
+sdt
+service
+service_mapper
+settings
+subscription
+tcp
+thread
+time
+timeshift
+transcode
+tsfile
+tvhdhomerun
+upnp
+```
+
+---
diff --git a/docs/class/timeshift.md b/docs/class/timeshift.md
new file mode 100644 (file)
index 0000000..be933d4
--- /dev/null
@@ -0,0 +1,17 @@
+This tab is used to configure timeshift properties.
+
+!['Timeshift Tab'](static/img/doc/timeshifttab.png)
+
+---
+
+###Menu Bar/Buttons
+
+The following functions are available:
+
+Button     | Function
+-----------|---------
+**Save**   | Save the current configuration.
+**Undo**   | Revert the changes made since last save.
+<tvh_include>inc/common_button_table_end</tvh_include>
+
+---
index 832efb733200f4fb1a44f7976ce815d99d28befb..1822b7d054caa67877e6160be60995b8a172650a 100644 (file)
@@ -158,13 +158,13 @@ feature.
 If you schedule any kind of recording from this point, you can choose a
 specific DVR profile that will apply to the recording or autorec rule.
 This will normally show as *(default)*, but you can define different
-profiles in the **Configuration -\> Recording -\> Digital Video
-Recorder Profiles** tab. This allows you to set, for example, more post-
+profiles in the **Configuration -\> Recording -\> [Digital Video
+Recorder Profiles](class/dvrconfig)** tab. This allows you to set, for example, more post-
 broadcast padding for a channel that always runs late, or perhaps define
 a different post-processing command to strip adverts out on a commercial
 channel.
 
-You will also see *[Search IMDB]* and *[TheTVDB] buttons to look for the program by name
+You will also see *[Search IMDB]* and *[TheTVDB]* buttons to look for the program by name
 on imdb.com/thetvdb.com, and a *[Play program]* button to watch a program that’s already
 in progress. This second button downloads a playlist file (XSPF or M3U
 depending on your startup options); if your system is configured for it,
@@ -184,14 +184,10 @@ Should you wish to record all events matching a specific query (to
 record your favourite show every week, for example) you can press the
 *[Create AutoRec]* button in the top toolbar.
 
-A popup with details about the to-be-created autorecording rule needs to
-be confirmed before the rule takes effect.
-
-![Autorec Dialogue Box](static/img/doc/autorecpopup.png)
-
-You can change or delete the autorec rules in the **Digital Video
-Recorder** tab. Use that editor if you temporarily want to disable an
-autorecording or make adjustments to the channel, tag, or similar.
+You can change or delete the autorec rules in 
+the **[Autorec](class/dvrautorec)** tab. Use that editor if you 
+temporarily want to disable an autorecording or make adjustments to the 
+channel, tag, or similar.
 
 ---
 
index c9bbb128bf567f205e9364372cb4349f95152e4d..a8d65e75c0ceca8d6b5d6050ef033bf9f6e9313c 100644 (file)
@@ -8,7 +8,7 @@ This is a read-only tab; nothing is configurable.
 
 ---
 
-####Menu Bar/Buttons
+###Menu Bar/Buttons
 
 The following functions are available:
 
@@ -22,14 +22,48 @@ Button     | Function
 
 The main grid items have the following functions:
 
-**Item**
-: Description
+**ID**
+: Subscription ID.
 
-**Item**
-: Description
+**Hostname**
+: Hostname/IP address using the subscription.
 
-**Item**
-: Description
+**Username**
+: Username using the subscription - a blank cell indicates the 
+subscriber didn't supply a username.
 
-**Item**
-: Description
+**Title**
+: Title of the application using the subscription - you will sometimes 
+see "epggrab" here, this is an internal subscription used by tvheadend 
+to grab EPG data.
+
+**Channel**
+: The name of the [channel](class/channel) the subscription is using - 
+if the subscription is streaming a service/mux this cell will be blank.
+
+**Profile**
+: The name of the [profile](class/profile) the subscription is using.
+
+**Start**
+: The date (and time) the subscription was started.
+
+**State**
+: The status of the subscription
+
+State         | Description
+--------------|-------------
+Running       | The subscription is active - the stream is being sent.
+Idle          | The subscription is idling, waiting for the subscriber.
+Testing       | Tvheadend is testing the requested stream to see if it's available - if a subscription stays in this state too long it may indicate a signal issue.
+
+**Descramble**
+: The CAID used to descramble the stream.
+
+**Errors**
+: Number of errors occurred sending the stream.
+
+**Input**
+: The input data rate in kb/s.
+
+**Output**
+: The output data rate in kb/s.
index 0bf2b8e6004e56abcf184462eeef8cc5c66c458f..f5ece1f8f444436709c701ce2169dec025146d1d 100644 (file)
@@ -166,10 +166,13 @@ timeshift_conf_class_ram_size_set ( void *o, const void *v )
   return 0;
 }
 
+CLASS_DOC(timeshift)
+
 const idclass_t timeshift_conf_class = {
   .ic_snode      = &timeshift_conf.idnode,
   .ic_class      = "timeshift",
   .ic_caption    = N_("Timeshift"),
+  .ic_doc        = tvh_doc_timeshift_class,
   .ic_event      = "timeshift",
   .ic_perm_def   = ACCESS_ADMIN,
   .ic_changed    = timeshift_conf_class_changed,
index 1ce85011f519c8d74232ba219ed5c60bf2e40512..466f7696f2ac4773979d0af7fb862dc821cd1741 100644 (file)
@@ -610,10 +610,13 @@ idnode_t tvhlog_conf = {
   .in_class      = &tvhlog_conf_class
 };
 
+CLASS_DOC(debugging)
+
 const idclass_t tvhlog_conf_class = {
   .ic_snode      = &tvhlog_conf,
   .ic_class      = "tvhlog_conf",
   .ic_caption    = N_("Debugging"),
+  .ic_doc        = tvh_doc_debugging_class,
   .ic_event      = "tvhlog_conf",
   .ic_perm_def   = ACCESS_ADMIN,
   .ic_groups     = (const property_group_t[]) {
index 4409f3cf6e027c5867d5495ffd06a1a42811ae82..8acd771c2a58e66006e94926faa56f170f210fee 100644 (file)
Binary files a/src/webui/static/img/doc/configchannellist.png and b/src/webui/static/img/doc/configchannellist.png differ
diff --git a/src/webui/static/img/doc/debuggingtab.png b/src/webui/static/img/doc/debuggingtab.png
new file mode 100644 (file)
index 0000000..c77094a
Binary files /dev/null and b/src/webui/static/img/doc/debuggingtab.png differ
index dda1af9e2e640a09e88a3d70321b87a15add8ff0..abbb8b599b85af4416c1f80f363eaf9a493c1558 100644 (file)
Binary files a/src/webui/static/img/doc/epg.png and b/src/webui/static/img/doc/epg.png differ
index 3ea05bee1734c8210cb859677489bc28646ce346..7c4094179a20c2db5d4953a32ce14b64c9f580f6 100644 (file)
Binary files a/src/webui/static/img/doc/epg2.png and b/src/webui/static/img/doc/epg2.png differ
index 78d334213ea068991e9ca7642d7a241a003ca951..835c1b35d4c5c23d6a5eb875d5b450cf02c9f9c7 100644 (file)
Binary files a/src/webui/static/img/doc/epg3.png and b/src/webui/static/img/doc/epg3.png differ
diff --git a/src/webui/static/img/doc/statussubscriptions.png b/src/webui/static/img/doc/statussubscriptions.png
new file mode 100644 (file)
index 0000000..2a007a4
Binary files /dev/null and b/src/webui/static/img/doc/statussubscriptions.png differ
diff --git a/src/webui/static/img/doc/timeshifttab.png b/src/webui/static/img/doc/timeshifttab.png
new file mode 100644 (file)
index 0000000..4932c3a
Binary files /dev/null and b/src/webui/static/img/doc/timeshifttab.png differ
index dbe9cf9352f718422adf08dee2c3fd6a9a45cf7b..ffcd5cbff6f10acb8002398817cde3ee65fd842e 100644 (file)
Binary files a/src/webui/static/img/overall_screenshot.png and b/src/webui/static/img/overall_screenshot.png differ