docs: How to install libspotify at OS X, and other small installation docs changes

docs/installation/despotify.rst

@@ -27,16 +27,22 @@ Build and install Despotify::
     cd despotify/src/
     sudo make install
 
+When Despotify has been installed, continue with :ref:`spytify_installation`.
+
 
 Installing Despotify on OS X
 ============================
 
-In OS X you need to have `XCode <http://developer.apple.com/tools/xcode/>`_
+In OS X you need to have `XCode <http://developer.apple.com/tools/xcode/>`_ and
-installed, and `Homebrew <http://mxcl.github.com/homebrew/>`_. Then, install
+`Homebrew <http://mxcl.github.com/homebrew/>`_ installed. Then, to install
 Despotify::
 
     brew install despotify
 
+When Despotify has been installed, continue with :ref:`spytify_installation`.
+
+
+.. _spytify_installation:
 
 Installing spytify
 ==================

docs/installation/index.rst

@@ -7,11 +7,11 @@ Mopidy itself is a breeze to install, as it just requires a standard Python
 service is far more tricky to get working for the time being. Until
 installation of these libraries are either well documented by their developers,
 or the libraries are packaged for various Linux distributions, we will supply
-our own installation guides.
+our own installation guides, as linked to below.
 
 
-Dependencies
+Install dependencies
-============
+====================
 
 .. toctree::
     :hidden:
@@ -20,6 +20,8 @@ Dependencies
     libspotify
     gstreamer
 
+Make sure you got the required dependencies installed.
+
 - Python >= 2.6, < 3
 - Dependencies for at least one Mopidy mixer:
 
@@ -29,7 +31,7 @@ Dependencies
 
   - OsaMixer (OS X only)
 
-    - Nothing needed.
+    - No additional dependencies.
 
 - Dependencies for at least one Mopidy backend:
 

docs/installation/libspotify.rst

@@ -12,11 +12,9 @@ To use the libspotify backend you must install libspotify and
     This backend requires a Spotify premium account, and it requires you to get
     an application key from Spotify before use.
 
-**TODO** Test and document installation on OS X.
 
-
+Installing libspotify on Linux
-Installing libspotify
+==============================
-=====================
 
 Download and install libspotify 0.0.4 for your OS and CPU architecture from
 https://developer.spotify.com/en/libspotify/.
@@ -29,6 +27,30 @@ For 64-bit Linux the process is as follows::
     sudo make install prefix=/usr/local
     sudo ldconfig
 
+When libspotify has been installed, continue with
+:ref:`pyspotify_installation`.
+
+
+Installing libspotify on OS X
+=============================
+
+In OS X you need to have `XCode <http://developer.apple.com/tools/xcode/>`_ and
+`Homebrew <http://mxcl.github.com/homebrew/>`_ installed. Then, to install
+libspotify::
+
+    brew install libspotify
+
+When libspotify has been installed, continue with
+:ref:`pyspotify_installation`.
+
+
+Install libspotify on Windows
+=============================
+
+**TODO** Test and document installation on Windows.
+
+
+.. _pyspotify_installation:
 
 Installing pyspotify
 ====================
@@ -43,14 +65,14 @@ Check out the pyspotify code, and install it::
     cd pyspotify/pyspotify/
     sudo python setup.py install
 
-Apply for an application key at
-https://developer.spotify.com/en/libspotify/application-key, download the
-binary version, and place the file at ``pyspotify/spotify_appkey.key``.
-
 
 Testing the installation
 ========================
 
+Apply for an application key at
+https://developer.spotify.com/en/libspotify/application-key, download the
+binary version, and place the file at ``pyspotify/spotify_appkey.key``.
+
 Test your libspotify setup::
 
     examples/example1.py -u USERNAME -p PASSWORD