Update docs to indicate the shared musicbrainz options

Author: nicomem

docs/plugins/listenbrainz.rst

@@ -26,6 +26,9 @@ intructions here_) and username:
         token: TOKEN
         username: LISTENBRAINZ_USERNAME
 
+Other ``musicbrainz`` options may be set to modify the connection to MusicBrainz
+(see :ref:`musicbrainz-shared-options`).
+
 Usage
 -----
 

docs/plugins/mbcollection.rst

@@ -16,6 +16,9 @@ To begin, just enable the ``mbcollection`` plugin in your configuration (see
         user: you
         pass: seekrit
 
+Other ``musicbrainz`` options may be set to modify the connection to MusicBrainz
+(see :ref:`musicbrainz-shared-options`).
+
 Then, use the ``beet mbupdate`` command to send your albums to MusicBrainz. The
 command automatically adds all of your albums to the first collection it finds.
 If you don't have a MusicBrainz collection yet, you may need to add one to your

docs/plugins/missing.rst

@@ -57,6 +57,9 @@ Here's an example
         count: no
         total: no
 
+Other ``musicbrainz`` options may be set to modify the connection to MusicBrainz
+(see :ref:`musicbrainz-shared-options`).
+
 Template Fields
 ---------------
 

docs/plugins/musicbrainz.rst

@@ -58,11 +58,28 @@ only to custom servers. The official MusicBrainz server always uses HTTPS.
 (Default: no.) The server must have search indices enabled (see `Building search
 indexes`_).
 
-The ``ratelimit`` option, an integer, controls the number of Web service
-requests per second (default: 1). **Do not change the rate limit setting** if
-you're using the main MusicBrainz server---on this public server, you're
+The ``ratelimit`` and ``ratelimit_interval`` options, respectively an integer
+and a decimal number, control the number of Web service requests per interval of
+time (default: 1 request per second). **Do not change the rate limit setting**
+if you're using the main MusicBrainz server---on this public server, you're
 limited_ to one request per second.
 
+.. _musicbrainz-shared-options:
+
+Shared options
+~~~~~~~~~~~~~~
+
+As other plugins may send requests to the MusicBrainz API, the following
+``musicbrainz`` options will also modify the other plugins' connection to
+MusicBrainz, even if the ``musicbrainz`` plugin is disabled:
+
+- ``host``
+- ``https``
+- ``ratelimit``
+- ``ratelimit_interval``
+- ``user``
+- ``pass``
+
 .. _building search indexes: https://musicbrainz.org/doc/Development/Search_server_setup
 
 .. _limited: https://musicbrainz.org/doc/XML_Web_Service/Rate_Limiting

docs/plugins/parentwork.rst

@@ -54,3 +54,6 @@ file. The available options are:
 - **auto**: If enabled, automatically fetches works at import. It takes quite
   some time, because beets is restricted to one MusicBrainz query per second.
   Default: ``no``
+
+Other ``musicbrainz`` options may be set to modify the connection to MusicBrainz
+(see :ref:`musicbrainz-shared-options`).