From be0360d5e84bd3c8abc1d91bb464e021263dea9c Mon Sep 17 00:00:00 2001 From: Max Kellermann Date: Fri, 8 Jul 2022 11:44:08 +0200 Subject: [PATCH] doc/user.rst: clarify .mpdignore documentation Closes https://github.com/MusicPlayerDaemon/MPD/issues/1532 --- doc/user.rst | 14 +++++++++++++- 1 file changed, 13 insertions(+), 1 deletion(-) diff --git a/doc/user.rst b/doc/user.rst index 06d8e2924..85b8ba696 100644 --- a/doc/user.rst +++ b/doc/user.rst @@ -1063,7 +1063,19 @@ The "music directory" is where you store your music files. :program:`MPD` stores Depending on the size of your music collection and the speed of the storage, this can take a while. -To exclude a file from the update, create a file called :file:`.mpdignore` in its parent directory. Each line of that file may contain a list of shell wildcards. Matching files in the current directory and all subdirectories are excluded. +To exclude a file from the update, create a file called +:file:`.mpdignore` in its parent directory. Each line of that file +may contain a list of shell wildcards. Matching files (or +directories) in the current directory and all subdirectories are +excluded. Example:: + + *.opus + 99* + +Subject to pattern matching is the file/directory name. It is (not +yet) possible to match nested path names, e.g. something like +``foo/*.flac`` is not possible. + Mounting other storages into the music directory ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^