From 58bd8a9e24693cbdcf3f36f6ee5e1e48f3ffbe90 Mon Sep 17 00:00:00 2001 From: Adrian Sampson Date: Sat, 15 Jun 2013 22:49:14 -0700 Subject: [PATCH] docs: a note about albums and the update command --- docs/reference/cli.rst | 9 +++++++++ 1 file changed, 9 insertions(+) diff --git a/docs/reference/cli.rst b/docs/reference/cli.rst index ff8d0f8a8..03f1476a6 100644 --- a/docs/reference/cli.rst +++ b/docs/reference/cli.rst @@ -234,6 +234,15 @@ To perform a "dry run" an update, just use the ``-p`` (for "pretend") flag. This will show you all the proposed changes but won't actually change anything on disk. +When an updated track is part of an album, the album-level fields of *all* +tracks from the album are also updated. (Specifically, the command copies +album-level data from the first track on the album and applies it to the +rest of the tracks.) This means that, if album-level fields aren't identical +within an album, some changes shown by the ``update`` command may be +overridden by data from other tracks on the same album. This means that +running the ``update`` command multiple times may show the same changes being +applied. + .. _stats-cmd: stats