Make a description of ${cpu} variable not so confusing.
[monky] / doc / variables.xml
index dfc294b..8b2dc7f 100644 (file)
        <para></para></listitem>
 </varlistentry>
 
+<varlistentry>  
+        <term>          
+                <command><option>bmpx_artist</option></command>
+        </term>
+        <listitem>
+                Artist in current BMPx track
+        <para></para></listitem>
+</varlistentry>
+
+<varlistentry>  
+        <term>
+                <command><option>bmpx_album</option></command>
+        </term>         
+        <listitem>
+                Album in current BMPx track
+       <para></para></listitem>
+</varlistentry>
+
+<varlistentry>
+        <term>
+               <command><option>bmpx_title</option></command>
+       </term>
+       <listitem>
+               Title of the current BMPx track
+       <para></para></listitem>
+</varlistentry>
+
+<varlistentry>
+       <term>
+               <command><option>bmpx_track</option></command>
+       </term>
+       <listitem>
+               Track number of the current BMPx track
+       <para></para></listitem>
+</varlistentry>
+
+<varlistentry>
+       <term>
+               <command><option>bmpx_bitrate</option></command>
+       </term>
+       <listitem>
+               Bitrate of the current BMPx track
+       <para></para></listitem>
+</varlistentry>
+
+<varlistentry>
+       <term>
+               <command><option>bmpx_uri</option></command>
+       </term>
+       <listitem>
+               URI of the current BMPx track
+       <para></para></listitem>
+</varlistentry>
+
 <varlistentry>
        <term>
                <command><option>buffers</option></command>
                <option>(cpuN)</option>
        </term>
        <listitem>
-               CPU usage in percents.  For SMP machines, the CPU number can be provided as an argument.  cpu0 is the total usage, and >=cpu1 are individual CPUs.  See $cpu for more info on SMP.
+               CPU usage in percents.  For SMP machines, the CPU number can be provided as an argument.  ${cpu 0} is the total usage, and ${cpu X} (X >= 1) are individual CPUs. 
        <para></para></listitem>
 </varlistentry>
 
                <option>(cpu number) (height),(width)</option>
        </term>
        <listitem>
-               Bar that shows CPU usage, height is bar's height in pixels
+               Bar that shows CPU usage, height is bar's height in pixels.  See $cpu for more info on SMP.
        <para></para></listitem>
 </varlistentry>
 
 <varlistentry>
        <term>
                <command><option>font</option></command>
-       <option>font</option>
+       <option>(font)</option>
        </term>
        <listitem>
-               Specify a different font. Only applies to one line.
+               Specify a different font. This new font will apply to the current line and everything following.  You can use a $font with no arguments to change back to the default font (much like with $color)
        <para></para></listitem>
 </varlistentry>
 
+<varlistentry>
+       <term>
+               <command><option>freq</option></command>
+               <option>(n)</option>
+       </term>
+       <listitem>
+               Returns CPU #n's frequency in MHz. CPUs are
+               counted from 1. If omitted, the parameter
+               defaults to 1.
+               <para></para></listitem>
+</varlistentry>
+<varlistentry>
+       <term>
+               <command><option>freq_g</option></command>
+               <option>(n)</option>
+       </term>
+       <listitem>
+               Returns CPU #n's frequency in GHz. CPUs are
+               counted from 1. If omitted, the parameter
+               defaults to 1.
+               <para></para></listitem>
+</varlistentry>
        
-       <varlistentry>
-               <term>
-                       <command><option>freq</option></command>
-               </term>
-               <listitem>
-                       Returns CPU frequency in MHz
-                       <para></para></listitem>
-       </varlistentry>
-       <varlistentry>
-               <term>
-                       <command><option>freq_g</option></command>
-               </term>
-               <listitem>
-                       Returns CPU frequency in GHz
-                       <para></para></listitem>
-       </varlistentry>
-       
-       <varlistentry>
-               <term>
-                       <command><option>freq_dyn</option></command>
-               </term>
-               <listitem>
+<varlistentry>
+       <term>
+               <command><option>freq_dyn</option></command>
+       </term>
+       <listitem>
                        Returns CPU frequency in MHz, but is calculated by counting to clock cycles to complete an instruction.  Only available for x86/amd64.
                        <para></para></listitem>
-       </varlistentry>
-       <varlistentry>
-               <term>
-                       <command><option>freq_dyn_g</option></command>
-               </term>
-               <listitem>
-                       Returns CPU frequency in GHz, but is calculated by counting to clock cycles to complete an instruction.  Only available for x86/amd64.
-                       <para></para></listitem>
-       </varlistentry>
+</varlistentry>
+
+<varlistentry>
+       <term>
+               <command><option>freq_dyn_g</option></command>
+       </term>
+       <listitem>
+               Returns CPU frequency in GHz, but is calculated by counting to clock cycles to complete an instruction.  Only available for x86/amd64.
+       <para></para></listitem>
+</varlistentry>
        
-       <varlistentry>
+<varlistentry>
        <term>
                <command><option>fs_bar</option></command>
        <option>(height),(width) fs</option>
 
 <varlistentry>
        <term>
+               <command><option>goto</option></command>
+               <option>x</option>
+       </term>
+       <listitem>
+        The next element will be printed at position 'x'.
+               <para></para></listitem>
+</varlistentry>
+
+<varlistentry>
+       <term>
+               <command><option>hddtemp</option></command>
+               <option>dev, (host,(port))</option>
+       </term>
+       <listitem>
+               Displays temperature of a selected hard disk drive as reported by the hddtemp daemon running on host:port.
+               Default host is 127.0.0.1, default port is 7634.
+               <para></para></listitem>
+</varlistentry>
+
+<varlistentry>
+       <term>
                <command><option>head</option></command>
                <option>logfile lines (interval)</option>
        </term>
 
 <varlistentry>
        <term>
+               <command><option>iconv_start</option></command>
+       <option>codeset_from codeset_to</option>
+       </term>
+       <listitem>
+               Convert text from one codeset to another using GNU iconv.  Needs to be stopped with iconv_stop.
+       <para></para></listitem>
+</varlistentry>
+
+<varlistentry>
+       <term>
+               <command><option>iconv_stop</option></command>
+       <option></option>
+       </term>
+       <listitem>
+               Stop iconv codeset conversion.
+       <para></para></listitem>
+</varlistentry>
+
+<varlistentry>
+       <term>
                <command><option>i2c</option></command>
-       <option>(dev), type, n</option>
+       <option>(dev) type n</option>
        </term>
        <listitem>
                I2C sensor from sysfs (Linux 2.6). dev may be omitted if you have only one I2C device. type is either in (or vol) meaning voltage, fan meaning fan or temp/tempf (first in C, second in F) meaning temperature. n is number of the sensor. See /sys/bus/i2c/devices/ on your local computer.
        <option></option>
        </term>
        <listitem>
-               If running the i8k kernel driver for Inspiron laptops, displays the cpu temperature in celsius, as reported by /proc/i8k.
+               If running the i8k kernel driver for Inspiron laptops, displays the cpu temperature in Celsius, as reported by /proc/i8k.
        <para></para></listitem>
 </varlistentry>
 
        <option></option>
        </term>
        <listitem>
-               If running the i8k kernel driver for Inspiron laptops, displays the cpu temperature in farenheit, as reported by /proc/i8k.
+               If running the i8k kernel driver for Inspiron laptops, displays the cpu temperature in Farenheit, as reported by /proc/i8k.
        <para></para></listitem>
 </varlistentry>
 
        <para></para></listitem>
 </varlistentry>
 
+<varlistentry>
+       <term>
+               <command><option>ibm_fan</option></command>
+       </term>
+       <listitem>
+               If running the IBM ACPI, displays the fan speed.
+       <para></para></listitem>
+</varlistentry>
+
+<varlistentry>
+       <term>
+               <command><option>ibm_temps</option></command>
+               <option>N</option>
+       </term>
+       <listitem>
+               If running the IBM ACPI, displays the temperatures
+               from the IBM temperature sensors (N=0..7) Sensor 0 is
+               on the CPU, 3 is on the GPU.
+       <para></para></listitem>
+</varlistentry>
+
+<varlistentry>
+       <term>
+               <command><option>ibm_volume</option></command>
+       </term>
+       <listitem>
+               If running the IBM ACPI, displays the "master" volume,
+       controlled by the volume keys (0-14).
+       <para></para></listitem>
+</varlistentry>
+
+<varlistentry>
+       <term>
+               <command><option>ibm_brightness</option></command>
+       </term>
+       <listitem>
+               If running the IBM ACPI, displays the brigtness of the
+       laptops's LCD (0-7).
+       <para></para></listitem>
+</varlistentry>
+
 
 <varlistentry>
        <term>
 
 <varlistentry>
        <term>
+               <command><option>imap_messages</option></command>
+       <option>(args)</option>
+       </term>
+       <listitem>
+               Displays the number of messages in your global IMAP inbox by default.  You can define individual IMAP inboxes seperately by passing arguments to this object.  Arguments are: "host user pass [-i interval] [-p port] [-e command]".  Default port is 110, default interval is 5 minutes.  If the password is supplied as '*', you will be prompted to enter the password when Conky starts.
+       <para></para></listitem>
+</varlistentry>
+
+<varlistentry>
+       <term>
+               <command><option>imap_unseen</option></command>
+       <option>(args)</option>
+       </term>
+       <listitem>
+               Displays the number of unseen messages in your global IMAP inbox by default.  You can define individual IMAP inboxes seperately by passing arguments to this object.  Arguments are: "host user pass [-i interval] [-p port] [-e command]".  Default port is 110, default interval is 5 minutes.  If the password is supplied as '*', you will be prompted to enter the password when Conky starts.
+       <para></para></listitem>
+</varlistentry>
+
+<varlistentry>
+       <term>
                <command><option>kernel</option></command>
        </term>
        <listitem>
 
 <varlistentry>
        <term>
-               <command><option>ml_upload_counter</option></command>
+               <command><option>mpd_artist</option></command>
        </term>
        <listitem>
-               total session upload in mb
+               Artist in current MPD song must be enabled at compile
        <para></para></listitem>
 </varlistentry>
 
 <varlistentry>
        <term>
-               <command><option>ml_download_counter</option></command>
+               <command><option>mpd_album</option></command>
        </term>
        <listitem>
-               total session download in mb
+               Album in current MPD song
        <para></para></listitem>
 </varlistentry>
 
 <varlistentry>
        <term>
-               <command><option>ml_nshared_files</option></command>
+               <command><option>mpd_bar</option></command>
+       <option>(height),(width)</option>
        </term>
        <listitem>
-               number of shared files
+               Bar of mpd's progress
        <para></para></listitem>
 </varlistentry>
 
 <varlistentry>
        <term>
-               <command><option>ml_shared_counter</option></command>
+               <command><option>mpd_bitrate</option></command>
        </term>
        <listitem>
-               total session shared in mb, buggy in some mldonkey versions
+               Bitrate of current song
        <para></para></listitem>
 </varlistentry>
 
 <varlistentry>
        <term>
-               <command><option>ml_tcp_upload_rate</option></command>
+               <command><option>mpd_status</option></command>
        </term>
        <listitem>
-               tcp upload rate in kb/s
+               Playing, stopped, et cetera.
        <para></para></listitem>
 </varlistentry>
 
 <varlistentry>
        <term>
-               <command><option>ml_tcp_download_rate</option></command>
+               <command><option>mpd_title</option></command>
        </term>
        <listitem>
-               tcp download rate in kb/s
+               Title of current MPD song
        <para></para></listitem>
 </varlistentry>
 
 <varlistentry>
        <term>
-               <command><option>ml_udp_upload_rate</option></command>
+               <command><option>mpd_vol</option></command>
        </term>
        <listitem>
-               udp upload rate in kb/s
+               MPD's volume
        <para></para></listitem>
 </varlistentry>
 
 <varlistentry>
        <term>
-               <command><option>ml_udp_download_rate</option></command>
+               <command><option>mpd_elapsed</option></command>
        </term>
        <listitem>
-               udp download rate in kb/s
+               Song's elapsed time
        <para></para></listitem>
 </varlistentry>
 
 <varlistentry>
        <term>
-               <command><option>ml_ndownloaded_files</option></command>
+               <command><option>mpd_length</option></command>
        </term>
        <listitem>
-               number of completed files
+               Song's length
        <para></para></listitem>
 </varlistentry>
 
 <varlistentry>
        <term>
-               <command><option>ml_ndownloading_files</option></command>
+               <command><option>mpd_percent</option></command>
        </term>
        <listitem>
-               number of downloading files
+               Percent of song's progress
        <para></para></listitem>
 </varlistentry>
 
 <varlistentry>
        <term>
-               <command><option>mpd_artist</option></command>
+               <command><option>mpd_random</option></command>
        </term>
        <listitem>
-               Artist in current MPD song must be enabled at compile
+               Random status (On/Off)
        <para></para></listitem>
 </varlistentry>
 
 <varlistentry>
        <term>
-               <command><option>mpd_album</option></command>
+               <command><option>mpd_repeat</option></command>
        </term>
        <listitem>
-               Album in current MPD song
+               Repeat status (On/Off)
        <para></para></listitem>
 </varlistentry>
 
 <varlistentry>
        <term>
-               <command><option>mpd_bar</option></command>
-       <option>(height),(width)</option>
+               <command><option>mpd_track</option></command>
        </term>
        <listitem>
-               Bar of mpd's progress
+               Prints the MPD track field
        <para></para></listitem>
 </varlistentry>
 
 <varlistentry>
        <term>
-               <command><option>mpd_bitrate</option></command>
+               <command><option>mpd_name</option></command>
        </term>
        <listitem>
-               Bitrate of current song
+               Prints the MPD name field
        <para></para></listitem>
 </varlistentry>
 
 <varlistentry>
        <term>
-               <command><option>mpd_status</option></command>
+               <command><option>mpd_file</option></command>
        </term>
        <listitem>
-               Playing, stopped, et cetera.
+               Prints the file name of the current MPD song
        <para></para></listitem>
 </varlistentry>
 
 <varlistentry>
        <term>
-               <command><option>mpd_title</option></command>
+               <command><option>mpd_smart</option></command>
        </term>
        <listitem>
-               Title of current MPD song
+               Prints the song name in either the form "artist - title" or file name, depending on whats available
        <para></para></listitem>
 </varlistentry>
 
 <varlistentry>
        <term>
-               <command><option>mpd_vol</option></command>
+               <command><option>new_mails</option></command>
        </term>
        <listitem>
-               MPD's volume
+               Unread mail count in mail spool.
        <para></para></listitem>
 </varlistentry>
 
 <varlistentry>
        <term>
-               <command><option>mpd_elapsed</option></command>
+               <command><option>nodename</option></command>
        </term>
        <listitem>
-               Song's elapsed time
+               Hostname
        <para></para></listitem>
 </varlistentry>
 
 <varlistentry>
        <term>
-               <command><option>mpd_length</option></command>
+               <command><option>outlinecolor</option></command>
+       <option>(color)</option>
        </term>
        <listitem>
-               Song's length
+               Change outline color
        <para></para></listitem>
 </varlistentry>
 
 <varlistentry>
        <term>
-               <command><option>mpd_percent</option></command>
+               <command><option>pb_battery</option></command>
+               <option>item</option>
        </term>
        <listitem>
-               Percent of song's progress
+                If running on Apple powerbook/ibook, display
+                information on battery status. The item parameter
+                specifies, what information to display. Exactly one item
+                must be specified. Valid items are:
+               <simplelist>
+                        <member><command>status</command>:
+                                Display if battery is fully charged, charging,
+                                discharging or absent (running on AC)
+                        </member>
+                        <member><command>percent</command>:
+                                Display charge of battery in percent, if
+                                charging or discharging. Nothing will be
+                                displayed, if battery is fully charged
+                                or absent.
+                        </member>
+                        <member><command>time</command>:
+                                Display the time remaining until the battery
+                                will be fully charged or discharged at current
+                                rate.  Nothing is displayed, if battery is
+                                absent or if it's present but fully charged
+                                and not discharging.
+                        </member>
+                </simplelist>
        <para></para></listitem>
 </varlistentry>
 
 <varlistentry>
        <term>
-               <command><option>new_mails</option></command>
+               <command><option>pop3_unseen</option></command>
+       <option>(args)</option>
        </term>
        <listitem>
-               Unread mail count in mail spool.
-       <para></para></listitem>
-</varlistentry>
+               Displays the number of unseen messages in your global POP3 inbox by default.  You can define individual POP3 inboxes seperately by passing arguments to this object.  Arguments are: "host user pass [-i interval] [-p port] [-e command]".  Default port is 110, default interval is 5 minutes.  If the password is supplied as '*', you will be prompted to enter the password when Conky starts.
 
-<varlistentry>
-       <term>
-               <command><option>nodename</option></command>
-       </term>
-       <listitem>
-               Hostname
-       <para></para></listitem>
+               <para></para></listitem>
 </varlistentry>
 
 <varlistentry>
        <term>
-               <command><option>outlinecolor</option></command>
-       <option>(color)</option>
+               <command><option>pop3_used</option></command>
+       <option>(args)</option>
        </term>
        <listitem>
-               Change outline color
-       <para></para></listitem>
+               Displays the amount of space (in MiB, 2^20) used in your global POP3 inbox by default.  You can define individual POP3 inboxes seperately by passing arguments to this object.  Arguments are: "host user pass [-i interval] [-p port] [-e command]".  Default port is 110, default interval is 5 minutes.  If the password is supplied as '*', you will be prompted to enter the password when Conky starts.
+
+               <para></para></listitem>
 </varlistentry>
 
 <varlistentry>
 
 <varlistentry>
        <term>
+               <command><option>tcp_portmon</option></command>
+               <option>port_begin port_end item (index)</option>
+               <emphasis>(ip4 only at present)</emphasis>
+       </term>
+       <listitem>
+               TCP port monitor for specified local ports.  Port numbers must be in the range 1 to 65535. Valid items are:
+               <simplelist>
+                       <member><command>count</command> - total number of connections in the range
+                               </member>
+                       <member><command>rip</command> - remote ip address
+                               </member>
+                       <member><command>rhost</command> - remote host name 
+                               </member>
+                       <member><command>rport</command> - remote port number
+                               </member>
+                       <member><command>rservice</command> - remote service name from /etc/services
+                               </member>
+                       <member><command>lip</command> - local ip address
+                               </member>
+                       <member><command>lhost</command> - local host name
+                               </member>
+                       <member><command>lport</command> - local port number
+                               </member>
+                       <member><command>lservice</command> - local service name from /etc/services
+                               </member>
+               </simplelist>The connection index provides you with access to each connection in the port monitor.  The monitor will return information for index values from 0 to n-1 connections.  Values higher than n-1 are simply ignored.  For the "count" item, the connection index must be omitted.  It is required for all other items.
+               <simplelist>
+                       <member>Examples:</member>
+                       <member><command>${tcp_portmon 6881 6999 count}</command> -
+                               displays the number of connections in the bittorrent port range</member>
+                       <member><command>${tcp_portmon 22 22 rip 0}</command> -
+                               displays the remote host ip of the first sshd connection</member>
+                       <member><command>${tcp_portmon 22 22 rip 9}</command> -
+                               displays the remote host ip of the tenth sshd connection</member>
+                       <member><command>${tcp_portmon 1 1024 rhost 0}</command> -
+                               displays the remote host name of the first connection on a privileged port</member>
+                       <member><command>${tcp_portmon 1 1024 rport 4}</command> -
+                               displays the remote host port of the fifth connection on a privileged port</member>
+                       <member><command>${tcp_portmon 1 65535 lservice 14}</command> -
+                               displays the local service name of the fifteenth connection in the range of all ports</member>
+               </simplelist>Note that port monitor variables which share the same port range actually refer to the same monitor, so many references to a single port range for different items and different indexes all use the same monitor internally.  In other words, the program avoids creating redundant monitors. 
+       </listitem>
+</varlistentry>
+
+<varlistentry>
+       <term>
                <command><option>texeci</option></command>
                <option>interval command</option>
        </term>
 
 <varlistentry>
        <term>
+               <command><option>tab</option></command>
+               <option>(width, (start))</option>
+       </term>
+       <listitem>
+        Puts a tab of the specified width, starting from column 'start'.
+       <para></para></listitem>
+</varlistentry>
+
+<varlistentry>
+       <term>
                <command><option>tail</option></command>
                <option>logfile lines (interval)</option>
        </term>
 
 <varlistentry>
        <term>
+               <command><option>utime</option></command>
+       <option>(format)</option>
+       </term>
+       <listitem>
+               Display time in UTC (universal coordinate time).
+       <para></para></listitem>
+</varlistentry>
+
+<varlistentry>
+       <term>
+               <command><option>tztime</option></command>
+       <option>(timezone) (format)</option>
+       </term>
+       <listitem>
+               Local time for specified timezone, see man strftime to get more information about format. The timezone argument is  specified in similar fashion as TZ environment variable. For hints, look in /usr/share/zoneinfo. e.g. US/Pacific, Europe/Zurich, etc.
+       <para></para></listitem>
+</varlistentry>
+
+<varlistentry>
+       <term>
                <command><option>totaldown</option></command>
        <option>net</option>
        </term>
        <option>type, num</option>
        </term>
        <listitem>
-               This takes arguments in the form:top (name) (number) Basically, processes are ranked from highest to lowest in terms of cpu usage, which is what (num) represents. The types are: "name", "pid", "cpu", and mem". There can be a max of 10 processes listed.
+               This takes arguments in the form:top (name) (number) Basically, processes are ranked from highest to lowest in terms of cpu usage, which is what (num) represents. The types are: "name", "pid", "cpu", and "mem". There can be a max of 10 processes listed.
        <para></para></listitem>
 </varlistentry>
 
                Seti@home total user credit
        <para></para></listitem>
 </varlistentry>
+
 <varlistentry>
        <term>
                <command><option>voffset</option></command>
                <option>(pixels)</option>
        </term>
        <listitem>
-               Change verticle offset by N pixels.  Negative values will cause text to overlap.  See also $offset.
+               Change vertical offset by N pixels.  Negative values will cause text to overlap.  See also $offset.
                <para></para></listitem>
 </varlistentry>
 
+<varlistentry>
+       <term>
+               <command><option>voltage_mv</option></command>
+               <option>(n)</option>
+       </term>
+       <listitem>
+               Returns CPU #n's voltage in mV. CPUs are
+               counted from 1. If omitted, the parameter
+               defaults to 1. 
+               <para></para></listitem>
+</varlistentry>
+
+<varlistentry>
+       <term>
+               <command><option>voltage_v</option></command>
+               <option>(n)</option>
+       </term>
+       <listitem>
+               Returns CPU #n's voltage in V. CPUs are
+               counted from 1. If omitted, the parameter
+               defaults to 1.
+               <para></para></listitem>
+</varlistentry>
+               
+<varlistentry>
+       <term>
+               <command><option>xmms_bar</option></command>
+                <option>(height),(width)</option>
+       </term>
+       <listitem>
+               xmms / bmp / audacious / infopipe: progress bar
+       <para></para></listitem>
+</varlistentry>
+
+<varlistentry>
+       <term>
+               <command><option>xmms_bitrate</option></command>
+       </term>
+       <listitem>
+               xmms / bmp / audacious / infopipe: bitrate of current tune
+       <para></para></listitem>
+</varlistentry>
+
+<varlistentry>
+       <term>
+               <command><option>xmms_channels</option></command>
+       </term>
+       <listitem>
+               xmms / bmp / audacious / infopipe: number of audio channels of current tune
+       <para></para></listitem>
+</varlistentry>
+
+<varlistentry>
+       <term>
+               <command><option>xmms_filename</option></command>
+       </term>
+       <listitem>
+               xmms / bmp / audacious / infopipe: full path and filename of current tune
+       <para></para></listitem>
+</varlistentry>
+
+<varlistentry>
+       <term>
+               <command><option>xmms_frequency</option></command>
+       </term>
+       <listitem>
+               xmms / bmp / audacious / infopipe: sampling frequency of current tune
+       <para></para></listitem>
+</varlistentry>
+
+<varlistentry>
+       <term>
+               <command><option>xmms_length</option></command>
+       </term>
+       <listitem>
+               xmms / bmp / audacious / infopipe: total length of current tune as MM:SS
+       <para></para></listitem>
+</varlistentry>
+
+<varlistentry>
+       <term>
+               <command><option>xmms_length_seconds</option></command>
+       </term>
+       <listitem>
+               xmms / bmp / audacious / infopipe: total length of current tune in seconds
+       <para></para></listitem>
+</varlistentry>
+
+<varlistentry>
+       <term>
+               <command><option>xmms_playlist_position</option></command>
+       </term>
+       <listitem>
+               xmms / bmp / audacious / infopipe: playlist position of current tune
+       <para></para></listitem>
+</varlistentry>
+
+<varlistentry>
+       <term>
+               <command><option>xmms_playlist_length</option></command>
+       </term>
+       <listitem>
+               xmms / bmp / audacious / infopipe: number of tunes in playlist
+       <para></para></listitem>
+</varlistentry>
+
+<varlistentry>
+       <term>
+               <command><option>xmms_position</option></command>
+       </term>
+       <listitem>
+               xmms / bmp / audacious / infopipe: MM:SS position of current tune
+       <para></para></listitem>
+</varlistentry>
+
+<varlistentry>
+       <term>
+               <command><option>xmms_position_seconds</option></command>
+       </term>
+       <listitem>
+               xmms / bmp / audacious / infopipe: position of current tune in seconds
+       <para></para></listitem>
+</varlistentry>
+
+<varlistentry>
+       <term>
+               <command><option>xmms_status</option></command>
+       </term>
+       <listitem>
+               xmms / bmp / audacious / infopipe: player status (Playing/Paused/Stopped/Not running)
+       <para></para></listitem>
+</varlistentry>
+
+<varlistentry>
+       <term>
+               <command><option>xmms_title</option></command>
+       </term>
+       <listitem>
+               xmms / bmp / audacious / infopipe: title of current tune
+       <para></para></listitem>
+</varlistentry>
 
 </variablelist>