From 5e21b2db3cbddd8bae9eb78e6653a830c6c9521c Mon Sep 17 00:00:00 2001
From: Max Kellermann <max@musicpd.org>
Date: Tue, 23 Apr 2019 14:29:42 +0200
Subject: [PATCH] doc/protocol.rst: "list file" is deprecated
Closes https://github.com/MusicPlayerDaemon/MPD/issues/526
---
NEWS | 1 +
doc/protocol.rst | 7 +++++--
2 files changed, 6 insertions(+), 2 deletions(-)
diff --git a/NEWS b/NEWS
index 86370ba23..15536c6cd 100644
--- a/NEWS
+++ b/NEWS
@@ -10,6 +10,7 @@ ver 0.21.8 (not yet released)
* fix build failure with GCC 9
* fix build failure with -Ddatabase=false
* systemd: add user socket unit
+* doc: "list file" is deprecated
ver 0.21.7 (2019/04/03)
* input
diff --git a/doc/protocol.rst b/doc/protocol.rst
index 5ccbaa92f..a9d757194 100644
--- a/doc/protocol.rst
+++ b/doc/protocol.rst
@@ -861,8 +861,7 @@ The music database
:command:`list {TYPE} {FILTER} [group {GROUPTYPE}]`
Lists unique tags values of the specified type.
``TYPE`` can be any tag supported by
- :program:`MPD` or
- *file*.
+ :program:`MPD`.
Additional arguments may specify a :ref:`filter <filter_syntax>`.
The *group* keyword may be used
@@ -873,6 +872,10 @@ The music database
list album group albumartist
+ ``list file`` was implemented in an early :program:`MPD` version,
+ but does not appear to make a lot of sense. It still works (to
+ avoid breaking compatibility), but is deprecated.
+
.. _command_listall:
:command:`listall [URI]`