From c668dfae71f39590c3ba30a077b4f2981cfaf9a7 Mon Sep 17 00:00:00 2001 From: "Arav K." Date: Wed, 31 Jul 2024 23:39:26 +0200 Subject: [PATCH] Document 'overwrite_null' Solves #5314. --- docs/reference/config.rst | 15 +++++++++++++++ 1 file changed, 15 insertions(+) diff --git a/docs/reference/config.rst b/docs/reference/config.rst index c2424e058d..60b641082c 100644 --- a/docs/reference/config.rst +++ b/docs/reference/config.rst @@ -276,6 +276,21 @@ Either ``yes`` or ``no``, indicating whether matched albums should have their That is, if this option is turned on, then ``year`` will always equal ``original_year`` and so on. Default: ``no``. +.. _overwrite_null: + +overwrite_null +~~~~~~~~~~~~~~ + +In some situations, data for a particular field is not available, and it ends up being +set to an empty value (an empty string). To allow such fields to be overwritten once +the appropriate data does become available (e.g. by a re-import or a manual update), +the name of the metadata field can be added to the list `album` (for albums) or `track` +(for tracks). For example:: + + overwrite_null: + album: ["albumid"] + track: ["title", "date"] + .. _artist_credit: artist_credit