diff --git a/docs/changelog.rst b/docs/changelog.rst index 2f3e5af00..daf9210df 100644 --- a/docs/changelog.rst +++ b/docs/changelog.rst @@ -18,7 +18,12 @@ New features: and `min_width` options if no local imaging backend is available. :bug:`1460` * The `move` command has a new `-p/--pretend` option, making the command show how the items will be moved, without modifying the files on disk. -* The importer now supports matching of pregap tracks in releases. +* The importer now supports matching of "pregap" or HTOA (hidden track one + audio) tracks when they are listed in MusicBrainz. (This feature depends on a + new version of the ``musicbrainzngs`` library that is not yet released, but + will start working when it is available.) Thanks to :user:`ruippeixotog`. + :bug:`1104` :bug:`1493` + Fixes: diff --git a/docs/reference/config.rst b/docs/reference/config.rst index 7f9443179..2077dcfb9 100644 --- a/docs/reference/config.rst +++ b/docs/reference/config.rst @@ -233,10 +233,7 @@ A boolean controlling the track numbering style on multi-disc releases. By default (``per_disc_numbering: no``), tracks are numbered per-release, so the first track on the second disc has track number N+1 where N is the number of tracks on the first disc. If this ``per_disc_numbering`` is enabled, then the -first track on each disc always has track number 1. This is true even when the -disc has pregap tracks, typically numbered 0 - in that case, the pregap track -of the first disc has track number 1 and every other track has its original -track number plus one. +first track on each disc always has track number 1. If you enable ``per_disc_numbering``, you will likely want to change your :ref:`path-format-config` also to include ``$disc`` before ``$track`` to make @@ -246,6 +243,11 @@ use a path format like this:: paths: default: $albumartist/$album%aunique{}/$disc-$track $title +When this option is off (the default), even "pregap" hidden tracks are +numbered from one, not zero, so other track numbers may appear to be bumped up +by one. + + .. _terminal_encoding: terminal_encoding