Clean up changelog bullets

docs/changelog.rst

@@ -6,54 +6,61 @@ Changelog
 
 New features:
 
-* :doc:`/plugins/replaygain`: add ``--force``, ``--write`` and ``--nowrite``
-  options to ``beet replaygain``. :bug:`2778`
-* A new importer configuration ``incremental_skip_later`` allows you to avoid
-  recording skipped directories to the incremental list, so you can revisit them
-  later. Thanks to :user:`sekjun9878`.
+* :doc:`/plugins/replaygain`: The ``beet replaygain`` command now has
+  ``--force``, ``--write`` and ``--nowrite`` options. :bug:`2778`
+* A new importer configuration option, :ref:`incremental_skip_later`, lets you
+  avoid recording skipped directories to the list of "processed" directories
+  in :ref:`incremental` mode. This way, you can revisit them later with
+  another import.
+  Thanks to :user:`sekjun9878`.
   :bug:`2773`
-* :doc:`/plugins/fetchart`: extended syntax for the ``sources`` option to give
-  fine-grained control over the search order for backends with several matching
-  strategies.
-* :doc:`/plugins/web`: added the boolean ``cors_supports_credentials`` option to
-  allow in-browser clients to login to the beet web server even when it is
-  protected by an authorization mechanism.
-* A new importer configuration ``artist_credit`` will tell beets to prefer the
-  artist credit over the artist when autotagging.
+* :doc:`/plugins/fetchart`: The configuration options now support
+  finer-grained control via the ``sources`` option. You can now specify the
+  search order for different *matching strategies* within different backends.
+* :doc:`/plugins/web`: A new ``cors_supports_credentials`` configuration
+  option lets in-browser clients communicate with the server even when it is
+  protected by an authorization mechanism (a proxy with HTTP authentication
+  enabled, for example).
+* A new importer configuration option, :ref:`artist_credit`, will tell beets
+  to prefer the artist credit over the artist when autotagging.
   :bug:`1249`
-* A new interoperability plugin to automatically notify Sonos controllers to
-  update the music library once the beets library got updated.
+* A new :doc:`/plugins/sonosupdate` plugin automatically notifies Sonos
+  controllers to update the music library when the beets library changes.
   Thanks to :user:`cgtobi`.
-* :doc:`/plugins/discogs`: The plugin now stores master release ids into
-  ``mb_releasegroupid`` as well as simulates track ids using release id
-  and tracklist positions. Track ids are stored in ``mb_trackid``. :bug:`#2336`
+* :doc:`/plugins/discogs`: The plugin now stores master release IDs into
+  ``mb_releasegroupid``. It also "simulates" track IDs using the release ID
+  and the track list position.
   Thanks to :user:`dbogdanov`.
-* :doc:`/plugins/discogs`: Fetch original year from master releases. :bug:`#1122`
-* As a first step to get :bug:`#406` implemented, beets now imports the
-  ``musicbrainz_releasetrackid`` field into the library and tags media files
-  accordingly. Thanks to :user:`Rawrmonkeys`.
+  :bug:`2336`
+* :doc:`/plugins/discogs`: Fetch the original year from master releases.
+  :bug:`1122`
+* In the MusicBrainz backend, beets now imports the
+  ``musicbrainz_releasetrackid`` field. This is a first step toward
+  :bug:`406`.
+  Thanks to :user:`Rawrmonkeys`.
+* A new importer option, :ref:`ignored_media`, can let you skim some media
+  formats.
+  :bug:`2688`
+* The importer now ignores non-audio tracks (namely, data and video tracks)
+  listed in MusicBrainz. Also, a new option, :ref:`ignore_video_tracks`, lets
+  you return to the old behavior and include these video tracks.
+  :bug:`1210`
 
 
 Fixes:
 
-* Incorrect disabling of Genius backend. :bug:`2911`
-* Non-audio media (DVD-Video, etc.) are now skipped by default by the
-  autotagger. A new option ``ignored_media`` controls which media formats to
-  ignore. :bug:`2688`
-* Non-audio tracks (data tracks, video tracks) are now skipped by the
-  autotagger. Data tracks will always be ignored, but a new option
-  ``ignore_video_tracks`` has been added to control if video tracks should be
-  ignored or not. :bug:`1210`
 * :doc:`/plugins/replaygain`: Fix a corner-case with the ``bs1770gain`` backend
-  where ReplayGain values were assigned to the wrong files. Now ``bs1770gain``
-  version 0.4.6 or later is required. :bug:`2777`
+  where ReplayGain values were assigned to the wrong files. The plugin now
+  requires version 0.4.6 or later of the ``bs1770gain`` tool.
+  :bug:`2777`
 * :doc:`/plugins/lyrics`: The plugin no longer crashes in the Genius source
   when BeautifulSoup is not found. Instead, it just logs a message and
   disables the source.
+  :bug:`2911`
 * :doc:`/plugins/lyrics`: Handle network and API errors when communicating
   with Genius. :bug:`2771`
-* :doc:`/plugins/lyrics`: The ``lyrics`` command previously write ReST files
-  by default. This default has been fixed.
+* :doc:`/plugins/lyrics`: The ``lyrics`` command previously wrote ReST files
+  by default, even when you didn't ask for them. This default has been fixed.
 * :doc:`/plugins/lyrics`: When writing ReST files, the ``lyrics`` command
   now groups lyrics by the ``albumartist`` field, rather than ``artist``.
   :bug:`2924`
@@ -63,12 +70,12 @@ Fixes:
   provides show up more reliably after doing a secondary import search.
   :bug:`2441` :bug:`2731`
 * :doc:`/plugins/importadded`: Fix a crash on non-autotagged imports.
-  :bug:`2601` :bug:`1918`
   Thanks to :user:`m42i`.
+  :bug:`2601` :bug:`1918`
 * :doc:`/plugins/plexupdate`: The Plex token is now redacted in configuration
   output.
-  :bug:`2804`
   Thanks to :user:`Kovrinic`.
+  :bug:`2804`
 * Avoid a crash when importing a non-ASCII filename when using an ASCII locale
   on Unix under Python 3.
   :bug:`2793` :bug:`2803`
@@ -80,8 +87,8 @@ Fixes:
 * :doc:`/plugins/convert`: The plugin now runs before other plugin-provided
   import stages, which addresses an issue with generating ReplayGain data
   incompatible between the source and target file formats.
-  :bug:`2814`
   Thanks to :user:`autrimpo`.
+  :bug:`2814`
 * :doc:`/plugins/ftintitle`: The ``drop`` config option had no effect; it now
   does what it says it should do.
   :bug:`2817`
@@ -91,38 +98,38 @@ Fixes:
 * :doc:`/plugins/web`: The time display in the web interface would incorrectly jump
   at the 30-second mark of every minute. Now, it correctly changes over at zero
   seconds. :bug:`2822`
-* :doc:`/plugins/web`: In a python 3 enviroment, the function to fetch the
-  album art would not work and throw an exception. It now works as expected.
-  Additionally, the server will now return a 404 response when the album id
-  is unknown, instead of a 500 response and a thrown exception. :bug:`2823`
-* :doc:`/plugins/web`: In a python 3 enviroment, the server would throw an
-  exception if non latin-1 characters where in the File name.
-  It now checks if non latin-1 characters are in the filename and changes
-  them to ascii-characters in that case :bug:`2815`
+* :doc:`/plugins/web`: Fetching album art now works (instead of throwing an
+  exception) under Python 3.
+  Additionally, the server will now return a 404 response when the album ID
+  is unknown (instead of throwing an exception and producing a 500 response).
+  :bug:`2823`
+* :doc:`/plugins/web`: Fix an exception on Python 3 for filenames with
+  non-Latin1 characters. (These characters are now converted to their ASCII
+  equivalents.)
+  :bug:`2815`
 * Partially fix bash completion for subcommand names that contain hyphens.
-  :bug:`2836` :bug:`2837`
   Thanks to :user:`jhermann`.
-* Really fix album replaygain calculation with gstreamer backend. :bug:`2846`
+  :bug:`2836` :bug:`2837`
+* :doc:`/plugins/replaygain`: Really fix album gain calculation using the
+  GStreamer backend. :bug:`2846`
 * Avoid an error when doing a "no-op" move on non-existent files (i.e., moving
   a file onto itself). :bug:`2863`
-* :doc:`/plugins/discogs`: Fix ``medium`` and ``medium_index`` values which
-  were occasionally incorrect for releases with two-sided mediums. Fix
-  ``medium_total`` value. It now contains total number of tracks on the medium
-  to which a track belongs, not the total number of different mediums present
-  on the release. :bug:`2887`
+* :doc:`/plugins/discogs`: Fix the ``medium`` and ``medium_index`` values, which
+  were occasionally incorrect for releases with two-sided mediums such as
+  vinyl. Also fix the ``medium_total`` value, which now contains total number
+  of tracks on the medium to which a track belongs, not the total number of
+  different mediums present on the release.
   Thanks to :user:`dbogdanov`.
+  :bug:`2887`
 * The importer now supports audio files contained in data tracks when they are
   listed in MusicBrainz: the corresponding audio tracks are now merged into the
   main track list. Thanks to :user:`jdetrey`. :bug:`1638`
 * :doc:`/plugins/keyfinder`: Avoid a crash when trying to process unmatched
   tracks. :bug:`2537`
-* In the ``mbsync`` plugin, support MusicBrainz recording ID changes, relying
+* :doc:`/plugins/mbsync`: Support MusicBrainz recording ID changes, relying
   on release track IDs instead. Thanks to :user:`jdetrey`. :bug:`1234`
-* Properly send ``albuminfo_received`` and ``trackinfo_received`` in all cases,
-  most notably when using the ``mbsync`` plugin. This was a regression since
-  version 1.4.1. :bug:`2921`
-* In the ``mbsync`` plugin, allow beets to update album if the first track
-  has a missing MusicBrainz recording ID. :bug:`2920`
+* :doc:`/plugins/mbsync`: We can now successfully update albums even when the
+  first track has a missing MusicBrainz recording ID. :bug:`2920`
 
 
 For developers:
@@ -131,6 +138,10 @@ For developers:
   the ``early_import_stages`` list instead of plain ``import_stages`` to
   request this behavior.
   :bug:`2814`
+* We again properly send ``albuminfo_received`` and ``trackinfo_received`` in
+  all cases, most notably when using the ``mbsync`` plugin. This was a
+  regression since version 1.4.1.
+  :bug:`2921`
 
 
 1.4.6 (December 21, 2017)