[kmplayer/0.11] doc: Ah yes, the idea for adding playlist view section was to document the

[Koos Vriezen]

Git commit 53b15b2126d7c32054510bc6b925650ede7bcec3 by Koos Vriezen.
Committed on 03/09/2006 at 16:29.
Pushed by ltoscano into branch '0.11'.

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

svn path=/trunk/extragear/multimedia/doc/kmplayer/; revision=580477

M  +44   -3    doc/index.docbook

https://commits.kde.org/kmplayer/53b15b2126d7c32054510bc6b925650ede7bcec3

diff --git a/doc/index.docbook b/doc/index.docbook
index 3876649..ca937a0 100644
--- a/doc/index.docbook
+++ b/doc/index.docbook
@@ -126,9 +126,43 @@ Of course you can add groups to groups to get a deeper hierarchy. When clicked
 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>
+<playlist>
+    <group title="feeds">
+        <item url="http://www.lugradio.org/episodes.rss"/>
+        <item url="http://science.nasa.gov/podcast.xml"/>
+        <item url="http://www.theworld.org/rss/tech.xml"/>
+    </group>
+    <group title="iradio">
+        <group title="sunny">
+            <item mplayeropts="-cache 256" url="http://www.swissgroove.ch/listen.m3u"/>
+            <item url="http://www.boombasticradio.com/shoutcast/64.pls"/>
+        </group>
+        <group title="rainy">
+            <item url="http://www.radioparadise.com/musiclinks/rp_64.m3u"/>
+            <item url="http://www.woxy.com/stream/wma64.asx"/>
+            <item url="http://radionigel.com/winmedia.asx"/>
+            <item url="rtsp://livestreams.omroep.nl/live/vpro/vpro3voor12radioalt.rm"/>
+        </group>
+    </group>
+</playlist>
+</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 @@ After you have edited some <acronym>XML</acronym>, click on the
     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 @@ Basically the same way as trouble shooting
         &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>
 <tvdevices>
     <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">