Refine writing/links for #3116

This commit is contained in:
Adrian Sampson 2019-01-12 14:20:16 -08:00
parent 22e90b519c
commit d35a68d0d8

View file

@ -654,7 +654,7 @@ Default: ``{}`` (empty).
MusicBrainz Options
-------------------
You can instruct beets to use `your own`_ MusicBrainz database instead of
You can instruct beets to use `your own MusicBrainz database`_ instead of
the `main server`_. Use the ``host`` and ``ratelimit`` options under a
``musicbrainz:`` header, like so::
@ -664,17 +664,17 @@ the `main server`_. Use the ``host`` and ``ratelimit`` options under a
The ``host`` key, of course, controls the Web server hostname (and port,
optionally) that will be contacted by beets (default: musicbrainz.org).
The ``host`` must have search indexes enabled -- see "Building search indexes"
in the server setup guide linked above.
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 `limited`_
to one request per second.
.. _your own: https://musicbrainz.org/doc/MusicBrainz_Server/Setup
.. _your own MusicBrainz database: https://musicbrainz.org/doc/MusicBrainz_Server/Setup
.. _main server: https://musicbrainz.org/
.. _limited: http://musicbrainz.org/doc/XML_Web_Service/Rate_Limiting
.. _Building search indexes: https://musicbrainz.org/doc/MusicBrainz_Server/Setup#Building_search_indexes
.. _searchlimit: