summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorMax Kellermann <max@musicpd.org>2019-04-23 14:29:42 +0200
committerMax Kellermann <max@musicpd.org>2019-04-23 14:29:42 +0200
commit5e21b2db3cbddd8bae9eb78e6653a830c6c9521c (patch)
tree5e8eb76a8969498d1fe7636525d0daf207f426da
parent3a0d6d96c138a303bdc5ee06fd2e11a03e8f1404 (diff)
doc/protocol.rst: "list file" is deprecated
Closes https://github.com/MusicPlayerDaemon/MPD/issues/526
-rw-r--r--NEWS1
-rw-r--r--doc/protocol.rst7
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]`