From kde-commits  Sun Sep 03 16:29:11 2006
From: Koos Vriezen <koos.vriezen () xs4all ! nl>
Date: Sun, 03 Sep 2006 16:29:11 +0000
To: kde-commits
Subject: extragear/multimedia/doc/kmplayer
Message-Id: <1157300951.221201.15094.nullmailer () svn ! kde ! org>
X-MARC-Message: https://marc.info/?l=kde-commits&m=115730101705068

SVN commit 580477 by vriezen:

Ah yes, the idea for adding playlist view section was to document the
mplayeropts setting


 M  +44 -3     index.docbook  


--- trunk/extragear/multimedia/doc/kmplayer/index.docbook #580476:580477
@@ -126,9 +126,43 @@
 on an item, its group and all its child groups will be copied to the current
 category and playings starts at the clicked item position.
 </para>
+<section>
+<title>Storage format</title>
+<para>
+The data is stored in
+<filename>~/.kde/share/apps/kmplayer/playlist.xml</filename>, and its format
+is like this example. See <link linkend="XML-editing">here</link> for 
+manipulating this data directly.
+<programlisting>
+&lt;playlist&gt;
+    &lt;group title="feeds"&gt;
+        &lt;item url="http://www.lugradio.org/episodes.rss"/&gt;
+        &lt;item url="http://science.nasa.gov/podcast.xml"/&gt;
+        &lt;item url="http://www.theworld.org/rss/tech.xml"/&gt;
+    &lt;/group&gt;
+    &lt;group title="iradio"&gt;
+        &lt;group title="sunny"&gt;
+            &lt;item mplayeropts="-cache 256" url="http://www.swissgroove.ch/listen.m3u"/&gt;
+            &lt;item url="http://www.boombasticradio.com/shoutcast/64.pls"/&gt;
+        &lt;/group&gt;
+        &lt;group title="rainy"&gt;
+            &lt;item url="http://www.radioparadise.com/musiclinks/rp_64.m3u"/&gt;
+            &lt;item url="http://www.woxy.com/stream/wma64.asx"/&gt;
+            &lt;item url="http://radionigel.com/winmedia.asx"/&gt;
+            &lt;item url="rtsp://livestreams.omroep.nl/live/vpro/vpro3voor12radioalt.rm"/&gt;
+        &lt;/group&gt;
+    &lt;/group&gt;
+&lt;/playlist&gt;
+</programlisting>
+Also note that for <application>MPlayer</application> custom options can be
+set using the <computeroutput>mplayeropts</computeroutput> argument. &kmplayer;
+searches for this option upwards in the tree, so you can set it for a whole
+group and override it for a child group or item.
+</para>
 </section>
 </section>
-<section>
+</section>
+<section id="XML-editing">
 <title>Direct XML editing</title>
 <para>
 The current, <guilabel>Television</guilabel> and
@@ -148,6 +182,10 @@
     All changes are lost when leaving edit mode without syncing with playlist.
 </para></caution>
 </para>
+<para>
+Because of the lazyness of &kmplayer;'s author(s), some features can only be
+enabled by editing the XML.
+</para>
 </section>
 </chapter>
 <chapter id="settings">
@@ -258,8 +296,11 @@
         &kmplayer; can play from TV cards using <application>MPlayer</application> or <acronym>XVideo</acronym> (using <application>kxvplayer</application>). Before you can watch TV, you have to configure which device to use and the TV channels. You can use the scanner from the configure dialog for this or edit the config file manually.
 </para>
 <para>
-    The config file for TV settings is a <acronym>XML</acronym> file, located <filename>~/.kde/share/apps/kmplayer/tv.xml</filename>. The <acronym>XML</acronym> format is like this example:
-    <programlisting>
+The config file for TV settings is a <acronym>XML</acronym> file, located
+<filename>~/.kde/share/apps/kmplayer/tv.xml</filename>. See
+<link linkend="XML-editing">here</link> for manipulating this data directly.
+The <acronym>XML</acronym> format is like this example:
+<programlisting>
 &lt;tvdevices&gt;
     &lt;device path="/dev/video0" width="320" height="240" name="BT878 video (Hauppauge (bt878))" audio=""
               minwidth="48" minheight="32" maxwidth="924" maxheight="576" playback="0" xvport="240"&gt;