From 1364e6ba3731ff5367288ad5f3ceb5d26760879f Mon Sep 17 00:00:00 2001 From: Adrian Sampson Date: Wed, 5 Jun 2013 15:20:36 -0700 Subject: [PATCH] organize 1.1.1 changelog into sections --- docs/changelog.rst | 83 +++++++++++++++++++++++---------------- docs/plugins/beatport.rst | 2 +- 2 files changed, 51 insertions(+), 34 deletions(-) diff --git a/docs/changelog.rst b/docs/changelog.rst index 0c4cdbadf..e8e4b1cbf 100644 --- a/docs/changelog.rst +++ b/docs/changelog.rst @@ -4,14 +4,24 @@ Changelog 1.1.1 (in development) ---------------------- -* New :doc:`/plugins/duplicates`: Find tracks or albums in your - library that are **duplicated**. Thanks to Pedro Silva. -* New :doc:`/plugins/missing`: Find albums in your library that are **missing - tracks**. Thanks once more to Pedro Silva. +Two new plugins that add new **data sources** to beets that augment +MusicBrainz in the importer: + * New :doc:`/plugins/discogs`: Extends the autotagger to include matches from the `Discogs`_ database. Thanks to Artem Ponomarenko and Tai Lee. * New :doc:`/plugins/beatport`: Get matches from the `Beatport`_ database. Thanks to Johannes Baiter. + +Two new plugins that can check your library for common problems, both by Pedro +Silva: + +* New :doc:`/plugins/duplicates`: Find tracks or albums in your + library that are **duplicated**. +* New :doc:`/plugins/missing`: Find albums in your library that are **missing + tracks**. + +A few more big features: + * Your library now keeps track of **when music was added** to it. The new ``added`` field is a timestamp reflecting when each item and album was imported and the new ``%time{}`` template function lets you format this @@ -22,6 +32,37 @@ Changelog ``bitrate:128000..``. See :ref:`numericquery`. Thanks to Michael Schuerig. * **ALAC files** are now marked as ALAC instead of being conflated with AAC audio. Thanks to Simon Luijk. + +Various UI enhancements to the importer due to Tai Lee: + +* More consistent format and colorization of album and track metadata. +* Display data source URL for :doc:`/plugins/discogs` matches. This should + make it easier for people who would rather import and correct data from + Discogs into MusicBrainz. +* Display album disambiguation and disc titles in the track listing, when + available. +* Track changes highlighted in yellow indicate a change in format to or from + :ref:`per_disc_numbering`. No penalty is applied because the track number + is still "correct", just in a different format. +* Sort missing and unmatched tracks by index and title and group them + together for better readability. +* Indicate MusicBrainz ID mismatches. + +Improve calculation of similarity score, also thanks to Tai Lee: + +* Strongly prefer releases with a matching MusicBrainz album ID. This helps + beets re-identify the same release when re-importing existing files. +* Prefer releases that are closest to the tagged ``year``. Tolerate files + tagged with release or original year. +* Prefer CD releases by default, when there is no ``media`` tagged in the + files being imported. This can be changed with the :ref:`preferred_media` + setting. +* Apply minor penalties across a range of fields to differentiate between + nearly identical releases: ``disctotal``, ``label``, ``catalognum``, + ``country`` and ``albumdisambig``. + +Lots of little enhancements: + * :doc:`/plugins/random`: A new ``-e`` option gives an equal chance to each artist in your collection to avoid biasing random samples to prolific artists. Thanks to Georges Dubus. @@ -33,8 +74,6 @@ Changelog Duailibe. * The importer output now shows the number of audio files in each album. Thanks to jayme on GitHub. -* :doc:`/plugins/lyrics`: Lyrics searches should now turn up more results due - to some fixes in dealing with special characters. * Plugins can now provide fields for both Album and Item templates, thanks to Pedro Silva. Accordingly, the :doc:`/plugins/inline` can also now define album fields. For consistency, the ``pathfields`` configuration section has @@ -46,6 +85,9 @@ Changelog Johannes Baiter. * The :ref:`fields-cmd` command shows template fields provided by plugins. Thanks again to Pedro Silva. + +And a batch of fixes: + * Album art filenames now respect the :ref:`replace` configuration. * Friendly error messages are now printed when trying to read or write files that go missing. @@ -55,33 +97,8 @@ Changelog None. * Templates can now refer to non-tag item fields (e.g., ``$id`` and ``$album_id``). -* Various UI enhancements to the importer due to Tai Lee: - - * More consistent format and colorization of album and track metadata. - * Display data source URL for :doc:`/plugins/discogs` matches. This should - make it easier for people who would rather import and correct data from - Discogs into MusicBrainz. - * Display album disambiguation and disc titles in the track listing, when - available. - * Track changes highlighted in yellow indicate a change in format to or from - :ref:`per_disc_numbering`. No penalty is applied because the track number - is still "correct", just in a different format. - * Sort missing and unmatched tracks by index and title and group them - together for better readability. - * Indicate MusicBrainz ID mismatches. - -* Improve calculation of similarity score: - - * Strongly prefer releases with a matching MusicBrainz album ID. This helps - beets re-identify the same release when re-importing existing files. - * Prefer releases that are closest to the tagged ``year``. Tolerate files - tagged with release or original year. - * Prefer CD releases by default, when there is no ``media`` tagged in the - files being imported. This can be changed with the :ref:`preferred_media` - setting. - * Apply minor penalties across a range of fields to differentiate between - nearly identical releases: ``disctotal``, ``label``, ``catalognum``, - ``country`` and ``albumdisambig``. +* :doc:`/plugins/lyrics`: Lyrics searches should now turn up more results due + to some fixes in dealing with special characters. .. _Discogs: http://discogs.com/ .. _Beatport: http://www.beatport.com/ diff --git a/docs/plugins/beatport.rst b/docs/plugins/beatport.rst index d74c6f8d6..751f458be 100644 --- a/docs/plugins/beatport.rst +++ b/docs/plugins/beatport.rst @@ -1,5 +1,5 @@ Beatport Plugin -============== +=============== The ``beatport`` plugin adds support for querying the `Beatport`_ catalogue during the autotagging process. This can potentially be helpful for users