Releasing 0.16.0

[mpd-sima.git] / data / man / mpd_sima.cfg.5.xml

diff --git a/data/man/mpd_sima.cfg.5.xml b/data/man/mpd_sima.cfg.5.xml
index 8ff9db0312e88f00c1a559bfede3aceaac08d719..149087f8a2a36243215ba6e2903e0b887d578afb 100644 (file)
--- a/data/man/mpd_sima.cfg.5.xml
+++ b/data/man/mpd_sima.cfg.5.xml
@@ -293,6 +293,12 @@ man(1), man(7), http://www.tldp.org/HOWTO/Man-Page/
                 <varlistentry> <!-- random -->
                     <term><option>[random]</option></term>
                 </varlistentry>
+                <varlistentry> <!-- random.track_to_add -->
+                    <term><option>track_to_add=</option><replaceable>1</replaceable></term>
+                    <listitem>
+                        <para>How many track(s) to add.</para>
+                    </listitem>
+                </varlistentry>
                 <varlistentry> <!-- random.flavour -->
                     <term><option>flavour=</option><replaceable>sensible</replaceable></term>
                     <listitem>
@@ -471,54 +477,59 @@ man(1), man(7), http://www.tldp.org/HOWTO/Man-Page/
                         </para>
                     </listitem>
                 </varlistentry>
+                <varlistentry> <!-- tags.track_to_add -->
+                    <term><option>track_to_add=</option><replaceable>1</replaceable></term>
+                    <listitem>
+                        <para>How many track(s) to add.</para>
+                    </listitem>
+                </varlistentry>
         </refsect2>
     </refsect1>
     <refsect1 id="queue_mode">
         <title>QUEUE MODES</title>
-        <para>&dhpackage; offers different queue modes with lastfm plugin. All of them pick up
-            tracks from artists similar to the last track in the queue.</para>
+        <para>Different queue modes are available with some plugins (check for
+        <option>queue_mode</option> presence in plugin config).
+        </para>
         <para>&dhpackage; tries preferably to chose among unplayed artists or
-            at least not recently played artist. Concerning track and album
-            queue modes titles are chosen purely at random among unplayed
-            tracks.</para>
+        at least not recently played artist.</para>
         <variablelist>
-            <varlistentry>
-                <term><option>track</option></term>
-                <listitem>
-                    <para>Queue a similar track chosen at random from a similar artist.</para>
-                </listitem>
-            </varlistentry>
-            <varlistentry>
-                <term><option>top</option></term>
-                <listitem>
-                    <para>Queue a track from a similar artist, chosen among
-                        "top tracks" according to last.fm data mining.</para>
-                </listitem>
-            </varlistentry>
-            <varlistentry>
-                <term><option>album</option></term>
-                <listitem>
-                    <para>Queue a whole album chosen at random from a similar artist.</para>
-                    <para><emphasis>Nota Bene:</emphasis><sbr /> Due to the
-                        track point of view of database build upon tracks tags
-                        an album lookup for a specific artist will return
-                        albums as soon as this artist appears in a single track
-                        of the album.<sbr />
-                        For instance looking for album from "The Velvet
-                        Underground" will fetch "Last Days" and "Juno" OSTs
-                        because the band appears on the soundtrack of these two
-                        movies.<sbr />
-                        A solution is for you to set AlbumArtists tag to
-                        something different than the actual artist of the
-                        track. For compilations, OSTs etc. a strong convention
-                        is to use "Various Artists" for this tag.</para>
-                    <para>&dhpackage; is currently looking for AlbumArtists tags
-                        and avoid album where this tag is set with "Various
-                        Artists". If a single track within an album is found
-                        with AlbumArtists:"Various Artists" the complete album
-                        is skipped and won't be queued.</para>
-                </listitem>
-            </varlistentry>
+          <varlistentry>
+            <term><option>track</option></term>
+            <listitem>
+              <para>Queue a similar track chosen at random from a similar artist.</para>
+            </listitem>
+          </varlistentry>
+          <varlistentry>
+            <term><option>top</option></term>
+            <listitem>
+              <para>Queue a track from a similar artist, chosen among
+                "top tracks" according to last.fm data mining.</para>
+            </listitem>
+          </varlistentry>
+          <varlistentry>
+            <term><option>album</option></term>
+            <listitem>
+              <para>Queue a whole album chosen at random from a similar artist.</para>
+              <para><emphasis>Nota Bene:</emphasis><sbr /> Due to the
+                track point of view of database build upon tracks tags
+                an album lookup for a specific artist will return
+                albums as soon as this artist appears in a single track
+                of the album.<sbr />
+                For instance looking for album from "The Velvet
+                Underground" will fetch "Last Days" and "Juno" OSTs
+                because the band appears on the soundtrack of these two
+                movies.<sbr />
+                A solution is for you to set AlbumArtists tag to
+                something different than the actual artist of the
+                track. For compilations, OSTs etc. a strong convention
+                is to use "Various Artists" for this tag.</para>
+              <para>&dhpackage; is currently looking for AlbumArtists tags
+                and avoid album where this tag is set with "Various
+                Artists". If a single track within an album is found
+                with AlbumArtists:"Various Artists" the complete album
+                is skipped and won't be queued.</para>
+            </listitem>
+          </varlistentry>
         </variablelist>
     </refsect1>
   <xi:include href="files.xml" />