From 16bc97e9e56c709990fc879b75c9b39d290e525a Mon Sep 17 00:00:00 2001
From: Max Kellermann <max@musicpd.org>
Date: Wed, 31 Oct 2018 15:22:28 +0100
Subject: [PATCH] doc/user.rst: add warning about outdated Debian packages

---
 doc/user.rst | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/doc/user.rst b/doc/user.rst
index 8af620410..700601946 100644
--- a/doc/user.rst
+++ b/doc/user.rst
@@ -22,6 +22,15 @@ Install the package :file:`mpd` via :program:`apt`:
 
 When installed this way, :program:`MPD` by default looks for music in :file:`/var/lib/mpd/music/`; this may not be correct. Look at your :file:`/etc/mpd.conf` file... 
 
+.. note::
+
+   Debian and Ubuntu are infamous for shipping heavily outdated
+   software.  The :program:`MPD` version in their respective stable
+   releases are usually too old to be supported by this project.
+   Ironically, the :program:`MPD` version in Debian "*unstable*" is
+   more stable than the version in Debian "*stable*".
+
+
 Installing on Android
 ---------------------