From 85df4f513d72ddbef66ec3b31d227b6a16840a64 Mon Sep 17 00:00:00 2001 From: Rutger van Sleen Date: Sun, 13 May 2018 11:16:49 +0200 Subject: [PATCH] Usage of %ifdef in more detail, closes #2925 --- docs/reference/pathformat.rst | 8 +++++--- 1 file changed, 5 insertions(+), 3 deletions(-) diff --git a/docs/reference/pathformat.rst b/docs/reference/pathformat.rst index 72907b6df..5f8c0b201 100644 --- a/docs/reference/pathformat.rst +++ b/docs/reference/pathformat.rst @@ -83,9 +83,11 @@ These functions are built in to beets: ``%first{text,count,skip,sep,join}`` where ``sep`` is the separator, like ``;`` or ``/`` and join is the text to concatenate the items. * ``%ifdef{field}``, ``%ifdef{field,truetext}`` or - ``%ifdef{field,truetext,falsetext}``: If ``field`` exists, then return - ``truetext`` or ``field`` (default). Otherwise, returns ``falsetext``. - The ``field`` should be entered without ``$``. + ``%ifdef{field,truetext,falsetext}``: Checks if an flexible attribute + ``field`` is defined. If it exists, then return ``truetext`` or ``field`` + (default). Otherwise, returns ``falsetext``. The ``field`` should be entered + without ``$``. Note that this doesn't work with built-in :ref:`itemfields`, as + they are always defined. .. _unidecode module: http://pypi.python.org/pypi/Unidecode .. _strftime: http://docs.python.org/2/library/time.html#time.strftime