Add docs for MPRIS frontend, update changelog.

docs/api/frontends.rst

@@ -28,3 +28,4 @@ Frontend implementations
 
 * :mod:`mopidy.frontends.lastfm`
 * :mod:`mopidy.frontends.mpd`
+* :mod:`mopidy.frontends.mpris`

docs/changes.rst

@@ -28,6 +28,11 @@ v0.6.0 (in development)
 - The MPD command ``idle`` is now supported by Mopidy for the following
   subsystems: player, playlist, options, and mixer. (Fixes: :issue:`32`)
 
+- A new frontend :mod:`mopidy.frontends.mpris` have been added. It exposes
+  Mopidy through the `MPRIS interface <http://www.mpris.org/>`_ over D-Bus. In
+  practice, this makes it possible to control Mopidy thorugh the `Ubuntu Sound
+  Menu <https://wiki.ubuntu.com/SoundMenu>`_.
+
 **Changes**
 
 - Replace :attr:`mopidy.backends.base.Backend.uri_handlers` with

docs/modules/frontends/mpris.rst

@@ -0,0 +1,7 @@
+***********************************************
+:mod:`mopidy.frontends.mpris` -- MPRIS frontend
+***********************************************
+
+.. automodule:: mopidy.frontends.mpris
+    :synopsis: MPRIS frontend
+    :members:

docs/settings.rst

@@ -92,7 +92,6 @@ To make a ``tag_cache`` of your local music available for Mopidy:
 
 .. _use_mpd_on_a_network:
 
-
 Connecting from other machines on the network
 =============================================
 
@@ -120,6 +119,8 @@ file::
     LASTFM_PASSWORD = u'mysecret'
 
 
+.. _install_desktop_file:
+
 Controlling Mopidy through the Ubuntu Sound Menu
 ================================================
 
@@ -139,10 +140,10 @@ After you have installed the file, start Mopidy in any way, and Mopidy should
 appear in the Ubuntu Sound Menu. When you quit Mopidy, it will still be listed
 in the Ubuntu Sound Menu, and may be restarted by selecting it there.
 
-The Ubuntu Sound Menu interacts with Mopidy's MPRIS frontend.
-The MPRIS frontend supports the minimum requirements of the `MPRIS
-specification <http://www.mpris.org/>`_. The ``TrackList`` and the
-``Playlists`` interfaces of the spec are not supported.
+The Ubuntu Sound Menu interacts with Mopidy's MPRIS frontend,
+:mod:`mopidy.frontends.mpris`. The MPRIS frontend supports the minimum
+requirements of the `MPRIS specification <http://www.mpris.org/>`_. The
+``TrackList`` and the ``Playlists`` interfaces of the spec are not supported.
 
 
 Streaming audio through a SHOUTcast/Icecast server

mopidy/frontends/mpris/__init__.py

@@ -18,18 +18,22 @@ from mopidy.listeners import BackendListener
 class MprisFrontend(ThreadingActor, BackendListener):
     """
     Frontend which lets you control Mopidy through the Media Player Remote
-    Interfacing Specification (MPRIS) D-Bus interface.
+    Interfacing Specification (`MPRIS <http://www.mpris.org/>`_) D-Bus
+    interface.
 
-    An example of an MPRIS client is `Ubuntu's sound menu
+    An example of an MPRIS client is the `Ubuntu Sound Menu
     <https://wiki.ubuntu.com/SoundMenu>`_.
 
     **Dependencies:**
 
-    - ``dbus`` Python bindings. The package is named ``python-dbus`` in
+    - D-Bus Python bindings. The package is named ``python-dbus`` in
       Ubuntu/Debian.
     - ``libindicate`` Python bindings is needed to expose Mopidy in e.g. the
       Ubuntu Sound Menu. The package is named ``python-indicate`` in
       Ubuntu/Debian.
+    - An ``.desktop`` file for Mopidy installed at the path set in
+      :attr:`mopidy.settings.DESKTOP_FILE`. See :ref:`install_desktop_file` for
+      details.
 
     **Testing the frontend**