Doc tweaks for #4438

This commit is contained in:
Adrian Sampson 2022-08-17 15:55:25 -07:00
parent fa81d6c568
commit e995019edd
No known key found for this signature in database
GPG key ID: BDB93AB409CC8705
2 changed files with 7 additions and 5 deletions

View file

@ -326,13 +326,15 @@ The defaults look like this::
See :ref:`aunique` for more details.
.. _config-sunique:
sunique
~~~~~~~
These options are used to generate a string that is guaranteed to be unique
among all singletons in the library who share the same set of keys.
Like :ref:`config-aunique` above for albums, these options control the
generation of a unique string to disambiguate *singletons* that share similar
metadata.
The defaults look like this::

View file

@ -73,7 +73,7 @@ These functions are built in to beets:
option.
* ``%aunique{identifiers,disambiguators,brackets}``: Provides a unique string
to disambiguate similar albums in the database. See :ref:`aunique`, below.
* ``%sunique{identifiers,disambiguators,brackets}``: Provides a unique string
* ``%sunique{identifiers,disambiguators,brackets}``: Similarly, a unique string
to disambiguate similar singletons in the database. See :ref:`sunique`, below.
* ``%time{date_time,format}``: Return the date and time in any format accepted
by `strftime`_. For example, to get the year some music was added to your
@ -153,8 +153,8 @@ Singleton Disambiguation
------------------------
It is also possible to have singleton tracks with the same name and the same
artist. Beets provides the ``%sunique{}`` template to avoid having the same
file path.
artist. Beets provides the ``%sunique{}`` template to avoid giving these
tracks the same file path.
It has the same arguments as the :ref:`%aunique <aunique>` template, but the default
values are different. The default identifiers are ``artist title`` and the