Improve specifications in the matches.ignored setting

The setting is quite confusing. After having difficulty getting the autotagger to accept an id for a specific release that I knew was correct, I investigated and count [this closed issue][0] that totally explains the problem.

To clarify the issue, I quoted Adrian from the issue and elaborated a bit, providing the solution. Unfortunately, the solution is undocumented. I'd like to document it, but I am unsure what the actual weighting system in `distance_weights` is. Adrian says 0.9 to ignore missing_tracks, which implies it's similar to the distance weighting in the other settings, but other settings in the default config are set to multiples of 1, implying it is not.

[0]: https://github.com/beetbox/beets/issues/3064
This commit is contained in:
malan88 2019-03-07 09:39:34 -05:00 committed by GitHub
parent f6ad98a4a5
commit 2cef079603
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23

View file

@ -802,6 +802,14 @@ the penalty name to the ``ignored`` setting::
The available penalties are the same as those for the :ref:`max_rec` setting.
Please note: the ignored setting will ignore any *matches* that have the specified penalties. In a sense, it maximizes the listed penalties. It will not ignore *the fact* that those matches have the penalties. For instance, with the above setting, it ignores all matches with missing tracks. It doesn't ignore the fact that there are missing tracks, which would sort of be the opposite.
To ignore *the penalties themselves* in match selection, add something like the following to your matches settings:
match:
distance_weights:
missing_tracks: 0.9
.. _required:
required