diff --git a/docs/changelog.rst b/docs/changelog.rst index 05b450019..ec86039d7 100644 --- a/docs/changelog.rst +++ b/docs/changelog.rst @@ -207,6 +207,8 @@ Other changes: * :doc:`/plugins/lyrics`: Remove Musixmatch from default enabled sources as they are currently blocking requests from the beets user agent. :bug:`4585` +* :doc:`/faq`: :ref:`multidisc`: Elaborated the multi-disc FAQ :bug:`4806` +* :doc:`/faq`: :ref:`src`: Removed some long lines. 1.6.0 (November 27, 2021) ------------------------- diff --git a/docs/faq.rst b/docs/faq.rst index e7f5cc600..814f87b7a 100644 --- a/docs/faq.rst +++ b/docs/faq.rst @@ -59,6 +59,12 @@ with the ``%if{}`` function to accomplish this:: item_fields: multidisc: 1 if disctotal > 1 else 0 +This ``paths`` configuration only contains the +``default`` key: it leaves the ``comp`` and ``singleton`` keys as their +default values, as documented in :ref:`path-format-config`. +To create "Disc N" directories for compilations and singletons, you will need +to specify similar templates for those keys as well. + .. _multidisc: @@ -138,7 +144,9 @@ it's helpful to run on the "bleeding edge". To run the latest source: 2. Install from source. Choose one of these methods: - Directly from GitHub using - ``python -m pip install git+https://github.com/beetbox/beets.git`` command. Depending on your system, you may need to use ``pip3`` and ``python3`` instead of ``pip`` and ``python`` respectively. + ``python -m pip install git+https://github.com/beetbox/beets.git`` + command. Depending on your system, you may need to use ``pip3`` + and ``python3`` instead of ``pip`` and ``python`` respectively. - Use ``pip`` to install the latest snapshot tarball. Type: ``pip install https://github.com/beetbox/beets/tarball/master`` - Grab the source using git. First, clone the repository: