Merge pull request #4810 from plenaerts/master

Elaborated multidisc FAQ

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)
 -------------------------

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: