diff --git a/docs/installation/despotify.rst b/docs/installation/despotify.rst
index 07a3cd9a..335efa14 100644
--- a/docs/installation/despotify.rst
+++ b/docs/installation/despotify.rst
@@ -1,58 +1,50 @@
**********************
-despotify installation
+Despotify installation
**********************
-To use the `despotify `_ backend, you first need to
-install despotify and spytify.
+To use the `Despotify `_ backend, you first need to
+install Despotify and spytify.
.. warning::
This backend requires a Spotify premium account.
-Installing despotify
-====================
+Installing Despotify on Linux
+=============================
-*Linux:* Install despotify's dependencies. At Debian/Ubuntu systems::
+Install Despotify's dependencies. At Debian/Ubuntu systems::
sudo aptitude install libssl-dev zlib1g-dev libvorbis-dev \
libtool libncursesw5-dev libao-dev python-dev
-*OS X:* In OS X you need to have `XCode
-`_ installed, and either `MacPorts
-`_ or `Homebrew `_.
-
-*OS X, Homebrew:* Install dependencies::
-
- brew install libvorbis ncursesw libao pkg-config
-
-*OS X, MacPorts:* Install dependencies::
-
- sudo port install libvorbis libtool ncursesw libao
-
-*All OS:* Check out revision 508 of the despotify source code::
+Check out revision 508 of the Despotify source code::
svn checkout https://despotify.svn.sourceforge.net/svnroot/despotify@508
-*OS X, MacPorts:* Copy ``despotify/src/Makefile.local.mk.dist`` to
-``despotify/src/Makefile.local.mk`` and uncomment the last two lines of the new
-file so that it reads::
-
- ## If you're on Mac OS X and have installed libvorbisfile
- ## via 'port install ..', try uncommenting these lines
- CFLAGS += -I/opt/local/include
- LDFLAGS += -L/opt/local/lib
-
-*All OS:* Build and install despotify::
+Build and install Despotify::
cd despotify/src/
sudo make install
+Installing Despotify on OS X
+============================
+
+In OS X you need to have `XCode `_
+installed, and `Homebrew `_. Then, install
+Despotify::
+
+ brew install despotify
+
+
Installing spytify
==================
-spytify's source comes bundled with despotify.
+spytify's source comes bundled with despotify. If you haven't already checkout
+out the despotify source, do it now::
+
+ svn checkout https://despotify.svn.sourceforge.net/svnroot/despotify@508
Build and install spytify::
diff --git a/docs/notes.rst b/docs/notes.rst
new file mode 100644
index 00000000..a1e63b9f
--- /dev/null
+++ b/docs/notes.rst
@@ -0,0 +1,56 @@
+Given a playlist of three tracks numbered 1, 2, 3, and a currently playing
+track ``c``.
+
+Tests perfomed on MPD 0.15.4-1ubuntu3.
+
+====== ====== ====== ======= ===== ===== =====
+ Inputs previous_track
+------------------------------- -------------------
+repeat random single consume c = 1 c = 2 c = 3
+====== ====== ====== ======= ===== ===== =====
+T T T T Rand? Rand? Rand?
+T T T . 3 1 2
+T T . T Rand? Rand? Rand?
+T T . . 3 1 2
+T . T T 3 1 2
+T . T . 3 1 2
+T . . T 3 1 2
+T . . . 3 1 2
+. T T T c c c
+. T T . c c c
+. T . T c c c
+. T . . c c c
+. . T T 1 1 2
+. . T . 1 1 2
+. . . T 1 1 2
+. . . . 1 1 2
+====== ====== ====== ======= ===== ===== =====
+
+====== ====== ====== ======= ===== ===== =====
+ Inputs next_track
+------------------------------- -------------------
+repeat random single consume c = 1 c = 2 c = 3
+====== ====== ====== ======= ===== ===== =====
+T T T T
+T T T .
+T T . T
+T T . .
+T . T T
+T . T .
+T . . T
+T . . .
+. T T T
+. T T .
+. T . T
+. T . .
+. . T T
+. . T .
+. . . T
+. . . .
+====== ====== ====== ======= ===== ===== =====
+
+Other rules
+-----------
+
+- If :attr:`time_position` of the current track is 15s or more,
+ :meth:`previous()` should do a :meth:`seek()` to time position 0.