beets/docs
Johann Fot ee5f96be78
Add native support for multiple genres per album/track
Simplify multi-genre implementation based on maintainer feedback (PR #6169).

Changes:
- Remove multi_value_genres and genre_separator config options
- Replace complex sync_genre_fields() with ensure_first_value('genre', 'genres')
- Update all plugins (Beatport, MusicBrainz, LastGenre) to always write genres as lists
- Add automatic migration for comma/semicolon/slash-separated genre strings
- Add 'beet migrate genres' command for explicit batch migration with --pretend flag
- Update all tests to reflect simplified approach (44 tests passing)
- Update documentation

Implementation aligns with maintainer vision of always using multi-value genres
internally with automatic backward-compatible sync to the genre field via
ensure_first_value(), eliminating configuration complexity.

Migration strategy avoids problems from #5540:
- Automatic lazy migration on item access (no reimport/mbsync needed)
- Optional batch migration command for user control
- No endless rewrite loops due to proper field synchronization
2026-02-22 14:19:17 +00:00
..
_static Transparent background logo for docs 2023-10-29 10:30:33 +01:00
_templates/autosummary Add request handler utils to the docs 2026-01-06 09:54:02 +00:00
api Add request handler utils to the docs 2026-01-06 09:54:02 +00:00
dev Move PromptChoice to beets.util module 2025-12-02 01:51:14 +00:00
extensions Address RUF012 2026-01-13 20:55:40 +00:00
guides Fix single backticks issues 2026-02-08 08:01:31 +00:00
plugins Add beets-fillmissing to the list of plugins 2026-02-16 20:15:22 +02:00
reference Update color docs with bright_* and bg_bright_* entries 2026-01-25 12:05:40 +01:00
.gitignore Streamlined auto api referencing for documentation (#5795) 2025-05-22 11:35:40 +02:00
changelog.rst Add native support for multiple genres per album/track 2026-02-22 14:19:17 +00:00
code_of_conduct.rst Update docstrfmt 2025-09-04 12:49:44 +01:00
conf.py Increment version to 2.6.1 2026-02-02 02:29:04 +00:00
contributing.rst Update docstrfmt 2025-09-04 12:49:44 +01:00
faq.rst Run formatter. 2025-10-11 13:52:35 +02:00
index.rst Re-added macport instructions. Removed mailing list ref. Added section 2025-10-11 13:52:35 +02:00
Makefile Streamlined auto api referencing for documentation (#5795) 2025-05-22 11:35:40 +02:00
modd.conf
team.rst Reformat all docs using docstrfmt 2025-08-10 16:25:05 +01:00