debian: update readme

1 files changed, 32 insertions, 48 deletions

diff --git a/debian/README.debian b/debian/README.debian
index 1740e1b..af11ca1 100644
--- a/debian/README.debian
+++ b/debian/README.debian
@@ -12,27 +12,23 @@ the README.rst file in the mpv-build directory, or equivalently at [1].
 Differences with distribution packages
 ============================================
 
-Debian testing/unstable already has a separate official package for
-mpv, which closely tracks the current upstream  releases. Ubuntu Utopic
-also has an outdated version of mpv (0.4.2), while Trusty is even more
-so (0.3.4). The biggest difference between this package and the
-official Debian/Ubuntu ones is that it statically links against the
-latest upstream version of ffmpeg and libass. Debian and Ubuntu use
-the libav fork of ffmpeg, and therefore that's what the official
-packages link against. However, as described at [2], ffmpeg is
-preferred for building mpv. This situation is however changing as
-Debian has recently added a version of mpv built against
-ffmpeg to the "experimental" repository.
-
-[2] https://github.com/mpv-player/mpv/wiki/FFmpeg-versus-Libav
-
-Since there are outstanding bugs in the latest release of libass
-(which is getting quite old), even the "release" version of this
-package links against the libass git master. Debian unstable and
-Ubuntu Utopic use the latest libass 0.10.2 release.
-
-Furthermore, since there is no mpv on on Debian stable, this package
-is probably the best alternative.
+Debian testing/unstable already has a separate official package for mpv, which
+closely tracks the current upstream releases. Debian stable, the latest Ubuntu
+and Ubuntu LTS all also have official mpv packages, however these range from
+outdated to extremely outdated. This pacakge can be compiled on all of these
+platforms and offers either the most recent mpv release or git master.
+
+This pacakge statically links against the latest release or git master of ffmpeg.
+Debian and Ubuntu use the libav fork of ffmpeg, and therefore that's what their
+official mpv packages link against. However, ffmpeg is preferred for building
+mpv as it enables more features. This situation is however changing as Debian
+has added a version of mpv built against ffmpeg to the "experimental"
+repository.
+
+Since the release cycle of libass is quite slow, even the "release" version of
+this package links against the libass git master. Debian unstable uses the
+latest libass release, while Debian stable, the latest Ubuntu and Ubuntu LTS all
+use buggy and outdated libass releases.
 
 In order to maintain this interoperability between distributions, this
 package must necessarily disable some features by default which are
@@ -41,24 +37,26 @@ support for RTL scripts and sdl2 audio/video output (you may
 nevertheless trivially enable these provided sufficiently recent
 libraries - see below).
 
-On the other hand, this package enables native smb support (to play
-smb:// URLs) and caca (for silly ascii art output) which is not
-present in the official Debian package. The official Ubuntu package is
-additionally missing video4Linux. More seriously, due to a persistent
-packaging bug, Ubuntu Trusty mpv is also missing lua support (therefore no
-on-screen controller).
+On the other hand, this package enables native smb support (to play smb://
+URLs), video4linux2 (for web cams and video capture) and caca (for silly ascii
+art output) which is not present in the official Debian package.
+
+Due to a persistent packaging bug, the official Ubuntu Trusty mpv is missing lua
+support (therefore no on-screen controller).
 
 There are several other features that are disabled in both this
 package as well as the official Debian package because they are not
 widely needed or used. These include openal output, portaudio output,
-rsound/libroar/sndio input/output, sdl1, joystick, videoio.h/libpt. If
+rsound/libroar/sndio input/output, sdl1/sdl2, joystick, videoio.h/libpt. If
 you find any of these useful, please open an issue at [3] explaining
 why you think the feature in question should be enabled, and we can
 try and include it in this package.
 
 [3] https://github.com/mpv-player/mpv-build/issues
 
-Finally, in addition to the default of building the latest released
+Building from git master
+========================
+In addition to the default of building the latest released
 version of mpv, this package can also trivially be built from the
 latest git master of mpv (as well as ffmpeg and libass). As described
 in README.rst [1], this is achieved by calling
@@ -87,15 +85,16 @@ According to wayland.freedesktop.org, "Wayland is intended as a
 simpler replacement for X, easier to develop and maintain". It is very
 much a work in progress, so adequate functionality requires recent
 version of the relevant libraries. At present, this not possible on
-Debian stable. To maintain interoperability, this package therefore
+Debian Wheezy. To maintain interoperability, this package therefore
 does not build with Wayland support by default.
 
 If you want Wayland support, you will need to manually install the
 necessary packages before building:
 
-    apt-get install libwayland-dev libxkbcommon-dev
+    apt-get install libwayland-dev libxkbcommon-dev libegl1-mesa-dev
 
-The mpv build will then automatically detect and link to them.
+The mpv build will then automatically detect and link to them if they are new
+enough.
 
 Harfbuz support
 ===============
@@ -106,19 +105,4 @@ installing the relevant development package:
     apt-get install libharfbuzz-dev
 
 The libass configure will then automatically find it. This is
-necessary as the package is not available in Ubunutu Precise.
-
-SDL2 Support
-============
-
-mpv has support for sdl2 video and audio output, but it is disabled by
-default because opengl/alsa are preferred. The required package is
-also not available on Debian stable (though it is in backports). If
-however, you wish to try the sdl2 modules install the sdl2 development
-package:
-
-    apt-get install libsdl2-dev
-
-and add the option to the mpv_options file
-
-    echo --enable-sdl2 >> mpv_options
\ No newline at end of file
+necessary as the package is not available in Debian Wheezy.