From 07e352143eaace0be7d5ecb1bf938d0d3feaaee7 Mon Sep 17 00:00:00 2001 From: Scott Thomas Date: Thu, 21 May 2015 00:45:20 +0100 Subject: [PATCH] File modification note in docs I couldn't get beet update to read metadata changes - turns out that puddletag doesn't touch the file modification time by default. It's a perfectly sensible behaviour but I thought I'd add a note in the `beet update` section in case anyone else has this problem. --- docs/reference/cli.rst | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-) diff --git a/docs/reference/cli.rst b/docs/reference/cli.rst index d3fc9fd68..832b67412 100644 --- a/docs/reference/cli.rst +++ b/docs/reference/cli.rst @@ -268,7 +268,10 @@ changes and file deletions. This will scan all the matched files and read their tags, populating the database with the new values. By default, files will be renamed according to -their new metadata; disable this with ``-M``. +their new metadata; disable this with ``-M``. Beets will skip files if their +modification times have not changed, so any out-of-band metadata changes must +also update these for ``beet update`` to recognise that the files have been +edited. To perform a "dry run" of an update, just use the ``-p`` (for "pretend") flag. This will show you all the proposed changes but won't actually change anything